This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PhReleaseImage()

Release the allocated members of an image

Synopsis:

void PhReleaseImage( PhImage_t *image );

Library:

ph

Description:

This function releases the allocated members of the PhImage_t pointed to by image, based on the value of image->flags. The valid flags are:

• Ph_RELEASE_IMAGE
• Ph_RELEASE_PALETTE
• Ph_RELEASE_TRANSPARENCY_MASK
• Ph_RELEASE_GHOST_BITMAP
• Ph_RELEASE_IMAGE_ALL -- free all the above.

This function doesn't release the image structure itself.

Don't use PhReleaseImage() on an image acquired using PgReadScreen().

Classification:

Photon

See also:

ApGetImageRes(), PgDrawPhImage*(), PgDrawPhImageRect*(), PgDrawRepPhImage*(), PhCreateImage(), PhImage_t, PhMakeGhostBitmap(), PhMakeTransBitmap(), PmMemCreateMC(), PmMemFlush(), PxLoadImage()

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