Next: IMG_DELET- Delete an image
Up: IMG Fortran subroutines
Previous: IMG Fortran subroutines
IMG_CANCL- Cancel an image/parameter association
- Description:
- This subroutine may be used to free the resources associated with
an image. Its behaviour is similar to that of
IMG_FREE, except
that it also removes the association between an image and a
parameter. If the same parameter is later used to access an
image, then a new image will be obtained (whereas if
IMG_FREE is used the original image will be re-accessed).
- Invocation:
- CALL IMG_CANCL( PARAM, STATUS )
- Arguments:
-
-
PARAM = CHARACTER * ( * ) (Given)
-
Parameter name, specifying either the individual
image/parameter association to be cancelled, or '*',
indicating that all such associations should be cancelled.
-
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 cancel more than one association 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_DELET- Delete an image
Up: IMG Fortran subroutines
Previous: IMG Fortran subroutines
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