


PLMTEX3(3)                  PLplot API                 PLMTEX3(3)


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

SYNOPSIS
       plmtex3(side, disp, pos, just, text)

DESCRIPTION
       Writes  text  at  a  specified position relative to the viewport bound-
       aries.  Text may be written inside or  outside  the  viewport,  but  is
       clipped  at  the  subpage  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 just, and the position of the reference point relative to
       the viewport is set by disp and pos.

       Redacted form: plmtex3(side, disp, pos, just, text)

       This function is used in example 28.

ARGUMENTS
       side (const char *, input)
              Specifies the side of the viewport along which the text is to be
              written. The string should contain one or more of the  following
              characters:  [xyz][ps][v].   Only  one label is drawn at a time,
              i.e. xyp will only label the X axis, not both the X and Y  axes.
              x: Label the X axis.  y: Label the Y axis.  z: Label the Z axis.
              p: Label the primary axis. For Z this is the  leftmost  Z  axis.
              For  X it is the axis that starts at y-min. For Y it is the axis
              that starts at x-min.  s: Label the secondary axis.  v: Draw the
              text perpendicular to the axis.


       disp (PLFLT, input)
              Position  of  the  reference  point of string, measured outwards
              from the specified viewport edge in units of the current charac-
              ter height.  Use negative disp to write within the viewport.

       pos (PLFLT, input)
              Position  of  the  reference point of string along the specified
              edge, expressed as a fraction of the length of the edge.

       just (PLFLT, input)
              Specifies the position of the string relative to  its  reference
              point.   If  just=0.,  the reference point is at the left and if
              just=1., it is at the right of the string.  Other values of just
              give intermediate justifications.

       text (const char *, input)
              The string to be written out.


AUTHORS
       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This
       man page was automatically generated from the  DocBook  source  of  the



                          November, 2007                        1





PLMTEX3(3)                  PLplot API                 PLMTEX3(3)


       PLplot   documentation,   maintained   by  Alan  W.  Irwin  and  Rafael
       Laboissiere.

SEE ALSO
       PLplot documentation at http://plplot.sourceforge.net/resources.




















































                          November, 2007                        2


