


PLPTEX3(3)                  PLplot API                 PLPTEX3(3)


NAME
       plptex3 - Write text inside the viewport of a 3D plot.

SYNOPSIS
       plptex3(x, y, z, dx, dy, dz, sx, sy, sz, just, text)

DESCRIPTION
       Writes  text  at a specified position and inclination and with a speci-
       fied shear within the viewport.  Text is clipped at the viewport bound-
       aries.   The  reference  point  of  a  string lies along a line passing
       through the string at half the height of a capital letter.   The  posi-
       tion  of the reference point along this line is determined by just, and
       the reference point is placed at world coordinates (x, y, z) within the
       viewport. The inclination and shear of the string is specified in terms
       of differences of world coordinates making it easy to write text paral-
       lel to a line in a graph.

       Redacted form: plptex3(x, y, z, dx, dy, dz, sx, sy, sz,  just, text)

       This function is used in example 28.

ARGUMENTS
       x (PLFLT, input)
              x coordinate of reference point of string.

       y (PLFLT, input)
              y coordinate of reference point of string.

       z (PLFLT, input)
              z coordinate of reference point of string.

       dx (PLFLT, input)
              Together  with dy and dz, this specifies the inclination of  the
              string.  The baseline of the string is parallel to a line  join-
              ing (x, y, z) to (x+dx, y+dy, z+dz).

       dy (PLFLT, input)
              Together  with  dx and dz, this specifies the inclination of the
              string.

       dz (PLFLT, input)
              Together with dx and dy, this specifies the inclination  of  the
              string.

       sx (PLFLT, input)
              Together  with  sy  and  sz,  this  specifies  the shear of  the
              string.  The string is sheared so that the characters are   ver-
              tically  parallel  to  a  line joining (x, y, z) to (x+sx, y+sy,
              z+sz). If sx = sy = sz = 0.) then the text is not sheared.

       sy (PLFLT, input)
              Together with sx and sz, this specifies shear of the string.





                          November, 2007                        1





PLPTEX3(3)                  PLplot API                 PLPTEX3(3)


       sz (PLFLT, input)
              Together with sx and sy, this specifies shear of the string.

       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
       PLplot   documentation,   maintained   by  Alan  W.  Irwin  and  Rafael
       Laboissiere.

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




































                          November, 2007                        2


