Opens the graphics device and see if there is an existing DATA picture with which
the new DATA picture could be aligned KPG1_PLOTA
Various environment parameters are used to obtain options, etc. The names of these parameters are hard-wired into this subroutine in order to ensure conformity between applications.
"
AGI world co-ordinates are PIXEL co-ordinates"
. This
information is provided through a FrameSet (IWCS) and a Domain name (DOMAIN).
DOMAIN specifies the Domain in which AGI world co-ordinates are assumed to live. A
FrameSet may then be supplied using argument IWCS containing a Frame with the same
Domain which will be used to describe AGI world co-ordinates in the returned Plot (a default
two-dimensional Frame with the specified Domain is used if no FrameSet is supplied or if it does
not contain a Frame with the specified Domain). If DOMAIN is supplied Blank, a default
two-dimensional Frame with Domain AGI_WORLD will be used to describe AGI world
co-ordinates.
If the existing DATA picture was created by an AST application, it will have a Plot stored with it which means that AGI world co-ordinates will be ignored. Consequently, the values supplied for IWCS and DOMAIN will also be ignored.
"
NEW"
– no attempt is made to align the new DATA picture with an existing DATA picture, even if
the CLEAR parameter is given a FALSE value.
"
OLD"
– the new DATA picture is always aligned with an existing DATA picture. The CLEAR
parameter is not accessed (it is assumed to have a FALSE value) and an error is reported if no DATA
picture is available.
"
UNKNOWN"
– If CLEAR is given a FALSE value then the new DATA picture is aligned with any
existing DATA picture, but no error is reported if no DATA picture exists.
"
AGI_WORLD"
will be used. See description of argument IWCS above
for more details. Close down AGI and PGPLOT using KPG1_PGCLS.