ANSIG v3.3: GRAPHICS command reference

GRAPHICS command reference

If no arguments are given, then the GRAPHICS command activates the graphics. Further user input is then expected from the graphics interface, while the tty is inactive (except for output generated by ANSIG). A spectrum window is created if there is none.

To return to the tty from the graphics, pick the item tty in the graphics command menu, or hit the keyboard key T. command menu handling windows AREA ASSIGNMENTS ATTACH BOX CLEAR CLOSE COLOR CONNECTIONS CONTOURS CROSSPEAKS CURRENT ECHO MARK MENU NEGATIVE PICK PLANE REVERSE RULER TOGGLE TRACE TTY UNVIEW UPDATE VIEW WINDOW

Handling windows

A new graphics window is brought up by the command GRAPHICS WINDOW, or by picking the item window in the commands menu. A total of 6 spectrum display windows can be open during a session. As long as the graphics remains opened, at least one spectrum display window is always present together with the commands menu.

The graphics windows can be repositioned, resized (except for the command menu window) and iconized during a session, using the usual window manager facilities.

A graphics window is removed by selecting the item Close from the window manager menu: Press and hold down the right mouse button while on the window border, move to the Close item in the pop-up menu, and release the button. The Quit command cannot be used.

`GRAPHICS AREA`

Sets the viewed area in the current window to encompass the current area. This is the inverse of the command GRAPHICS CURRENT. See also: GRAPHICS BOX.

`GRAPHICS ASSIGNMENTS spectrum`

Download to the graphics all assignment labels for all loaded crosspeaks in the given spectrum.

`GRAPHICS ASSIGNMENTS crosspeak`

Download to the graphics the assignment label for the given crosspeak, if it is loaded.

`GRAPHICS ATTACH thisdim [ otherwindow otherdim ]`

Attaches the window scaling and translation along the specified dimension of the current window to the given window and dimension. This means that scaling and translating the spectra in one window will also move and translate the spectra in the other attached window.

If no arguments for the other window are given, then any current attachment for the current window in the specified dimension is severed.

Only the F1 and F2 window dimensions can be attached to each other.

`GRAPHICS BOX`

Activates an interactively changeable box in the current window, whose position when the item yes is picked defines the current area. Picking no or abort deactivates the box without modifying the current area.

The initial position of the box is the current area.

The box is moved by picking one side, holding down the mouse button, and dragging to the desired position. This can be done with any side any number of times before picking yes or no. The corners of the box cannot be picked.

When 3D/4D spectra are present, the position of the non-plane scroll bars control the current area set in those dimensions.

See also: GRAPHICS AREA and GRAPHICS CURRENT.

`GRAPHICS CLEAR ASSIGNMENTS spectrum`

`GRAPHICS CLEAR CONNECTIONS spectrum`

`GRAPHICS CLEAR CONTOURS spectrum`

`GRAPHICS CLEAR CROSSPEAKS spectrum`

Clears away all graphical objects of the given kind in the given spectrum. The crosspeak database itself is not affected. If the crosspeaks are cleared, then all connections and assignments in that spectrum are also cleared.

Available in the graphics menu as item clear followed by the appropriate item.

`GRAPHICS CLOSE`

Closes the current graphics window. The last spectrum window cannot be closed. This command can be given from the graphics by using the Close option in the window manager pop-up menu. See also: GRAPHICS WINDOW.

`GRAPHICS COLOR ASSIGNMENTS spectrum [ red.r green.r blue.r ]`

`GRAPHICS COLOR CONNECTIONS spectrum [ red.r green.r blue.r ]`

`GRAPHICS COLOR CONTOURS spectrum [ red.r green.r blue.r ]`

`GRAPHICS COLOR CROSSPEAKS spectrum [ red.r green.r blue.r ]`

Changes the color of the given graphical object in the given spectrum. The availability of colors depend on the hardware. With sufficient number of bitplanes, the contours have different colours for positive and negative levels, and the crosspeaks can have another color. Connections and assignments always have the same color as the crosspeaks in a spectrum.

The color values are reals in the range [0.0, 1.0] and define the amount of red, green and blue to use for the specified objects. If no values are given, then the interactive color change is activated. Move the color scroll bars to the desired position (which changes the color immediately) and pick any object (crosspeak or menu item) to finish.

`GRAPHICS CONNECTIONS spectrum`

Download all connections between downloaded crosspeaks in spectrum.

`GRAPHICS CONTOURS spectrum`

Download contours for the given spectrum within the current spectrum area. If the contour file(s) have been defined and are active, the contours will be read from the file(s). If not, then contours are computed directly from the matrix file.

If contours are computed directly from the spectrum matrix, then it is possible to stop this by pressing the ESC key or the Q key while the mouse pointer is inside a graphics window.

`GRAPHICS CROSSPEAKS spectrum`

Download to the graphics all crosspeaks in the given spectrum that are within the current spectrum area.

`GRAPHICS CROSSPEAKS crosspeak`

Download the given crosspeak to the graphics.

`GRAPHICS CURRENT`

Sets the current area to that viewed in the current spectrum area. This is the inverse of the command GRAPHICS AREA. The defined current area is also output to the tty.

