1. Home
  2. DDISPLAY directive

DDISPLAY directive

Redraws the current graphical display.

Options

DEVICE = scalar Device on which to redraw the display (on some systems it may only be possible to redisplay the picture on an interactive graphics device); default uses the current graphics device
ENDACTION = string token Action to be taken after completing the plot (continue, pause); default * uses the setting from the last DEVICE statement

No parameters

Description

This directive is provided to allow additional control of some interactive devices. In some of these, such as PC’s operating in full-screen DOS mode, the screen can operate in either text mode or graphics mode. Genstat will automatically switch the screen into the appropriate mode when starting or finishing a graph. Having returned to text mode after examining a graph you may later wish to have another look at the graph that was plotted. DDISPLAY will switch the screen back to graphics mode, thus re-displaying the graph. The ENDACTION option controls what happens after re-displaying the graph; normally with this type of device you would want to pause. The default action for DDISPLAY is the setting specified by the most recent DEVICE statement.

DDISPLAY has no effect when output is directed to a graphics file. For devices that do not operate in this dual-mode fashion, for example a graphics window under X-windows, DDISPLAY has no effect on the graphical display itself. It will however generate a pause if ENDACTION is set to request one.

Note that DDISPLAY does not actually re-plot the graphical output; it merely switches the screen into graphics mode, and assumes that your system has preserved the graphics image.

Options: DEVICE, ENDACTION.

Parameters: none.

See also

Directives: DCLEAR, DEVICE, DKEEP.

Commands for: Graphics.

Updated on March 8, 2019

Was this article helpful?