SET_SCREEN Procedure

Reference Guide > S Routines > SET_SCREEN Procedure

Standard Library procedure that establishes a new position for the rectangular plot area based on input values specified using the device coordinate system.

Usage

SET_SCREEN, xmin, xmax[, ymin, ymax]

Input Parameters

xmin—The position of the left edge of the rectangular plot area in device coordinates.

xmax—The position of the right edge of the rectangular plot area in device coordinates.

ymin—The position of the bottom edge of the rectangular plot area in device coordinates.

ymax—The position of the top edge of the rectangular plot area in device coordinates.

Keywords

Cursor—Lets you set the region for the rectangular plot area interactively with the mouse:

If nonzero, lets you set the boundaries by clicking the mouse at the corners of the rectangular plot area that you want to use. Click first to set the lower-left corner, then once again to set the upper-right corner. Any input parameters for SET_SCREEN are ignored.

If zero, uses the input parameters as specified.

Region—If present, uses the system variable !P.Region to set the plot area. The default is to use !P.Position.

Discussion

SET_SCREEN is used to set up the area of the display that will be used for plotting. It is identical to the SET_VIEWPORT procedure, except that the input parameters are in device coordinates for SET_SCREEN.

If only xmin and xmax are provided, the values for ymin and ymax are calculated. Calling SET_SCREEN with four input parameters is the same as setting the !P.Position system variable or using the Position keyword with the plotting commands.

SET_SCREEN overrides the system variables !X.Margin and !Y.Margin.

note	To find out current values of your device, type one of the following two commands: INFO, /Structure, !D PRINT, !D.X_Size, !D.Y_Size

Example

INFO, /Structure, !D

SET_SCREEN, !D.X_Size/10., !D.X_Size/2.

SET_SCREEN, !D.X_Size/10., !D.X_Size/2.1, $

   !D.Y_Size/1.7, !D.Y_Size/1.1

PLOT, [3, 4, 5], Title='Upper left plot'

SET_SCREEN, !D.X_Size/10., !D.X_Size/2.1, $

   !D.Y_Size/10., !D.Y_Size/2.3

PLOT, [5, 1, 6], Title='Lower left plot', /Noerase

SET_SCREEN, !D.X_Size/1.8, !D.X_Size/1.1, $

   !D.Y_Size/1.7, !D.Y_Size/1.1

PLOT, [3, 4, 5], Title='Upper right plot', /Noerase

SET_SCREEN, !D.X_Size/1.8, !D.X_Size/1.1, $

   !D.Y_Size/10., !D.Y_Size/2.3

PLOT, [2, 4, 3], title='Lower right plot', /Noerase

SET_SCREEN, 1, 1, 1, 1, /Cursor

; Click the mouse button on the lower left corner of the desired

; plotting area and then again for the desired upper right corner.

PLOT, [3, 5, 4]

SET_SCREEN, !D.X_Size/10., !D.X_Size/1.1, $

   !D.Y_Size/10., !D.Y_Size/1.1

PLOT, [3, 4, 5], Title='Without setting the region keyword'

SET_SCREEN, !D.X_Size/10., !D.X_Size/1.1, $

   !D.Y_Size/10., !D.Y_Size/1.1, /Region

PLOT, [3, 4, 5], Title='With the region keyword set', /Noerase