This subroutine creates a new output image by duplicating an input image. A pointer is returned to the output image data.

The [x] part of the name is optional. If used [x] indicates the data type (one of R, D, I, W, UW, B or UB, the default is R). So for instance if you wanted to make an output image with type REAL, the subroutine which you should call would be IMG_OUT.

CALL IMG_OUT[x]( PARAM1, PARAM2, IP, STATUS )

PARAM1 = CHARACTER $\ast$ ( $\ast$ ) (Given)

PARAM2 = CHARACTER $\ast$ ( $\ast$ ) (Given)

IP = INTEGER (Returned)

STATUS = INTEGER (Given and Returned)

• It is possible to copy the input image to more than one output image using multiple parameter names. Multiple parameter names are specified by supplying a comma separated list of names (i.e. ’OUT1,OUT2’). A pointer to the data of each image is then returned (in this case the IP argument must be passed as an array of size at least the number of parameter names). The advantage of using this method is that multiple copies of an input image can be made using a single invocation of this subroutine. Multiple input image names are not allowed.

• The input image must have already been associated with a parameter before calling this subroutine.

• The output image is created with the storage data type of the input image and is then accessed in the type that you ask for ("[x]"). This may occasionally cause problems if these two types differ. This arises because when the output image is converted to and from its storage type it is not always possible to guarantee that a valid value will result (for instance many numbers that you may store in a REAL variable cannot be stored in an INTEGER variable). When an image element cannot be converted it is assigned the appropriate bad value.