PgDrawPixel(), PgDrawIPixel(), PgDrawPixelCx(), PgDrawIPixelCx()

Draw a point

Synopsis:

int  PgDrawPixel( PhPoint_t const *pt );

int  PgDrawIPixel( int x,
                   int y );

int  PgDrawPixelCx( void *dc,
                    PhPoint_t const *pt );

int  PgDrawIPixelCx( void *dc,
                     int x,
                     int y );

Library:

ph

Description:

These functions build a command in the draw buffer to draw a pixel. For PgDrawPixel*(), the pt argument points to a PhPoint_t structure that defines the pixel location; for PgDrawIPixel*(), x and y specify the location.

PgDrawPixel() and PgDrawIPixel() work on the current draw context, while you can specify the draw context dc for PgDrawPixelCx() and PgDrawIPixelCx().

Returns:

0

Successful completion

-1

The draw buffer is too small to hold the current draw state, the draw command, and the data. Increase the size of the draw buffer.

Classification:

Photon

See also:

PgDrawPixelArray*(), PgFlush*(), PgSetStrokeColor*(), PgSetStrokeDither*(), PhPoint_t

"Drawing attributes" and "Lines, pixels, and pixel arrays" in the Raw Drawing and Animation chapter of the Photon Programmer's Guide