Draw a text string for a Plot astText
"
up"
direction of
the text (in graphical coordinates). For example, to get horizontal text, the vector
{0.0f,1.0f} 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 astClip), 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).