1PLMTEX3(3plplot) PLplot API PLMTEX3(3plplot)
2
3
4
6 plmtex3 - Write text relative to viewport boundaries in 3D plots.
7
9 plmtex3(side, disp, pos, just, text)
10
12 Writes text at a specified position relative to the viewport bound‐
13 aries. Text may be written inside or outside the viewport, but is
14 clipped at the subpage boundaries. The reference point of a string
15 lies along a line passing through the string at half the height of a
16 capital letter. The position of the reference point along this line is
17 determined by just, and the position of the reference point relative to
18 the viewport is set by disp and pos.
19
20 Redacted form: plmtex3(side, disp, pos, just, text)
21
22 This function is used in example 28.
23
25 side (const char *, input)
26 Specifies the side of the viewport along which the text is to be
27 written. The string should contain one or more of the following
28 characters: [xyz][ps][v]. Only one label is drawn at a time,
29 i.e. xyp will only label the X axis, not both the X and Y axes.
30 x: Label the X axis. y: Label the Y axis. z: Label the Z axis.
31 p: Label the primary axis. For Z this is the leftmost Z axis.
32 For X it is the axis that starts at y-min. For Y it is the axis
33 that starts at x-min. s: Label the secondary axis. v: Draw the
34 text perpendicular to the axis.
35
36
37 disp (PLFLT, input)
38 Position of the reference point of string, measured outwards
39 from the specified viewport edge in units of the current charac‐
40 ter height. Use negative disp to write within the viewport.
41
42 pos (PLFLT, input)
43 Position of the reference point of string along the specified
44 edge, expressed as a fraction of the length of the edge.
45
46 just (PLFLT, input)
47 Specifies the position of the string relative to its reference
48 point. If just=0., the reference point is at the left and if
49 just=1., it is at the right of the string. Other values of just
50 give intermediate justifications.
51
52 text (const char *, input)
53 The string to be written out.
54
55
57 Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This
58 man page was automatically generated from the DocBook source of the
59 PLplot documentation, maintained by Alan W. Irwin and Rafael
60 Laboissiere.
61
63 PLplot documentation at http://plplot.sourceforge.net/resources.
64
65
66
67 July, 2010 PLMTEX3(3plplot)