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

PhDCRelease()

Release a draw context

Synopsis:

int PhDCRelease( PhDrawContext_t *dc );

Library:

ph

Description:

This function releases the provided DC (the default Photon draw context can not be released). The context is notified of its pending demise before it's destroyed, so that it can do any necessary cleanup.


Note: You aren't likely to call this function directly unless you're releasing:

The functions that release specific types of contexts (e.g. direct-mode, printer, and memory) call PhDCRelease().


Returns:

0
Success.
-1
An error occurred (most likely you're trying to release the Photon default DC).

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PdReleaseDirectContext(), PdCreateOffscreenContext(), PhDCCreate(), PhDCGetCurrent(), PhDCSetCurrent(), PmMemReleaseMC(), PpReleasePC()

"Video memory offscreen" in the Raw Drawing and Animation chapter of the Photon Programmer's Guide