Keywords: greg-2011

Next: Changes for programmers Up: Changes for end-users Previous: New Contents

## Commands, variables, SIC logicals and symbols

There has been an important effort to clarify the names of the various GTV objects, to fix or improve their behavior, and to clean out the obsolete ones. This can imply here and there an action from the user to make its procedures compatible with the new GTV. The new GTV knows about the old commands: it will detect these and suggest to the user what they should be replaced with. It can run in 2 modes, tolerant or strict, which can be toggled with the SIC variable `GTV%STRICT2011`. All the changes regarding these objects are exhaustively described in the appendix . The tables , , and summarize these changes.

Table: Old `GTV` and `GREG` commands which are removed or modified, their purpose, and their equivalent with the new GTV syntax. Refer to section for a detailed description.
Old command | Behavior | Equivalent
`CLEAR` | perform a `CLEAR PLOT` | see `CLEAR PLOT`
`CLEAR ALPHA` | bring the plotting window in front | not yet defined
`CLEAR GRAPHIC` | bring the terminal in front | none
`CLEAR PLOT` | perform a `CLEAR WHOLE`, or | `DESTROY ALL`, or
| perform a `CLEAR TREE` | `CHANGE DIRECTORY` + `CLEAR DIRECTORY`
`CLEAR TREE` | destroy the current tree | `CHANGE DIRECTORY` + `CLEAR DIRECTORY`
`CLEAR WHOLE` | destroy all the trees | `DESTROY ALL`
`CLEAR WINDOW [Num]` | close the active/numbered window | `DESTROY WINDOW [Dir [Num]]`
`CHANGE CLEAR TREE|WHOLE` | set the behavior of `CLEAR PLOT` | none
`CHANGE DRAW ON|OFF` | toggle the drawing state to active or sleeping | none
`CHANGE ZOOM NEW|CURRENT` | toggle the default behavior of ZOOM | none
`CREATE DIRECTORY /PIXEL` | set the window size of a new top directory | `CREATE DIRECTORY /GEOMETRY`
`CREATE DIRECTORY /SIZE` | set the plot page of a new top directory | `CREATE DIRECTORY /PLOT_PAGE`
`DISPLAY CLEAR` | show the `CLEAR PLOT` behavior | none
`HARDCOPY /PLOT` | send the hardcopy to the printer | `HARDCOPY /PRINT`
`ZOOM REFRESH` | force the redraw of the active window | `REFRESH [Dir [Num]]`
`ZOOM /REGION` | define the zoom area with the cursor | none
`ZOOM /CURRENT` | zoom is performed in the current window | none
`ZOOM /NEW` | zoom is performed in a new window | `ZOOM` without argument
`GREG1SET DRAW ON|OFF` | toggle the drawing state to active or sleeping | none
`GREG1SHOW DRAW` | display the drawing state | none

Table: `GTV` and `GREG` variables which are removed, modified, or added. Their read-write status is indicated in the third column. Refer to section for a detailed description.
Old name | New name | Read-Write | Usage
`GTV%SLEEP` | none | RO | the active/sleeping drawing state
`GTV%IMAGES[4,15]` | none | RO | internal values associated to the first 15 images
`GTV%IDENT` | none | RW | the number of the device currently in use
`LUT` | none | RO | the hue values of the current LUT in use
`REXTR` | none | RO | the extrema of the last segment created
`REXTR_D` | none | RO | the extrema of the current working directory
none | `GTV%PWD` | RO | the current working directory
none | `GTV%FITPAGE` | RW | activate option `/FITPAGE` for `HARDCOPY`
`GTV%LUT_STATIC` | `LUT%STATIC` | RO | the dynamic/static LUT state
`LUT_SIZE` | `LUT%SIZE` | RO | the number of levels of the current LUT
`LUT_MODE` | `LUT%MODE` | RW | the HSV or RGB mode for the user-defined LUT
`HUE` | `LUT%HUE` | RW | the hue values of the current LUT (input/output)
`SATURATION` | `LUT%SATURATION` | RW | same for the saturation values
`VALUE` | `LUT%VALUE` | RW | same for the intensity values
`RED` | `LUT%RED` | RW | same for the red intensity values
`GREEN` | `LUT%GREEN` | RW | same for the green intensity values
`BLUE` | `LUT%BLUE` | RW | same for the blue intensity values
`B_HUE` | `LUT%BLANKING%HUE` | RW | the hue value of the blanking color (input/output)
`B_SATURATION` | `LUT%BLANKING%SATURATION` | RW | same for the saturation value
`B_VALUE` | `LUT%BLANKING%VALUE` | RW | same for the intensity value
`B_RED` | `LUT%BLANKING%RED` | RW | same for the red intensity value
`B_GREEN` | `LUT%BLANKING%GREEN` | RW | same for the green intensity value
`B_BLUE` | `LUT%BLANKING%BLUE` | RW | same for the blue intensity value
`P_HUE` | `LUT%PEN%HUE` | RW | the hue values of the user-defined pens (input/output)
`P_SATURATION` | `LUT%PEN%SATURATION` | RW | same for the saturation values
`P_VALUE` | `LUT%PEN%VALUE` | RW | same for the intensity values
`P_RED` | `LUT%PEN%RED` | RW | same for the red intensity values
`P_GREEN` | `LUT%PEN%GREEN` | RW | same for the green intensity values
`P_BLUE` | `LUT%PEN%BLUE` | RW | same for the blue intensity values
`LCUT` | `CURIMA%SCALE[1]` | RO | low cut for last image `PLOT`'ted
`HCUT` | `CURIMA%SCALE[2]` | RO | high cut for last image `PLOT`'ted
`SCALING` | `CURIMA%SCALING` | RO | scaling mode for last image `PLOT`'ted
`EQUAL_NLEV` | `CURIMA%EQUAL%NLEV` | RO | number of levels in `EQUAL` mode
`EQUAL_LEV` | `CURIMA%EQUAL%LEV` | RO | levels in `EQUAL` mode
`EQUAL_HIST` | `CURIMA%EQUAL%HIST` | RO | values per level in `EQUAL` mode

Table: `SIC` logicals in `GTV` which are modified or added. Refer to section for a detailed description.
Old name | Equivalent name | Usage
`LUT_DIR:` | `LUT#DIR:` | where the LUT files should be searched in
none | `WINDOW_GEOMETRY` | the default geometry of new windows
none | `WINDOW_POSITION` | the position on screen of the first window

Table: Old GTV symbols which are removed, and the command which can be used to define them in user's /.gag.dico . Refer to section for a detailed description.
Old symbol | Equivalent
`CD` | `SYMBOL CD "GTVLCHANGE DIRECTORY"`
`PWD` | `SYMBOL PWD "GTVLDISPLAY DIRECTORY"`
`MKDIR` | `SYMBOL MKDIR "GTVLCREATE DIRECTORY"`

Next: Changes for programmers Up: Changes for end-users Previous: New Contents