PgDrawPixelArray(), PgDrawPixelArraymx()

Draw multiple points

Synopsis:

int PgDrawPixelArray( PhPoint_t const *ptr,
                      int num,
                      PhPoint_t const *pos );

int PgDrawPixelArraymx( PhPoint_t const *ptr,
                        int num,
                        PhPoint_t const *pos );

Description:

These functions build a command in the draw buffer to draw an array of pixels. The ptr argument points to an array of pixel locations; num indicates how many points to draw; and the value of pos is added to every pixel location.

If you call the "mx" form of this function, the data isn't physically copied into the draw buffer. Instead, a pointer to the array is stored until the draw buffer is flushed. Make sure you call PgFlush() before you modify the pixel array.

Returns:

0

Success.

-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 or decrease the number of points.

Classification:

Photon

See also:

PgDrawPixel(), PgDrawIPixel(), PgFlush(), PgSetStrokeColor(), PgSetStrokeDither()