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.

---

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

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