opensolaris man page for mlib_imagereplacecolor

mlib_ImageReplaceColor(3MLIB)				    mediaLib Library Functions				     mlib_ImageReplaceColor(3MLIB)

NAME
       mlib_ImageReplaceColor - replace a color in an image

SYNOPSIS
       cc [ flag... ] file... -lmlib [ library... ]
       #include <mlib.h>

       mlib_status mlib_ImageReplaceColor(mlib_image *dst, const mlib_image *src,
	    const mlib_s32 *color1, const mlib_s32 *color2);

DESCRIPTION
       The  mlib_ImageReplaceColor()  function	copies	the source image to the destination image and replaces the pixels having a value of color1
       with color2.

       It uses the following equation:

	 dst[x][y] = color2	if src[x][y] == color1
	 dst[x][y] = src[x][y]	if src[x][y] != color1

PARAMETERS
       The function takes the following arguments:

       dst	 Pointer to destination image.

       src	 Pointer to source image.

       color1	 Array of color components to be replaced.

       color2	 Array of color components to replace color1.

RETURN VALUES
       The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       mlib_ImageReplaceColor_Inp(3MLIB),   mlib_ImageReplaceColor_Fp(3MLIB),	mlib_ImageReplaceColor_Fp_Inp(3MLIB),	 mlib_ImageThresh5(3MLIB),
       mlib_ImageThresh5_Inp(3MLIB), mlib_ImageThresh5_Fp(3MLIB), mlib_ImageThresh5_Fp_Inp(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					     mlib_ImageReplaceColor(3MLIB)