opensolaris man page for mlib_graphicsdrawpoint

mlib_GraphicsDrawPoint(3MLIB)				    mediaLib Library Functions				     mlib_GraphicsDrawPoint(3MLIB)

NAME
       mlib_GraphicsDrawPoint,	 mlib_GraphicsDrawPoint_8,   mlib_GraphicsDrawPoint_32,  mlib_GraphicsDrawPoint_X_8,  mlib_GraphicsDrawPoint_X_32,
       mlib_GraphicsDrawPoint_B_8, mlib_GraphicsDrawPoint_B_32 - draw point

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

       mlib_status mlib_GraphicsDrawPoint_8(mlib_image *buffer, mlib_s16 x,
	    mlib_s16 y, mlib_s32 c);

       mlib_status mlib_GraphicsDrawPoint_32(mlib_image *buffer, mlib_s16 x,
	    mlib_s16 y, mlib_s32 c);

       mlib_status mlib_GraphicsDrawPoint_X_8(mlib_image *buffer, mlib_s16 x,
	    mlib_s16 y, mlib_s32 c, mlib_s32 c2);

       mlib_status mlib_GraphicsDrawPoint_X_32(mlib_image *buffer, mlib_s16 x,
	    mlib_s16 y, mlib_s32 c, mlib_s32 c2);

       mlib_status mlib_GraphicsDrawPoint_B_8(mlib_image *buffer, mlib_s16 x,
	    mlib_s16 y, mlib_s32 c, mlib_s32 a);

       mlib_status mlib_GraphicsDrawPoint_B_32(mlib_image *buffer, mlib_s16 x,
	    mlib_s16 y, mlib_s32 c, mlib_s32 a);

DESCRIPTION
       Each of the mlib_GraphicsDrawPoint_*() functions draws a point at (x,y) in color c.

       Each of the mlib_GraphicsDrawPoint_X_*() functions draws a point at (x,y) in Xor mode as follows:

	     data[x,y] ^= c ^ c2

       Each of the mlib_GraphicsDrawPoint_B_*() functions draws a point at (x,y) with alpha blending as follows:

	     data[x,y] = (data[x,y] * (255 - a) + c * a) / 255

PARAMETERS
       Each of the functions takes some of the following arguments:

       buffer	 Pointer to the image into which the function is drawing.

       x	 X coordinate of the point.

       y	 Y coordinate of the point.

       c	 Color used in the drawing.

       c2	 Alternation color.

       a	 Alpha value for blending. 0 <= a <= 255.

RETURN VALUES
       Each of the functions 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_GraphicsDrawPointSet(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					     mlib_GraphicsDrawPoint(3MLIB)