PdDupOffscreenContext()

Duplicate an offscreen context

Synopsis:

PdOffscreenContext_t *
    PdDupOffscreenContext(
        PdOffscreenContext_t *context,
        unsigned long flags );

Arguments:

context
A pointer to the context that you want to duplicate, as returned by PdCreateOffscreenContext(), or NULL if you want to duplicate the screen buffer.
flags
Flags that indicate how you want to create the offscreen context:

Library:

ph

Description:

PdDupOffscreenContext() makes a copy of the given context. This not only creates a context that has the same dimensions and image type, but also copies the image data.


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

Returns:

A pointer to a PdOffscreenContext_t structure, or NULL on failure.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PdCreateOffscreenContext(), PdGetOffscreenContextPtr(), PdOffscreenContext_t, PdSetOffscreenTranslation(), PdSetTargetDevice(), PgContextBlit(), PgSwapDisplay()

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