next up previous
Next: astBorder - Draw a border around valid regions of a Plot
Up: AST Function Descriptions
Previous: astAxOffset - Add an increment onto a supplied axis value

astBegin - Begin a new AST context   

Description:
This macro invokes a function to begin a new AST context. Any Object pointers created within this context will be annulled when it is later ended using astEnd (just as if astAnnul had been invoked), unless they have first been exported using astExport or rendered exempt using astExempt. If annulling a pointer causes an Object's RefCount attribute to fall to zero (which happens when the last pointer to it is annulled), then the Object will be deleted.

Synopsis:
void astBegin

Class Applicability:
Object
This macro applies to all Objects.

Notes:
  • astBegin attempts to execute even if the AST error status is set on entry.
  • Contexts delimited by astBegin and astEnd may be nested to any depth.



next up previous
Next: astBorder - Draw a border around valid regions of a Plot
Up: AST Function Descriptions
Previous: astAxOffset - Add an increment onto a supplied axis value

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 211
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