KPG1_GDPUT

Saves an AST Plot with a graphics-database picture

Description:

This routine saves the supplied AST Plot (see SUN/210) in the AGI database (see SUN/48) within the MORE structure of the specified picture. It can be retrieved if necessary using KPG1_GDGET (see the prologue of KPG1_GDGET for more information about using these two routines).

If the supplied Plot contains a " AGI Data" Frame with the Domain given by DDOM in which the axes are scaled and shifted versions of the axes of the AGI world co-ordinate Frame (specified by argument WDOM), then a TRANSFORM structure defining AGI Data co-ordinates is stored with the DATA picture. This is purely for the benefit of non-AST based applications which may use AGI Data co-ordinates (AST-based applications should always use the Plot stored with the picture in preference to the TRANSFORM structure stored in the AGI database).

Any Frames that are Regions and have a Domain beginning with " ROI" are deleted from the Plot before saving it. Also, any Frames that have an Ident value beginning with " ROI" are also deleted from the Frame (these may be added by KPG1_ASGET).

Invocation

CALL KPG1_GDPUT( IPIC, WDOM, DDOM, IPLOT, STATUS )

Arguments

IPIC = INTEGER (Given)
The AGI identifier for the picture. A value of -1 causes the Plot to be stored with the current picture.
WDOM = CHARACTER ( ) (Given)
Domain name of the co-ordinate Frame within IPLOT corresponding to AGI world co-ordinates. " AGI_WORLD" is used if a blank value is supplied.
DDOM = CHARACTER ( ) (Given)
Domain name of the co-ordinate Frame within IPLOT corresponding to AGI data co-ordinates. " AXIS" is used if a blank value is supplied.
IPLOT = INTEGER (Given)
An AST pointer to the Plot to be stored with the picture. If AST__NULL is supplied, any existing Plot stored with the picture is deleted.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: