MASKTOIM: Create an Image Showing Masked Pixels

Form: MASKTOIM buf [BOX=b] [SR=sr] [SC=sc] [NR=nr] [NC=nc]
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
NR=nr
specify the number of rows
NC=nc
specify the number of columns
MASKTOIM creates an image, showing which pixels are masked. Masked pixels are set to 0 in the image, while unmasked pixels are set to 1.

Use BOX=b to define the image size and location. This makes the new image have the size and location of box '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, and NC. NR and NC are required. If SR or SC are not given, they default to zero.

Any image already in the destination buffer is destroyed.

Examples:

MASKTOIM 1 BOX=5
creates an image in buffer 1 having the size and orientation of box 5. The image is filled with zeroes.

MASKTOIM 1 BOX=5 CONST=100.0
does the same as the first example, but fills the image with value 100.0

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

MASKTOIM 1 NR=100 NC=100
creates an 100 by 100 image in buffer 1. The start row and column are both 0.