man pages section 3: Multimedia Library Functions

Exit Print View

Updated: July 2014
 
 

mlib_GraphicsDrawCircle_32 (3MLIB)

Name

mlib_GraphicsDrawCircle, mlib_GraphicsDrawCircle_8, mlib_GraphicsDrawCircle_32, mlib_GraphicsDrawCircle_X_8, mlib_GraphicsDrawCircle_X_32, mlib_GraphicsDrawCircle_A_8, mlib_GraphicsDrawCircle_A_32, mlib_GraphicsDrawCircle_B_8, mlib_GraphicsDrawCircle_B_32, mlib_GraphicsDrawCircle_AB_8, mlib_GraphicsDrawCircle_AB_32 - draw circle

Synopsis

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

mlib_status mlib_GraphicsDrawCircle_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c);
mlib_status mlib_GraphicsDrawCircle_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c);
mlib_status mlib_GraphicsDrawCircle_X_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c, mlib_s32 c2);
mlib_status mlib_GraphicsDrawCircle_X_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c, mlib_s32 c2);
mlib_status mlib_GraphicsDrawCircle_A_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c);
mlib_status mlib_GraphicsDrawCircle_A_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c);
mlib_status mlib_GraphicsDrawCircle_B_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c, mlib_s32 a);
mlib_status mlib_GraphicsDrawCircle_B_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c, mlib_s32 a);
mlib_status mlib_GraphicsDrawCircle_AB_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c, mlib_s32 a);
mlib_status mlib_GraphicsDrawCircle_AB_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 r, mlib_s32 c, mlib_s32 a);

Description

Each of the mlib_GraphicsDrawCircle_*() functions draws a circle with the center at (x, y) and radius r.

Each of the mlib_GraphicsDrawCircle_X_*() functions draws a circle in Xor mode as follows:

    data[x,y] ^= c ^ c2

Each of the mlib_GraphicsDrawCircle_A_*() functions draws a circle with antialiasing.

Each of the mlib_GraphicsDrawCircle_B_*() functions draws a circle with alpha blending as follows:

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

Each of the mlib_GraphicsDrawCircle_AB_*() functions draws a circle with antialiasing and alpha blending.

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 center.

y

Y coordinate of the center.

r

Radius of the arc.

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_GraphicsDrawArc(3MLIB), mlib_GraphicsDrawEllipse(3MLIB), attributes(5)