plmtex3
( | side , |
disp , | |
pos , | |
just , | |
text
) ; |
Writes text at a specified position relative to the viewport
boundaries. Text may be written inside or outside the viewport, but
is clipped at the subpage boundaries. The reference point of a
string lies along a line passing through the string at half the
height of a capital letter. The position of the reference point
along this line is determined by
, and the position of
the reference point relative to the viewport is set by
just
and
disp
.
pos
side
(PLCHAR_VECTOR
, input)
An ascii character string specifying the
side of the viewport along which the text is to
be written. The string should contain one or more of the
following characters: [xyz][ps][v]
.
Only one label is drawn at a time, i.e. xyp
will only label the X axis, not both the X and Y axes.
x
: Label the X axis.
y
: Label the Y axis.
z
: Label the Z axis.
p
: Label the “primary”
axis. For Z this is the leftmost Z axis. For X it is
the axis that starts at y-min. For Y it is the axis that
starts at x-min.
s
: Label the “secondary”
axis.
v
: Draw the text perpendicular to the
axis.
disp
(PLFLT
, input)
Position of the reference point of string, measured outwards
from the specified viewport edge in units of the current
character height. Use negative
to write within
the viewport.
disp
pos
(PLFLT
, input)
Position of the reference point of string along the specified edge, expressed as a fraction of the length of the edge.
just
(PLFLT
, input)
Specifies the position of the string relative to its reference
point. If
,
the reference point is at the left and if
just
=0.
, it is at the
right of the string. Other values of
just
=1.
give
intermediate justifications.
just
text
(PLCHAR_VECTOR
, input)
A UTF-8 character string to be written out.
Redacted form: plmtex3(side, disp, pos, just, text)
This function is used in example 28.