The IDLgrClipboard::GetDeviceInfo procedure method returns information which allows IDL applications to intelligently make decisions for optimal performance. For example, it allows an application to determine if RENDERER=1 is actually implemented in hardware. It also allows applications to make optimal quality decisions when dynamically building texture maps.

Syntax


Obj->[IDLgrClipboard::]GetDeviceInfo [, ALL=variable] [, MAX_NUM_CLIP_PLANES=variable] [, MAX_TEXTURE_DIMENSIONS=variable] [MAX_TILE_DIMENSIONS=variable] [, MAX_VIEWPORT_DIMENSIONS=variable] [, NAME=variable] [, NUM_CPUS=variable] [, VENDOR=variable] [, VERSION=variable]

Arguments


None

Keywords


ALL

Set this keyword to a named variable which, upon return, contains a structure with the values of all the device information keywords as fields.

MAX_NUM_CLIP_PLANES

Set this keyword to a named variable that upon return will contain an integer that specifies the maximum number of user-defined clipping planes supported by the device.

MAX_TEXTURE_DIMENSIONS

Set this keyword equal to a named variable. Upon return, MAX_TEXTURE_DIMENSIONS contains a two element integer array that specifies the maximum texture size supported by the device.

MAX_TILE_DIMENSIONS

Set this keyword equal to a named variable. Upon return, MAX_TILE_DIMENSIONS contains a two element integer array that specifies the maximum tile size supported by the device.

MAX_VIEWPORT_DIMENSIONS

Set this keyword equal to a named variable. Upon return, MAX_VIEWPORT_DIMENSIONS contains a two element integer array that specifies the maximum size of a graphics display supported by the device.

NAME

Set this keyword equal to a named variable. Upon return, NAME contains the name of the rendering device as a string.

NUM_CPUS

Set this keyword equal to a named variable. Upon return, NUM_CPUS contains an integer that specifies the number of CPUs that are known to, and available to IDL.

Note: The NUM_CPUS keyword accurately returns the number of CPUs for the SUN and Microsoft Windows platforms. For platforms other than these, the number returned may not reflect the actual number of CPUs available to IDL in the current system.

VENDOR

Set this keyword equal to a named variable. Upon return, VENDOR contains the name of the rendering device creator as a string.

VERSION

Set this keyword equal to a named variable. Upon return, VERSION contains the version of the rendering device driver as a string.

Version History


5.1

Introduced

5.6

Added MAX_NUM_CLIP_PLANES keyword

6.2

Added MAX_TILE_DIMENSIONS keyword