---

PiSetPixel()

Alter the value of a pixel within an image

Synopsis:

int PiSetPixel( PhImage_t *image,
                ushort_t x,
                ushort_t y,
                ulong_t value );

Library:

ph

Description:

This function alters the value of a pixel within an image.

The image argument is a pointer to a PhImage_t structure that defines the image to be modified, while the x and y arguments specify the coordinates of the pixel to change.

The value argument specifies the new value of the pixel, and its meaning depends on the image's type. See the documentation for PiGetPixel() to see how this argument is interpreted.

Returns:

0

Success.

-1

An error occurred because the pixel was out of bounds or the image type wasn't recognized.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PhImage_t, PiGetPixel(), PiGetPixelFromData(), PiGetPixelRGB(), PiSetPixelInData()

"Images" in the Raw Drawing and Animation chapter of the Photon Programmer's Guide

---