next up previous 231
Next: IMG_OUT[x]- Create an output image
Up: IMG Fortran subroutines
Previous: IMG_NAME - Return the image name


IMG_NEW[n][x]- Create a new image

Description:
This subroutine creates a new image and returns a pointer to its data.

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.


Invocation:



CALL IMG_NEW( PARAM, NX, NY, IP, STATUS )
CALL IMG_NEW1[x]( PARAM, NX, IP, STATUS )
CALL IMG_NEW2[x]( PARAM, NX, NY, IP, STATUS )
CALL IMG_NEW3[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:



next up previous 231
Next: IMG_OUT[x]- Create an output image
Up: IMG Fortran subroutines
Previous: IMG_NAME - Return the image name

IMG Simple Image Data Access
Starlink User Note 160
P.W. Draper
R.F. Warren-Smith
3 March 2003
E-mail:P.W.Draper@durham.ac.uk

Copyright © 2000-2003 Council for the Central Laboratory of the Research Councils