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:

• The Base (GRAPHICS) Frame in the Plot should represent millimetres from the bottom left corner of the view surface.

• An error is reported if the Plot contains any Frames which have the Domain AGI_DATA.

• The PGPLOT interface to the AGI library should be opened before calling this routine.

• The Plot is stored in a component of the MORE structure named "AST_PLOT" and with type "WCS".