1PLPTEX3(3plplot)                  PLplot API                  PLPTEX3(3plplot)
2
3
4

NAME

6       plptex3 - Write text inside the viewport of a 3D plot
7

SYNOPSIS

9       plptex3(wx, wy, wz, dx, dy, dz, sx, sy, sz, just, text)
10

DESCRIPTION

12       Writes  text  at a specified position and inclination and with a speci‐
13       fied shear within the viewport.  Text is clipped at the viewport bound‐
14       aries.   The  reference  point  of  a  string lies along a line passing
15       through the string at half the height of a capital letter.   The  posi‐
16       tion  of the reference point along this line is determined by just, and
17       the reference point is placed at world coordinates (wx, wy, wz)  within
18       the  viewport.  The inclination and shear of the string is specified in
19       terms of differences of world coordinates making it easy to write  text
20       parallel to a line in a graph.
21
22       Redacted form: plptex3(x, y, z, dx, dy, dz, sx, sy, sz, just, text)
23
24       This function is used in example 28.
25

ARGUMENTS

27       wx (PLFLT(3plplot), input)
28              x world coordinate of reference point of string.
29
30       wy (PLFLT(3plplot), input)
31              y world coordinate of reference point of string.
32
33       wz (PLFLT(3plplot), input)
34              z world coordinate of reference point of string.
35
36       dx (PLFLT(3plplot), input)
37              Together  with dy and dz , this specifies the inclination of the
38              string.  The baseline of the string is parallel to a line  join‐
39              ing (x, y, z)  to (x+dx, y+dy, z+dz) .
40
41       dy (PLFLT(3plplot), input)
42              Together  with  dx and dz, this specifies the inclination of the
43              string.
44
45       dz (PLFLT(3plplot), input)
46              Together with dx and dy, this specifies the inclination  of  the
47              string.
48
49       sx (PLFLT(3plplot), input)
50              Together  with  sy  and  sz  ,  this  specifies the shear of the
51              string.  The string is sheared so that the characters are verti‐
52              cally  parallel  to  a  line  joining (x, y, z)  to (x+sx, y+sy,
53              z+sz) . If sx = sy = sz = 0.)  then the text is not sheared.
54
55       sy (PLFLT(3plplot), input)
56              Together with sx and sz, this specifies shear of the string.
57
58       sz (PLFLT(3plplot), input)
59              Together with sx and sy, this specifies shear of the string.
60
61       just (PLFLT(3plplot), input)
62              Specifies the position of the string relative to  its  reference
63              point.   If  just=0. , the reference point is at the left and if
64              just=1. , it is at the right of the  string.   Other  values  of
65              just give intermediate justifications.
66
67       text (PLCHAR_VECTOR(3plplot), input)
68              A UTF-8 character string to be written out.
69
70

AUTHORS

72       Many  developers  (who  are  credited at http://plplot.org/credits.php)
73       have contributed to PLplot over its long history.
74

SEE ALSO

76       PLplot documentation at http://plplot.org/documentation.php.
77
78
79
80                                February, 2022                PLPTEX3(3plplot)
Impressum