next up previous 264
Next: astBorder - Draw a border around valid regions of a Plot
Up: AST Function Descriptions
Previous: astBBuf - Begin a new graphical buffering context


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 264
Next: astBorder - Draw a border around valid regions of a Plot
Up: AST Function Descriptions
Previous: astBBuf - Begin a new graphical buffering context

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

Copyright (C) 2009 Science \& Technology Facilities Council