PLPTEX3(3plplot)						    PLplot API							  PLPTEX3(3plplot)

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 specified 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  position
       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
       parallel 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  joining
	      (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  vertically par-
	      allel 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.

       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.

								   August, 2012 						  PLPTEX3(3plplot)