Toggle()

Toggles between common settings, mainly graphics.

TOGGLE/STATUS   Reports the values of all Toggled settings.
TOGGLE/LOGX   X axis log/linear
TOGGLE/LOGY   Y axis log/linear
TOGGLE/CLEAR   Screen clearing between plots
TOGGLE/GRATICULE   Toggle graticule off/on
TOGGLE/HEADER   Header plotted on Display() command.
TOGGLE/MODE   Histogram or point mode
TOGGLE/RX   X axis rounding off/on
TOGGLE/RY   Y axis rounding off/on
TOGGLE/INFO   Informational message printing on/off
TOGGLE/DEBUG   Debug message printing on/off
[/ON]   Toggles item on
[/OFF]   Toggles item off
[/NOMESSAGE]   Does not print any related informational messages

example:

	# Switch off informational messages and display
	# a data plot with no banner heading.
	>> Toggle/info
	>> Toggle/header
	>> Display Spectrum(22)

	# Toggle the debug messages on.
	>> toggle/debug/on
	  Debug printing in ON
	# Now lets toggle them off again, but this time don't print any message.
	>> toggle/debug/off/nomessage

Note: See the Alter() command for changing other graphics settings.

Toggle/Status

The Toggle command acts like an on off switch for the settings described below. The Toggle() command used on its own without any parameters reports the settings of all toggleable parameters.

All the toggle commands switch the setting to it's opposite value unless /Off or /On is specified in which case the value of the setting is forced on or off.

Parameters:

/On

Applies to all Toggle() commands and forces the value of the parameter to the On state.

/Off

Applies to all Toggle() commands and forces the value of the parameter to the Off state.

/NoMessage

Applies to all Toggle() commands and suppresses any informational messages that may have been printed.

Toggle/LogX

Set the default mode for plotting with the Display() and Plot() commands to plot logs of the X data against a log X Axis. On startup, the X-Axis mode is linear.

Toggle/LogY

Set the default mode for plotting with the Display() and Plot() commands to plot logs of the Y data against a log Y Axis. On startup, the Y-Axis mode is linear.

Toggle/Clear

Alters the behaviour of the Display() and Multiplot() commands to produce plots without clearing the display device first. This can be used with the Alter/Plot command to put multiple pictures on one display, see also the Graphics primitive window creation commands. On startup, both the commands clear the display device by default.

Toggle/Graticule

Switches a graticule or crosshatch on for subsequent invocations of the Display() command. The frequency of the graticule may be altered by the Alter() command.

Toggle/Header

Switches the default for whether to display the standard Display() command banner or not. The banner can be toggled off to make more room to display the plot on a small screen. On startup the banner is enabled.

Toggle/RoundX

Enables rounding on the X axis. By default this is switched on, but for accuracy it may be desireable to let the absolute values of the axis be fixed to the exact limits of the plot.

Toggle/RoundY

Enables rounding on the Y axis. By default this is switched on, but for accuracy it may be desireable to let the absolute values of the axis be fixed to the exact limits of the plot.

Toggle/Info

Switches the display of informational messages on/off. Normally Open GENIE operations report warning or informational messages as ANSI style blue coloured text using the Printin() command. For example, Genie command language procedures using a lot of data I/O may wish to supress messages about the data being read.

Toggle/Debug

Switches the display of debugging messages on/off. Normally Open GENIE operations report debug messages as ANSI style pink coloured text using the Printdn() command. This display will print alot of information to the screen and therefore is probably only of use for debugging procedures.