man pages section 3: Multimedia Library Functions

Exit Print View

Updated: July 2014
 
 

mlib_GraphicsDrawEllipse_A_32(3MLIB)

Name

mlib_GraphicsDrawEllipse, mlib_GraphicsDrawEllipse_8, mlib_GraphicsDrawEllipse_32, mlib_GraphicsDrawEllipse_X_8, mlib_GraphicsDrawEllipse_X_32, mlib_GraphicsDrawEllipse_A_8, mlib_GraphicsDrawEllipse_A_32, mlib_GraphicsDrawEllipse_B_8, mlib_GraphicsDrawEllipse_B_32, mlib_GraphicsDrawEllipse_AB_8, mlib_GraphicsDrawEllipse_AB_32 - draw ellipse

Synopsis

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

mlib_status mlib_GraphicsDrawEllipse_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c);
mlib_status mlib_GraphicsDrawEllipse_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c);
mlib_status mlib_GraphicsDrawEllipse_X_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c,
     mlib_s32 c2);
mlib_status mlib_GraphicsDrawEllipse_X_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c,
     mlib_s32 c2);
mlib_status mlib_GraphicsDrawEllipse_A_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c);
mlib_status mlib_GraphicsDrawEllipse_A_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c);
mlib_status mlib_GraphicsDrawEllipse_B_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c,
     mlib_s32 alpha);
mlib_status mlib_GraphicsDrawEllipse_B_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c,
     mlib_s32 alpha);
mlib_status mlib_GraphicsDrawEllipse_AB_8(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c,
     mlib_s32 alpha);
mlib_status mlib_GraphicsDrawEllipse_AB_32(mlib_image *buffer, mlib_s16 x,
     mlib_s16 y, mlib_s32 a, mlib_s32 b, mlib_f32 t, mlib_s32 c,
     mlib_s32 alpha);

Description

Each of the mlib_GraphicsDrawEllipse_*() functions draws an ellipse with the center at (x, y), major semiaxis a, and minor semiaxis b. The angle of the major semiaxis is t counterclockwise from the X axis.

Each of the mlib_GraphicsDrawEllipse_X_*() functions draws an ellipse in Xor mode as follows:

    data[x,y] ^= c ^ c2

Each of the mlib_GraphicsDrawEllipse_A_*() functions draws an ellipse with antialiasing.

Each of the mlib_GraphicsDrawEllipse_B_*() functions draws an ellipse with alpha blending as follows:

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

Each of the mlib_GraphicsDrawEllipse_A_*() functions draws an ellipse 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.

a

Major semiaxis of the ellipse.

b

Minor semiaxis of the ellipse.

t

Angle of major semiaxis in radians.

c

Color used in the drawing.

c2

Alternation color.

alpha

Alpha value for blending. 0 ≤ alpha ≤ 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_GraphicsDrawCircle(3MLIB), attributes(5)