- 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.