#### 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 a reference point specified by the TextGapType attribute (by default, 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 depends on the value of attribute TextGapType: if TextGapType is `"` box`"` , the default is +0.01, otherwise the default is +0.07.

Type:

  Floating point.

#### 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.

Copyright (C) 2021 East Asian Observatory