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 boundaries.  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 character 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

       Many  developers  (who  are  credited  at  http://plplot.sourceforge.net/credits.php) have
       contributed to PLplot over its long history.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/documentation.php.

                                          February, 2014                         PLMTEX3(3plplot)