Draw a text string for a Plot
"
up"
direction of the text (in
graphical coordinates). For example, to get horizontal text, the vector [0.0,1.0] should be supplied. For
a basic Plot, 2 values should be supplied. For a Plot3D, 3 values should be supplied, and
the actual up vector used is the projection of the supplied up vector onto the text plane
specified by the current value of the Plot3D’
s Norm attribute. "
up"
direction and may be "
B"
(baseline), "
C"
(centre), "
T"
(top) or "
M"
(bottom). The second character identifies the side-to-side reference position
and may be "
L"
(left), "
C"
(centre) or "
R"
(right ). The string is case-insensitive, and only the first
two characters are significant.
For example, a value of "
BL"
means that the left end of the baseline of the original (un-rotated) text is
to be drawn at the position given by POS.
The Plot3D class currently does not interpret graphical escape sequences contained within text displayed using this method.
Text is not drawn at positions which have any coordinate equal to the value AST__BAD (or where the transformation into graphical coordinates yields coordinates containing the value AST__BAD).
If the plotting position is clipped (see AST_CLIP), then no text is drawn.
An error results if the base Frame of the Plot is not 2-dimensional or (for a Plot3D) 3-dimensional.
An error also results if the transformation between the current and base Frames of the Plot is not
defined (i.e. the Plot’
s TranInverse attribute is zero).