AST_GRFPUSH

Save the current graphics functions used by a Plot

Description:

This routine takes a snapshot of the graphics functions which are currently registered with the supplied Plot, and saves the snapshot on a first-in-last-out stack within the Plot. The snapshot can be restored later using function AST_GRFPOP.

The AST_GRFPUSH and AST_GRFPOP functions are intended for situations where it is necessary to make temporary changes to the graphics functions used by the Plot. The current functions should first be saved by calling AST_GRFPUSH. New functions should then be registered using AST_GRFSET. The required graphics should then be produced. Finally, AST_GRFPOP should be called to restore the original graphics functions.

Invocation

CALL AST_GRFPUSH( THIS STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the Plot.
STATUS = INTEGER (Given and Returned)
The global status.