`GRAPHICS ECHO [ message... ]`

Puts the given message string, if any, into the message area of the graphics menu window. The string is processed as usual before output.

`GRAPHICS MARK crosspeak`

Puts the dashed-line marker on the crosspeak. The marker lines will be present in all window dimensions which have the same expnucleus as any of the dimensions of the crosspeak. If the crosspeak is aliased, then lines will appear at the aliased coordinates as well.

`GRAPHICS MARK logical`

If given the logical yes, then the marker will appear at the place it was at before being made invisible. If it already is visible, then there is no change. If given the logical no, then the marker will disappear.

`GRAPHICS MENU`

Delete all user-defined items in the graphics menu window.

`GRAPHICS MENU [ slot-number ] menu-item`

Place the item in the user-definable area of the graphics menu window. This is how one makes macros available as commands from the graphics interface. Currently, at most 18 (2*9) items may be defined. The item is put into the first available slot, unless a specific slot number is given.

`GRAPHICS NEGATIVE logical`

If the logical is yes, then all negative contours will be dark blue.

If the logical is false (default), then the contours will have the same colour as the positive if the graphics hardware does not have enough bit planes (8 bits). If the graphics hardware has enough bit planes (>8 bits) then the negative contours will have the complement colour to the positive contours.

`GRAPHICS PICK spectrum`

Activates the interactive graphics crosspeak picker. After this command has been given, ANSIG asks the user to indicate a position in a graphics window by pointing to a position and clicking the middle mouse button. A crosspeak will be created in the given spectrum at the indicated position. The intensity of the crosspeak will be the mean of the intensities of the crosspeak already in that spectrum.

If the spectrum is a 3D or 4D spectrum, then the crosspeak position in the non-plane dimensions will be set as the middle of the current non-plane scroll bar positions in the graphics window.

`GRAPHICS PLANE expnucleus1 expnucleus2`

Changes the expnucleus plane of the current graphics window. The displayable spectra will be given default views in the graphics window. See also: GRAPHICS VIEW.

`GRAPHICS REVERSE`

Switches the foreground and background colors in all graphics windows. It is not possible to select other colors than black or white for the background and foreground.

Default: background = back, foreground = white

`GRAPHICS RULER`

Output to the tty the current coordinates (in ppm) of the rulers in the current window.

`GRAPHICS TOGGLE [ spectrum ]`

Toggles on or off the display of all objects in the given spectrum. If no spectrum is given, then all spectra are toggled back on.

Note that toggling does not load or unload anything in the graphics. When a spectrum is toggled away, the graphics retains all the objects loaded to it. The objects are just not displayed.

This command is available in the graphics input mode as a quick command.

`GRAPHICS TRACE spectrum window-dimension`

The TRACE command is not properly documented, and the command contains some bugs which have not been sorted out yet.

Display a 1D trace of the spectrum matrix for the given spectrum in the given window dimension in the current window. The vector shown is defined by the currently visible area in the window, and the ruler in the given dimension. The special window is created if it does not exist.

`GRAPHICS TRACE spectrum first-ppm last-ppm real-list`

Display the values in a real list as a 1D trace in the given spectrum starting and ending at the given ppm values. The points are equally spaced along the ppm scale.

`GRAPHICS TRACE`

The command without parameters removes the 1D window.

`GRAPHICS TTY`

Switches off the graphics interface, and activates the tty. Further input is taken from the tty rather than the graphics. This is the inverse of the command GRAPHICS. It is the same command as picking the item tty in the command menu.

`GRAPHICS UNVIEW spectrum`

Switches off the display of the given spectrum in the current window.

This command is useful to remove the display of a certain spectrum if it is irrelevant or otherwise unwanted in a graphics window. By default ANSIG displays all spectra it can in each window.

`GRAPHICS UPDATE`

Forces an update of the graphics spectrum and menu windows. This can be useful if one wants to update the graphics after having, for instance, moved windows, without having to go to graphics mode. It may also be useful in writing macros.

`GRAPHICS VIEW spectrum fd1 fd2`

Change the view of the spectrum in the current window. The given dimensions fd1 and fd2 refer to the spectrum dimensions that are to be displayed as the window dimension F1 and F2, respectively. The plane (expnuclei in each window dimension) in the current window must match the chosen spectrum dimensions.

By default, the views for the spectra in the window are chosen as sensibly as possible. The spectrum is not viewed in the window if no plane in the spectrum matches the graphics window plane.

`GRAPHICS WINDOW`

The command without argument creates a window to be positioned by the user or automatically by the windowing system.

`GRAPHICS WINDOW number`

The command with an integer argument changes the window which is current. The value must be a valid window number.

`GRAPHICS WINDOW xlow ylow xhigh yhigh`

The command with four numerical values as arguments creates a new window and positions it and sets the size of it according to the values given. If the high values are higher than 1.0, then they are interpreted as pixels, otherwise as fractions of the total screen size. The x (horizontal) and y (vertical) coordinates of the lower left corner of the window are given first, followed by the coordinates of the upper right corner.

Per Kraulis 16 Apr 1996.