CREATE: Create a Blank Image

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.