IMG_TMP[n][x]
Create a temporary image
Description:
This subroutine creates a temporary
image for use as workspace and returns a pointer to its data. The image will be deleted automatically
when it is freed later (e.g. by calling
IMG_FREE).
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_TMP3I.
Invocation
CALL IMG_TMP( PARAM, NX, NY, IP, STATUS
)
CALL IMG_TMP1[x]( PARAM, NX, IP, STATUS )
CALL IMG_TMP2[x]( PARAM, NX, NY, IP, STATUS )
CALL IMG_TMP3[x]( PARAM, NX, NY, NZ, IP, STATUS )
Arguments
PARAM = CHARACTER
(
)
(Given)
Parameter name (case insensitive).
NX = INTEGER (Given)
First dimension of the image
(in pixels).
NY = INTEGER (Given)
Second dimension of the image (in pixels).
NZ = INTEGER
(Given)
Third dimension of the image (in pixels).
IP = INTEGER (Returned)
Pointer to the
image data.
STATUS = INTEGER (Given and Returned)
The global status.
Notes:
-
It is possible to create more than one temporary image per call using multiple parameter
names. These are specified by supplying a comma separated list of names (i.e. ’WORK1,
WORK2, WORK3’). A pointer to the data of each image is then returned (in this case the IP
argument should be passed as an array of size at least the number of parameter names).
B.2 HDR Fortran subroutines
Copyright © 2000-2003 Council for the Central Laboratory of the Research Councils