TEXT
Default value: CURSOR = 1
CURSOR controls the justification of the text strings. The origin of the
text string is always the lower left corner of the string. The justific-
ation determines where this origin is placed with respect to a reference
point.
CURSOR <= 0 XLOC and YLOC are used to determine the reference point
CURSOR > 0 graphics cursor is used to determine the reference point
-1 = LL -2 = LC -3 = LR -4 = LU -5 = LD -6 = CV
-7 = CL -8 = UL -9 = CC -10 = UC -11 = CR -12 = UR
The value of CURSOR will be updated to the value corresponding to the
justification that was chosen. The values of %XLOC and %YLOC will also
be updated to the crosshair position that was chosen.
Default value: TXTANG = 0.0
TXTANG is the angle, in degrees, measured counterclockwise, between the
base line of the text string and a horizontal line. The value of TXTANG
will be ignored if CURSOR = -4, -5, or -6.
Default value: %TXTHIT = 3.0
TXTHIT controls the text height. There are two forms:
TXTHIT -- is in world coordinate units
%TXTHIT -- is expressed as a percentage of the height of the window,
that is, TXTHIT = %TXTHIT*(YUWIND-YLWIND)/100.
Default value: %XLOC = 50.0
XLOC is the horizontal reference position of a text string. This reference
point is used for justification. XLOC will be used if CURSOR < 0, or if
the X key is typed when drawing text in interactive mode. The value of
%XLOC is updated after each TEXT command. There are two forms:
XLOC -- is in world coordinate units
%XLOC -- is expressed as a percentage of the width of the window,
that is, XLOC = XLWIND+%XLOC*(XUWIND-XLWIND)/100.
Default value: %YLOC = 50.0
YLOC is the vertical reference position of a text string. This reference
point is used for justification. YLOC will be used if CURSOR < 0, or if
the Y key is typed when drawing text in interactive mode. The value of
%YLOC is updated after each TEXT command. There are two forms:
YLOC -- is in world coordinate units
%YLOC -- is expressed as a percentage of the height of the window,
that is, YLOC = YLWIND+%YLOC*(YUWIND-YLWIND)/100.
If the TEXT command is entered interactively, the default is to ask for
confirmation whether the drawn text is OK. If you answer NO, the text
will not appear on any hardcopies, or in an EDGR file. The text is not
drawn into the plot file(s) until confirmed. If the \NOCONFIRM qualifier
is used, this confirmation is not requested, and the text is drawn into
the plot file(s) immediately. The default is \CONFIRM.
When the TEXT command is encountered in a command macro file, no
confirmation is requested, even if \CONFIRM is used.
The values of scalar variables can be drawn by use of the RCHAR function
and the append operator. For example:
TEXT `The value of A is '//RCHAR(A)
TEXT `The value of X['//RCHAR(J)//`] = '//RCHAR(X[J])
A format for the scalar can be entered as the optional second argument
of the RCHAR function. For example:
FRMT = `E12.5'
TEXT `X['//RCHAR(J)//`] = '//RCHAR(X[J],FRMT)
The character string may contain format commands and special characters
which are included inside the character string, and must be bracketed by
the command delimiters, < and >. The special characters include all
of the greek letters as well as some math symbols and other symbols.
The names for the special characters can be seen by entering the
command DISPLAY SPECIAL and are described in the Low Level Graphics
and Graph Plotting document.
bolding <Bn>
colour <Cn>
font <Ffontname>
height <Hnn.n> or <Hnn.n%>
sub-scripts <_>
super-scripts <^>
emphasis <em>
plotting character <Mn>
hexadecimal input <X>
vertical spacing <Vnn.n> or <Vnn.n%>
horizontal spacing <Znn.n> or <Znn.n%>
When <NOD> is included in a character string, the bolding, colour, font,
emphasis and hexadecimal mode will be left in their current state.
This is a way of changing the defaults for these characteristics.
When <DEF> is included in a character string, at the end of processing
that string, bolding will be turned off, the colour will be reset to
the colour chosen by the COLOUR command, the font will be reset to
the font chosen by the SET FONT command, emphasis mode will be turned
off, and hexadecimal mode will be turned off. This is the default
action, so it is not necessary to include <DEF> in a character string.
It has been included for completeness.
When text strings are added to a graph, they will be replotted, along
with any data curves, with the REPLOT command. The default is to
store the text locations in world coordinates. If you want the text
locations to be recorded in graph units, use the \GRAPH qualifier. In
this case, the text will be replotted in the same location in terms of
the graph, so that if you label a curve, the label will follow the curve
on the new graph scales. However, the height of the text will be
increased or decreased proportionally. To restore the text height
after a REPLOT, you can get, using the GET command, the value of
%TXTHIT before REPLOT and re-set %TXTHIT after the REPLOT, using the
SET command.
The DATE function returns the current date as a character string. The
TIME function returns the current time as a character string. For
example: =DATE
` 2-DEC-1994'
=TIME
`11:58:16'
Text can only be erased from the monitor screen and from a bitmap. Erasing
will NOT work with other hardcopies and it will NOT work with EDGR files.
If the \ERASE qualifier is used, the last text string drawn will be erased.
If the TEXT\ERASE command is issued again, the next to last text string
drawn will be erased. And so on. If the \NOCONFIRM qualifier is used, no
confirmation will be requested. If the \CONFIRM qualifier is used, the
string to be erased will be displayed on the screen, and you will be asked
if this is the string to be erased. If the answer is NO, then the next
string in reverse order of drawing is displayed, and so on. The default is
\CONFIRM.