The [n] and [x] parts of the name are optional. If used [n] indicates the number of dimensions of the data (1 to 3, the default is 2) and [x] the data type (one of R, D, I, W, UW, B or UB, the default is R). So for instance if you wanted to use 3-D data with a data type of INTEGER, the subroutine that you should call is IMG_NEW3I.

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

NX = INTEGER (Given)

NY = INTEGER (Given)

NZ = INTEGER (Given)

IP = INTEGER (Returned)

STATUS = INTEGER (Given and Returned)

• It is possible to create more than one image per call using multiple parameter names. Multiple names are specified by supplying a comma separated list (i.e. ’NEW1,NEW2’). 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). An advantage of this method is that multiple images can be made using a single invocation of this subroutine.