DEVICE
Syntax | Examples | Version History
The DEVICE procedure provides device-dependent control over the current graphics device (as set by the SET_PLOT routine). The IDL graphics procedures and functions are device-independent. That is, IDL presents the user with a consistent interface to all devices. However, most devices have extra abilities that are not directly available through this interface. DEVICE is used to access and control such abilities. It is used by specifying various keywords that differ from device to device.
Note
Each keyword to DEVICE is followed by the device(s) to which it applies. See IDL Direct Graphics Devices for a description of the keywords available for each graphics device.
Syntax
DEVICE [, /AVANTGARDE | , /BKMAN | , /COURIER | , /HELVETICA | , /ISOLATIN1 | , /PALATINO | , /SCHOOLBOOK | , /SYMBOL | , /TIMES | , /ZAPFCHANCERY | , /ZAPFDINGBATS {PS}]
[, /AVERAGE_LINES{REGIS}]
[, /BINARY | , /NCAR | , /TEXT {CGM}]
[, BITS_PER_PIXEL={1 | 2 | 4 | 8}{PS}]
[, /BOLD{PS}]
[, /BOOK{PS}]
[, /BYPASS_TRANSLATION{WIN, X}]
[, /CLOSE{Z}]
[, /CLOSE_DOCUMENT{PRINTER}]
[, /CLOSE_FILE{CGM, HP, METAFILE, PCL, PS, REGIS, TEK}]
[, /CMYK{PS}]
[, /COLOR{PCL, PS}]
[, COLORS=value{CGM, TEK}]
[, COPY=[Xsource, Ysource, cols, rows, Xdest, Ydest [, Window_index]]{WIN, X}]
[, /CURSOR_CROSSHAIR{WIN, X}]
[, CURSOR_IMAGE=value{16-element short int vector}{WIN, X}] [, CURSOR_MASK=value{WIN, X}]
[, /CURSOR_ORIGINAL{WIN, X}]
[, CURSOR_STANDARD=value{WIN: arrow=32512,
I-beam=32513, hourglass=32514, black cross=32515, up arrow=32516, size(Windows)=32640, icon(Windows)=32641, size NW-SE=32642, size NE-SW=32643, size E-W=32644, size N-S=32645}{X: one of the values in file cursorfonts.h}]
[, CURSOR_XY=[x,y]{WIN, X}]
[, /DECOMPOSED{PS, WIN, X}]
[, /DIRECT_COLOR{X}]
[, EJECT={0 | 1 | 2}{HP}]
[, ENCAPSULATED={0 | 1}{PS}]
[, ENCODING={1 (binary) | 2 (text) | 3 (NCAR binary)}{CGM}]
[, FILENAME=filename{CGM, HP, METAFILE, PCL, PS, REGIS, TEK}]
[, /FLOYD{PCL, X}]
[, FONT_INDEX=integer{PS}]
[, FONT_SIZE=points{PS}]
[, GET_CURRENT_FONT=variable{METAFILE, PRINTER, WIN, X}]
[, GET_DECOMPOSED=variable {PS, WIN, X, Z}]
[, GET_FONTNAMES=variable{METAFILE, PRINTER, WIN, X}]
[, GET_FONTNUM=variable{METAFILE, PRINTER, WIN, X}]
[, GET_GRAPHICS_FUNCTION=variable{WIN, X, Z}]
[, GET_PAGE_SIZE=variable{PRINTER}]
[, GET_PIXEL_DEPTH=variable{Z}]
[, GET_SCREEN_SIZE=variable{WIN, X}]
[, GET_VISUAL_DEPTH=variable{WIN, X}]
[, GET_VISUAL_NAME=variable{WIN, X}]
[, GET_WINDOW_POSITION=variable{WIN, X}]
[, GET_WRITE_MASK=variable{X, Z}]
[, GIN_CHARS=number_of_characters{TEK}]
[, GLYPH_CACHE=number_of_glyphs{METAFILE, PRINTER, PS, WIN, Z}]
[, /INCHES{HP, PCL, METAFILE, PRINTER, PS}]
[, /INDEX_COLOR{METAFILE, PRINTER}]
[, /ITALIC{PS}]
[, /LANDSCAPE | , /PORTRAIT{HP, PCL, PRINTER, PS}]
[, LANGUAGE_LEVEL={1 | 2}{PS}]
[, /DEMI | , /LIGHT | , /MEDIUM | , /NARROW | , /OBLIQUE{PS}]
[, OPTIMIZE={0 | 1 | 2}{PCL}]
[, /ORDERED{PCL, X}]
[, OUTPUT=scalar string{HP, PS}]
[, /PIXELS{PCL}]
[, PLOT_TO=logical unit num{REGIS, TEK}]
[, /PLOTTER_ON_OFF{HP}]
[, /POLYFILL{HP}]
[, PRE_DEPTH=value{PS}]
[, PRE_XSIZE=width{PS}]
[, PRE_YSIZE=height{PS}]
[, /PREVIEW{PS}]
[, PRINT_FILE=filename{WIN}]
[, /PSEUDO_COLOR{X}]
[, RESET_STRING=string{TEK}]
[, RESOLUTION=value{PCL}]
[, RETAIN={0 | 1 | 2}{WIN, X}]
[, SCALE_FACTOR=value{PRINTER, PS}]
[, SET_CHARACTER_SIZE=[font size, line spacing]{CGM, HP, METAFILE, PCL, PS, REGIS, TEK, WIN, X, Z}]
[, SET_COLORMAP=value{14739-element byte vector}{PCL}]
[, SET_COLORS=value{2 to 256}{Z}]
[, SET_FONT=scalar string{METAFILE, PRINTER, PS, WIN, Z}]
[, SET_GRAPHICS_FUNCTION=code{0 to 15}{WIN, X, Z}]
[, SET_PIXEL_DEPTH={8 | 24}{Z}]
[, SET_RESOLUTION=[width, height]{Z}]
[, SET_STRING=string{TEK}]
[, SET_TRANSLATION=variable{X}]
[, SET_WRITE_MASK=value{0 to 2n-1 for n-bit system}{X, Z}]
[, STATIC_COLOR=value{bits per pixel}{X}]
[, STATIC_GRAY=value{bits per pixel}{X}]
[, /TEK4014{TEK}]
[, /TEK4100{TEK}]
[, THRESHOLD=value{PCL, X}]
[, TRANSLATION=variable{WIN, X}]
[, TRUE_COLOR=value{bits per pixel}{METAFILE, PRINTER, X}]
[, /TT_FONT{METAFILE, PRINTER, PS, WIN, X, Z}]
[, /TTY{REGIS, TEK}]
[, /VT240 | , /VT241 | , /VT340 | , /VT341 {REGIS}]
[, WINDOW_STATE=variable{WIN, X}]
[, XOFFSET=value{HP, PCL, PRINTER, PS}]
[, XON_XOFF={0 | 1 (default)}{HP}]
[, XSIZE=width{HP, METAFILE, PCL, PRINTER, PS}]
[, YOFFSET=value{HP, PCL, PRINTER, PS}]
[, YSIZE=height{HP, PCL, METAFILE, PRINTER, PS}]
[, Z_BUFFERING={0 | 1 (default)}{Z}]
Examples
The following example retains the name of the current graphics device, sets plotting to the PostScript device, makes a PostScript file, then resets plotting to the original device:
Version History
For more information on deprecated features, see IDL API History.
