mlib_GraphicsDrawRectangle(3MLIB)										 mlib_GraphicsDrawRectangle(3MLIB)

NAME

       mlib_GraphicsDrawRectangle,  mlib_GraphicsDrawRectangle_8,  mlib_GraphicsDrawRectangle_32,  mlib_GraphicsDrawRectangle_X_8,  mlib_Graphics-
       DrawRectangle_X_32, mlib_GraphicsDrawRectangle_B_8, mlib_GraphicsDrawRectangle_B_32 - draw rectangle

SYNOPSIS

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

       mlib_status mlib_GraphicsDrawRectangle_8(mlib_image *buffer, mlib_s16 x, mlib_s16 y, mlib_s32 w, mlib_s32 h, mlib_s32 c);

       mlib_status mlib_GraphicsDrawRectangle_32(mlib_image *buffer, mlib_s16 x, mlib_s16 y, mlib_s32 w, mlib_s32 h, mlib_s32 c);

       mlib_status mlib_GraphicsDrawRectangle_X_8(mlib_image *buffer, mlib_s16 x, mlib_s16 y, mlib_s32 w, mlib_s32 h, mlib_s32 c, mlib_s32 c2);

       mlib_status mlib_GraphicsDrawRectangle_X_32(mlib_image *buffer, mlib_s16 x, mlib_s16 y, mlib_s32 w, mlib_s32 h, mlib_s32 c, mlib_s32 c2);

       mlib_status mlib_GraphicsDrawRectangle_B_8(mlib_image *buffer, mlib_s16 x, mlib_s16 y, mlib_s32 w, mlib_s32 h, mlib_s32 c, mlib_s32 a);

       mlib_status mlib_GraphicsDrawRectangle_B_32(mlib_image *buffer, mlib_s16 x, mlib_s16 y, mlib_s32 w, mlib_s32 h, mlib_s32 c, mlib_s32 a);

       Each of the mlib_GraphicsDrawRectangle_*() functions draws a rectangle with the upper-left corner at (x, y), width w, and height h.

       Each of the mlib_GraphicsDrawRectangle_X_*() functions draws a rectangle in Xor mode as follows:

	   data[x,y] ^= c ^ c2

       Each of the mlib_GraphicsDrawRectangle_B_*() functions draws a rectangle with alpha blending as follows:

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

       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 upper-left corner of the rectangle.

       y	       Y coordinate of the upper-left corner of the rectangle.

       w	       Width of the rectangle.

       h	       Height of the rectangle.

       c	       Color used in the drawing.

       c2	       Alternation color.

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

       Each of the functions returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.

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

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

       mlib_GraphicsFillRectangle(3MLIB), attributes(5)

								    3 Mar 2005					 mlib_GraphicsDrawRectangle(3MLIB)