Important: The information in this document is obsolete and should not be used for new development.
GetGWorldDevice
Use theGetGWorldDevice
function to obtain a handle to theGDevice
record associated with an offscreen graphics world.
FUNCTION GetGWorldDevice (offscreenGWorld: GWorldPtr): GDHandle;
offscreenGWorld
- A pointer to an offscreen graphics world. The pointer returned to your application by the
NewGWorld
function.DESCRIPTION
TheGetGWorldDevice
function returns a handle to theGDevice
record associated with the offscreen graphics world specified by theoffscreenGWorld
parameter. In this parameter, supply the pointer returned to your application by theNewGWorld
function when you created the offscreen graphics world. If you created the offscreen world by specifying thenoNewDevice
flag, theGDevice
record is for one of the screen devices or is theGDevice
record that you specified toNewGWorld
orUpdateGWorld
.If you point to a
GrafPort
orCGrafPort
record in theoffscreenGWorld
parameter,GetGWorldDevice
returns the current device.SPECIAL CONSIDERATIONS
TheGetGWorldDevice
function may move or purge memory blocks in the application heap. Your application should not call this function at interrupt time.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theGetGWorldDevice
function are
Trap macro Selector _QDExtensions $00040012