plptex3
( | wx , |
wy , | |
wz , | |
dx , | |
dy , | |
dz , | |
sx , | |
sy , | |
sz , | |
just , | |
text
) ; |
Writes text at a specified position and inclination and with a
specified shear within the viewport. Text is clipped at the viewport
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 reference
point is placed at world coordinates
just
(
within the viewport. The
inclination and shear of the string is specified in terms of
differences of world coordinates making it easy to write text parallel
to a line in a graph.
wx
, wy
,
wz
)
wx
(PLFLT
, input)
x world coordinate of reference point of string.
wy
(PLFLT
, input)
y world coordinate of reference point of string.
wz
(PLFLT
, input)
z world coordinate of reference point of string.
dx
(PLFLT
, input)
Together with
, this specifies the inclination of
the string. The baseline of the string is parallel to a line
joining dy
and
dz
(
to x
, y
,
z
)
(
.
x
+dx
,
y
+dy
,
z
+dz
)
dy
(PLFLT
, input)
Together with
,
this specifies the inclination of the string.
dx
and
dz
dz
(PLFLT
, input)
Together with
,
this specifies the inclination of the string.
dx
and
dy
sx
(PLFLT
, input)
Together with
, this specifies the shear of
the string. The string is sheared so that the characters are
vertically parallel to a line joining sy
and
sz
(
to x
, y
,
z
)
(
.
If x
+sx
,
y
+sy
,
z
+sz
)
then the text is not
sheared.
sx
= sy
= sz
= 0.)
sy
(PLFLT
, input)
Together with
,
this specifies shear of the string.
sx
and
sz
sz
(PLFLT
, input)
Together with
,
this specifies shear of the string.
sx
and
sy
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:
plptex3(x, y, z, dx, dy, dz, sx, sy, sz,
just, text)
This function is used in example 28.