Syntax

[C/C++:]
void gEnqDeviceState(GDEVSTATE *devstate);

[F90:]
subroutine gEnqDeviceState(devstate)
type (GDEVSTATE), intent(out) :: devstate

Arguments

devstate.name
Device driver nomination routine name

devstate.ddver
Device driver version number

devstate.maxaux
Maximum number of auxiliary drawing areas

devstate.dddim
Coordinate system handled by driver

= 2,

2D driver

= 3,

3D driver

devstate.ndevty
Device type

<0,	Metafile device (JPEG, PNG, BMP etc.)

1 - 99,

Graphics terminal

100 - 199,

Plotter (on-line)

200 - 299,

Plotter (on-line)

300 - 399,

Windowing Device

400 - 499,

GINOMENU GUI device (no GINO events)

devstate.ndev
Device output file pointer/unit

devstate.ntype
Device output type

devstate.xmm
Number of millimetres in 1 current unit

devstate.xdu
Number of device units in 1 current unit

devstate.unitsc
Device unit in millimetres

devstate.atrib
Device attribute flag

devstate.ahard
Arc generation flag

= 0,	Hardware arcs not available

= 1,	Hardware arcs available

devstate.arctol
Arc tolerance

devstate.cwt
Line attributes entries flag

= 0,	Driver used PENSEL entry

= 1,	Driver used LINCOL, LINWID, PENTYP and %%%%PENSET

devstate.nbrk
Number of hardware broken line types

devstate.nlend
Number of line end types

devstate.thick
Thick line generation flag

= 0,	Thick lines done in driver

= 1,	Thick lines generated by lines drawn in direction of line

= 2,	Thick lines generated by horizontal/vertical lines

= 3,	Thick lines generated by hardware area fill

devstate.chard
Character generation flag

= 1,	Hardware characters available

= 2,	Hardware characters not available

devstate.nchard
Number of hardware character sizes

devstate.cangm
Hardware character angle multiple

= 0,	Only horizontal

= 1	All angles can be drawn

> 1,	Only angles at this multiple (eg. 90 degrees)

devstate.rectfi
Rectangle filling flag

= 0,	No rectangle filling available

= 1,	Rectangle filling available

devstate.npolmx
Maximum number of polygons that can be filled

= -1,

No limitation

= 0,	No polygon filling

= 1,	Single polygon only

> 1,	Maximum polygon limit

devstate.nvermx
Maximum number of points in filled polygons

devstate.ndcmax
Maximum number of colours/pens available

= 0,	Monochrome device

= 1,	Monochrome device with background erase

> 1,	Colour/greyscale device

devstate.ndtmax
Display colour type

= 0,	No colour/greyscale variation (i.e. Monochrome)

1,	Fixed colour/greyscale (i.e. no rgb facilities)

2,	Static colour/greyscale (i.e. selection from fixed palette)

3,	Pseudo colour/greyscale

4,	Direct colour/greyscale

devstate.whard
Hardware windowing flag

= 0,	No hardware windowing

= 1,	Device can do hardware windowing

devstate.mhard
Hardware masking flag

= 0,	No hardware masking

= 1,	Device can do hardware masking

devstate.nsegmx
Maximum permitted segment number

devstate.ncurtp
Number of CURSOR types

devstate.nevetp
Number of EVENT types

devstate.nquemx
Maximum queue length

devstate.dialog
Dialogue area flag

= 0,	No dialogue facilities

= 1,	Device has dialogue facilities

devstate.xpixel
Horiz. pixel size in current units

devstate.ypixel
Vert. pixel size in current units

devstate.npixdp
Maximum pixel depth

devstate.nxpix
Number of pixels in horizontal device limit

devstate.nypix
Number of pixels in vertical device limit

Description

The routine gEnqDeviceState() returns information relating to the currently nominated device in the structure devstate.

The information returned by gEnqDeviceState() is set by the device driver and in most cases cannot be changed by a GINO program after device initialization.

See Also

gEnqDeviceState Usage
gEnqColourInfo
gEnqMaxDrawingLimits

---