next up previous
Next: AST_GRFSET - Register a graphics routine for use by a Plot
Up: AST Routine Descriptions
Previous: AST_GRFPOP - Restore previously saved graphics functions used by a Plot

   
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.



next up previous
Next: AST_GRFSET - Register a graphics routine for use by a Plot
Up: AST Routine Descriptions
Previous: AST_GRFPOP - Restore previously saved graphics functions used by a Plot

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
30th April 2003
E-mail:ussc@star.rl.ac.uk

Copyright (C) 2003 Central Laboratory of the Research Councils