next up previous
Next: TickAll - Draw tick marks on all edges of a Plot?
Up: AST Attribute Descriptions
Previous: TextLab(axis) - Draw descriptive axis labels for a Plot?

   
TextLabGap(axis) - Spacing of descriptive axis labels for a Plot

Description:
This attribute controls the appearance of an annotated coordinate grid (drawn with the astGrid function) by determining where descriptive axis labels are placed relative to the axes they describe. It takes a separate value for each physical axis of a Plot so that, for instance, the setting "TextLabGap(2)=0.01" specifies where the descriptive label for the second axis should be drawn.

For each axis, the TextLabGap value gives the spacing between the descriptive label and the edge of a box enclosing all other parts of the annotated grid (excluding other descriptive labels). The gap is measured to the nearest edge of the label (i.e. the top or the bottom). Positive values cause the descriptive label to be placed outside the bounding box, while negative values cause it to be placed inside.

The TextLabGap value should be given as a fraction of the minimum dimension of the plotting area, the default value being +0.01.

Type:
Floating point.

Class Applicability:
Plot
All Plots have this attribute.

Notes:
  • If drawn, descriptive labels are always placed at the edges of the plotting area, even although the corresponding numerical labels may be drawn along axis lines in the interior of the plotting area (see the Labelling attribute).
  • If no axis is specified, (e.g. "TextLabGap" instead of "TextLabGap(2)"), then a "set" or "clear" operation will affect the attribute value of all the Plot axes, while a "get" or "test" operation will use just the TextLabGap(1) value.



next up previous
Next: TickAll - Draw tick marks on all edges of a Plot?
Up: AST Attribute Descriptions
Previous: TextLab(axis) - Draw descriptive axis labels for a Plot?

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