next up previous
Next: AST_BOUNDINGBOX - Return a bounding box for previously drawn graphics
Up: AST Routine Descriptions
Previous: AST_BEGIN - Begin a new AST context

   
AST_BORDER - Draw a border around valid regions of a Plot

Description:
This function draws a (line) border around regions of the plotting area of a Plot which correspond to valid, unclipped physical coordinates. For example, when plotting using an all-sky map projection, this function could be used to draw the boundary of the celestial sphere when it is projected on to the plotting surface.

If the entire plotting area contains valid, unclipped physical coordinates, then the boundary will just be a rectangular box around the edges of the plotting area.

Invocation:
RESULT = AST_BORDER( THIS, STATUS )

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

Returned Value:
AST_BORDER = LOGICAL
.FALSE. is returned if the plotting area is completely filled by valid, unclipped physical coordinates (so that only a rectangular box was drawn around the edge). Otherwise, .TRUE. is returned.

Notes:
  • A value of .FALSE. will be returned if this function is invoked with STATUS set to an error value, or if it should fail for any reason.
  • An error results if either the current Frame or the base Frame of the Plot is not 2-dimensional.
  • An error also results if the transformation between the base and current Frames of the Plot is not defined (i.e. the Plot's TranForward attribute is zero).



next up previous
Next: AST_BOUNDINGBOX - Return a bounding box for previously drawn graphics
Up: AST Routine Descriptions
Previous: AST_BEGIN - Begin a new AST context

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