PdSetTargetDevice()

Set the target device

Synopsis:

int PdSetTargetDevice ( PhDrawContext_t dc,
                        PhRid_t device_rid );

Library:

ph

Description:

This function sets the device with the given region ID to be the target for device-specific queries and control operations in the given draw context. By default, the target is the screen.

To get the region IDs for the currently available draw devices, call PdGetDevices().

The following functions can be targeted at specific cards:

• PdCreateDirectContext()
• PdCreateOffscreenContext()
• PdDupOffscreenContext()
• PdReleaseDirectContext()
• PgGetGraphicsHWCaps()
• PgGetPalette()
• PgGetVideoMode()
• PgGetVideoModeInfo()
• PgGetVideoModeList()
• PgReadScreen()
• PgReadScreenSize()
• PgSetVideoMode()
• PgWaitDrawComplete()
• PgWaitHWIdle()

Returns:

0

Success.

-1

An error occurred.

Classification:

Photon

See also:

PdGetDevices()

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