Reference Guide > S Routines > SET_SCREEN Procedure
  

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.
xmaxThe 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
See Also
SET_VIEWPORT
System Variables:  !P.Position,   !P.Region

Version 2017.0
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.