- Form: CREATE buf [BOX=b] [SR=sr] [SC=sc] [NR=nr]
[NC=nc] [CONST=c] [N=n] [V=v] [HEADBUF=oldbuf]
-
- buf
- is the buffer holding the new image
- BOX=b
- create an image with the size and orientation of box 'b'
- SR=sr
- specify the start row of the new image
- SC=sc
- specify the start column
- CR=sr
- specify the center row of the new image
- CC=sc
- specify the center column
- NR=nr
- specify the number of rows
- NC=nc
- specify the number of columns
- N=n
- specifies number of rows and columns (square image)
- V=n
- loads center row and column for new image using
coordinates from VISTA variables Rn and Cn
- CONST=c
- fill the image pixels with value 'c'
- HEADBUF=oldbuf
- fill the new header with all cards from buffer 'oldbuf'
CREATE creates a new blank image, giving all the pixels in that image some
constant value (the default is 0.0). Any image that is in the buffer will
be destroyed. Use CONST=c to set the initial values of all of the pixels
to 'c'.
The BOX=b keyword is used to define the image size and location. This
makes the new image have the size and location of bux 'b'. See BOX for
instructions for defining boxes. You may also give the size and location of
the new image with the keywords SR, SC, NR, NC, or N. NR and NC, or N, are
required. If SR, SC , CR, and CC are not given, the default origin is
(0,0).
If you wish to have the header cards in the new buffer populated with cards
from an existing buffer (except for cards having to do with image size,
origin, etc.), use the HEADBUF=oldbuf keyword to copy cards from buffer
oldbuf.
Examples:
- CREATE 1 BOX=5
- creates an image in buffer 1 having
the size and orientation of box 5. the image is filled with zeroes.
- CREATE 1 BOX=5 CONST=100.0
- does the same as the first example,
but fills the image with value 100.0
- CREATE 5 SR=5 SC=10 NR=25 NC=35
- creates an image in buffer 5.
The start (row, column) is (5,10) and the size of the image is 25 rows by
35 columns.
- CREATE 1 N=100
- creates an 100 by 100 image in buffer 1.
The start row and column are both 0.