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

NAME

6       plmtex - Write text relative to viewport boundaries
7

SYNOPSIS

9       plmtex(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:  General: plmtex(side, disp, pos, just, text) Perl/PDL:
21       plmtex(disp, pos, just, side, text)
22
23
24       This function is used in examples 3,4,6-8,11,12,14,18,23,26.
25

ARGUMENTS

27       side (const char *, input)
28              Specifies the side of the viewport along which the text is to be
29              written.  The string must be one of: b: Bottom of viewport, text
30              written parallel to edge.  bv: Bottom of viewport, text  written
31              at right angles to edge.  l: Left of viewport, text written par‐
32              allel to edge.  lv: Left of  viewport,  text  written  at  right
33              angles  to edge.  r: Right of viewport, text written parallel to
34              edge.  rv: Right of viewport, text written at  right  angles  to
35              edge.   t:  Top of viewport, text written parallel to edge.  tv:
36              Top of viewport, text written at right angles to edge.
37
38
39       disp (PLFLT, input)
40              Position of the reference point  of  string,  measured  outwards
41              from the specified viewport edge in units of the current charac‐
42              ter height.  Use negative disp to write within the viewport.
43
44       pos (PLFLT, input)
45              Position of the reference point of string  along  the  specified
46              edge, expressed as a fraction of the length of the edge.
47
48       just (PLFLT, input)
49              Specifies  the  position of the string relative to its reference
50              point.  If just=0., the reference point is at the  left  and  if
51              just=1., it is at the right of the string.  Other values of just
52              give intermediate justifications.
53
54       text (const char *, input)
55              The string to be written out.
56
57

AUTHORS

59       Geoffrey Furnish and Maurice LeBrun wrote and  maintain  PLplot.   This
60       man  page  was  automatically  generated from the DocBook source of the
61       PLplot  documentation,  maintained  by  Alan  W.   Irwin   and   Rafael
62       Laboissiere.
63

SEE ALSO

65       PLplot documentation at http://plplot.sourceforge.net/resources.
66
67
68
69                                  July, 2010                   PLMTEX(3plplot)
Impressum