Create an offscreen context that a layer can display
PdOffscreenContext_t *PgCreateLayerSurface( int layer, int surface_index, int format_index, unsigned short width, unsigned short height, unsigned long flags);
PgCreateLayerSurface() creates an offscreen context that can be nearby the given layer in the given format.
For layer formats that require data from more than one surface, surface_index is used to distinguish each surface.
For these layer formats:
use these surface indices:
For all other layer formats, use 0 for surface_index.
|You must target this function at a device by calling PdSetTargetDevice().|
If a layer is reconfigured (e.g. its format is changed), previously allocated offscreen contexts might no longer be compatible with the layer.
To tell a layer to read data from a surface, call PgSetLayerSurface().
|You can't use Photon drawing functions on a surface with a format that doesn't match the current video mode.|
A pointer to a PdOffscreenContext_t structure, or NULL if an error occurred.
PdGetOffscreenContextPtr(), PdOffscreenContext_t, PdSetTargetDevice(), PgGetLayerCaps(), PgSetLayerSurface()
“Layers” in the Raw Drawing and Animation chapter of the Photon Programmer's Guide