NewGDevice

Allocate new gDevice structure

#include <QDOff screen.h> Graphics Devices

GDHandle NewGDevice( refNum, mode );

short refNum ; Reference number for specified graphics device

long mode ; Default = 128 = monochrome

returns handle leading to a new graphics device (NIL if fail)

NewGDevice creates a gDevice record and its associated handles, calls

InitGDevice and returns a NIL if the request fails.

refNum is the is the reference number of the specified graphics device.

mode is a set to 128 as a default for a monochrome monitor.

Returns: a GDHandle; a handle leading to InitGDevice, returns NIL if

the request fails.

Notes: The new gDevice (along with its handles) is stored in system memory and

all of the attributes in GDFlags are set to FALSE. Mode should equal -1 if

you're not creating a gDevice with a driver, which also means that

InitGDevice won't be called and your application will have to do the

initialization. Normally, a gDevice will be assumed to have mode 128 and

the gdDevType attribute is FALSE. If the mode is not the default, the

attribute is TRUE and indicates that the device can display color.

GetNewDevice, by itself, won't add the new gDevice to the device list.

Referenced by (11):