PiDuplicateImage()

Duplicate an image

Synopsis:

PhImage_t *PiDuplicateImage( PhImage_t *image,
                             int flags );

Library:

ph

Description:

This function creates a duplicate of the Photon image defined in the PhImage_t structure pointed to by image.

The flags argument dictates special behavior of the duplication process, and can take on the following values:

Pi_FREE: Free the original image if the duplication succeeds.
Pi_SHMEM: Store the newly created image data in shared memory. This speeds up the rendering of the image if the graphics driver is local.

Returns:

A pointer to the new image on success, or NULL if an error occurred.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PhCreateImage(), PhImage_t, PiCropImage(), PiFlipImage()

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