trusty (3) plmtex3.3plplot.gz

Provided by: plplot-doc_5.10.0-0ubuntu5_all bug

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)