man pages section 3: Multimedia Library Functions

Exit Print View

Updated: July 2014
 
 

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)