PdCreateOffscreenContextGF()

Create a GF offscreen context

Synopsis:

PdOffscreenContext_t *PdCreateOffscreenContextGF(
                         gf_surface_t surface);

Arguments:

surface
A handle to a GF surface.

Library:

ph

Description:

The function binds a GF surface to a Photon PdOffscreenContext_t.


Note: You must target this function at a specific card by calling PdSetTargetDevice(). PdCreateOffscreenContextGF() blocks until the operation is complete.

If there isn't enough space in video RAM to create the offscreen context, the behavior of this function depends on the driver; most drivers allocate space in system memory instead (if none of SYS_ONLY, 2D_WRITABLE, or 2D_READABLE are set in flags).

Returns:

A pointer to a PdOffscreenContext_t, or NULL if an error occurred.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PdCreateOffscreenContext(), PdDupOffscreenContext(), PdGetOffscreenContextPtr(), PdOffscreenContext_t, PdSetOffscreenTranslation(), PdSetTargetDevice(), PgContextBlit(), PgSwapDisplay(), PhDCCreate(), PhDCRelease()

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