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

NAME

6       plmtex3 - Write text relative to viewport boundaries in 3D plots.
7

SYNOPSIS

9       plmtex3(side, disp, pos, just, text)
10

DESCRIPTION

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

ARGUMENTS

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

AUTHORS

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

SEE ALSO

63       PLplot documentation at http://plplot.sourceforge.net/resources.
64
65
66
67                                  July, 2010                  PLMTEX3(3plplot)
Impressum