Next: IMG_IN[n][x]- Access an existing image for reading
Up: IMG Fortran subroutines
Previous: IMG_DELET- Delete an image
IMG_FREE- Free an image
- Description:
- This subroutine should be used to free the resources associated
with an image when it has been finished with. This should
always be done before the end of a program.
- Invocation:
- CALL IMG_FREE( PARAM, STATUS )
- Arguments:
-
-
PARAM = CHARACTER * ( * ) (Given)
-
Parameter name, specifying either the individual image to be
freed or '*', indicating that all images should be
freed.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
- This subroutine attempts to execute even if STATUS is set on entry,
although no further error report will be made if it subsequently
fails under these circumstances.
- It is possible to free more than one image per call using
multiple parameter names. Multiple parameter names are
specified using a comma separated list of names (i.e.
'IMAGE1,IMAGE2'), or by using "wild-card"
characters as part of a parameter name. In this context, a
'*' will match any set of characters, while
'%' will match any single character. Note that
only those parameter names previously used to access images
via IMG subroutines are considered as potential matches.
- Identifiers obtained using
IMG_INDF are not released by this routine.
Next: IMG_IN[n][x]- Access an existing image for reading
Up: IMG Fortran subroutines
Previous: IMG_DELET- Delete an image
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