DKEEP directive

Saves information from the last plot on a particular device.

No options

Parameters

DEVICE = scalars

The devices for which information is required, if the scalar is undefined or contains a missing value, this returns the current device number

WINDOW = scalars

Window about which the information is required; default * gives information about the last window

YLOWER = scalars

Lower bound for the y-axis in last graph in the specified device and window

YUPPER = scalars

Upper bound for the y-axis in last graph in the specified device and window

XLOWER = scalars

Lower bound for the x-axis in last graph in the specified device and window

XUPPER = scalars

Upper bound for the x-axis in last graph in the specified device and window

FILE = scalars

Returns the value 1 or 0 to indicate whether a file is required for this device

DESCRIPTION = texts

Description of the device

DREAD = scalars

Returns the value 1 or 0 to indicate whether graphical input is possible from this device

ENDACTION = texts

Returns the current ENDACTION setting ('continue' or 'pause')

Description

DKEEP provides information that can be used in general programs and procedures to control the graphical output. For the specified device you can determine whether it generates screen output or uses a file, whether graphical input is possible, a description of the device, the current ENDACTION setting, and details of the axis bounds.

The device for which the information is required is specified by the DEVICE parameter. If you specify a scalar containing a missing value, this will be set to the number of the current graphics device. You can then test whether an output file is needed and open one accordingly.

When writing a procedure you can find out if axes bounds have been set explicitly, using the SAVE parameter of XAXIS, YAXIS and ZAXIS. This information may then be used when setting up the axes for other graphs. However, if the bounds were not set, but have been evaluated from the data (or if the axes have subsequently been redefined) the information in the save structure will not be of any use. The actual values used when plotting are recorded internally, for each window of each device, and can be accessed using the YLOWER, YUPPER, XLOWER and XUPPER parameters of DKEEP.

Options: none.

Parameters: DEVICE, WINDOW, YLOWER, YUPPER, XLOWER, XUPPER, FILE, DESCRIPTION, DREAD, ENDACTION.