BOX: Define a Box or Image Subsection

Form: BOX box_num [NC=n] [NR=n] [N=n] [CR=n] [CC=n] [SR=n] [SC=n] [INT]
 $$
[CENT] [V=n]
box_num
(integer) is the number of the box being defined,
NC
defines the number of columns in the box,
NR
defines the number of rows in the box,
N
defines the number of rows and columns (square box),
CR
defines the center row,
CC
defines the center column,
SR
defines the starting row, and
SC
defines the starting column.
INT
lets you define the box interactively on the TV
CENT
toggles back and forth between origin and center based system
V=n
defines the center row and column using the VISTA variables Rn and Cn

VISTA can store the specifications for up to 20 boxes defining image sub-sections. These parameters can be used by other commands (such as TV, WINDOW and PRINT) by including 'BOX=' in the command line, modifying these commands so they operate only on the designated subsection.

When a box is initially defined, the size of the box in both dimensions center must be specified; use both the NR and NC keywords, or for the case of a square box, the N= keyword may also be used. If the origin or center is not given, the box is assumed to start at row 0 and column 0. You may change the origin and size of the box later by entering only the changes on the command line. All parameters not given on the command line are left unchanged.

By default, the VISTA boxes have fixed origins, so if you only change the box size, then the origin with be preserved. By using the CENT keyword, however, you can change this to a center based system, where the center of the box will be preserved. The CENT keyword acts as a toggle switch between the two modes - once it is set in one mode, it remains in that mode until explicitly changed by the user.

The INT command allows you to define boxes interactive on the video display. Follow the instructions given.

Examples:

BOX 1 NR=45 NC=56
defines box 1. Box 1 has origin at row 0 and column 0 and has 45 rows and 56 columns.
BOX 1 INT
defines box 1. The locations of the upper left and lower right corners are specified using the cursor on the TV.
BOX 1 SC=100 NC=100 SR=0 NR=100
defines box 1 as columns 100 to 199 and rows 0 to 99.
BOX 2 CC=100 CR=100 NR=13 NC=13
defines a box having 13 rows and columns, centered on row=100 and column=100.

Examples of changing the location of boxes. Suppose we have defined box 1 as in example 1 above.

BOX 1 SR=50
moves the box so that the starting row is row 50. The starting column, and the number of rows and columns is unchanged.
BOX 1 CC=50 CR=66
moves the box so that the center of the box is at row 50 and column 66. The size of the box is unchanged.

The locations of the defined boxes can be found with the PRINT BOXES command.

All spectra have start row 0 and 1 row. Thus, to define a box for use with spectra, use

You can display the boundaries of defined boxes on the television. See the command TVBOX.