KPG1_ASGRD - Draws a border or an annotated co-ordinate grid over an AST Plot

Description:

This routine call AST_BORDER to draw a border, or AST_GRID to draw an annotated co-ordinate Grid over the supplied Plot. The current pgplot viewport can optionally be extended prior to drawing the grid so that it covers a specified AGI picture. If the pgplot viewport is left matching the plotting area supplied when the Plot was created, then certain component of the grid (i.e. exterior tick marks), are clipped by pgplot. To avoid this, IPIC should normally be given as the AGI identifier for the FRAME picture containing the plot.

Invocation:

CALL KPG1_ASGRD( IPLOT, IPIC, GRID, STATUS )

Arguments:

IPLOT = INTEGER (Given)

An AST pointer to the Plot.

IPIC = INTEGER (Given)

An AGI identifier for the FRAME picture. Supply this as -1 if the current pgplot viewport is not to be changed.

GRID = LOGICAL (Read)

Draw a grid using AST_GRID? If .FALSE. then a border only is drawn (using AST_BORDER).

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

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