PgDrawEllipse()

Draw an ellipse

Synopsis:

int PgDrawEllipse( PhPoint_t const *center,
                   PhPoint_t const *radii,
                   unsigned int flags );

Description:

This function builds a command in the draw buffer to draw an ellipse. The center argument defines the ellipse's center and radii defines its x and y radii.

The flags argument must be one of the following:

• Pg_DRAW_STROKE - draw as a line.
• Pg_DRAW_FILL - fill the ellipse.
• Pg_DRAW_FILL_STROKE - fill the ellipse, then stroke it.

To have the function interpret the center and radii arguments as the upper-left and lower-right coordinates respectively, OR flags with Pg_EXTENT_BASED.

Returns:

0

Success.

-1

The draw buffer is too small to hold the current draw state and the draw command.

Examples:

The following example:

DrawStrokeElli() {
    PhPoint_t   c = { 80, 60 };
    PhPoint_t   r = { 72, 52 };

    PgSetStrokeColor( Pg_WHITE );
    PgDrawEllipse( &c, &r, Pg_DRAW_STROKE );
}

will draw:

The following example:

DrawFillElli() {
    PhPoint_t   c = { 80, 60 };
    PhPoint_t   r = { 72, 52 };

    PgSetFillColor( Pg_PURPLE );
    PgDrawEllipse( &c, &r, Pg_DRAW_FILL );
}

will draw:

The following example:

DrawFillStrokeElli() {
    PhPoint_t   c = { 80, 60 };
    PhPoint_t   r = { 72, 52 };

    PgSetFillColor( Pg_PURPLE );
    PgSetStrokeColor( Pg_WHITE );

    PgDrawEllipse( &c, &r, Pg_DRAW_FILL_STROKE );
}

will draw:

Classification:

Photon

See also:

PgDrawRoundRect(), PgSetFillColor(), PgSetFillDither(), PgSetFillTransPat(), PgSetStrokeColor(), PgSetStrokeDither(), PgSetStrokeTransPat()