Create an offscreen context
PdOffscreenContext_t *PdCreateOffscreenContext( unsigned long ImageType, unsigned short width, unsigned short height, unsigned long flags );
For more information about these image types, see PhImage_t.
The driver may change the dimensions and/or image type of the context in order to comply with this flag.
Requests made to hardware without linear accessible memory may fail. |
ph
This function creates an offscreen context.
You must target this function at a specific card by calling PdSetTargetDevice(). PdCreateOffscreenContext() 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).
A pointer to a PdOffscreenContext_t, or NULL if an error occurred.
Photon
Safety: | |
---|---|
Interrupt handler | No |
Signal handler | No |
Thread | No |
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