plstring3(3plplot) [debian man page]

PLSTRING3(3plplot)						    PLplot API							PLSTRING3(3plplot)

NAME

       plstring3 - Plot a glyph at the specified 3D points

SYNOPSIS

       plstring3(n, x, y, z, string)

DESCRIPTION

       Plot  a glyph at the specified 3D points. (Supersedes plpoin3(3plplot) because many[!] more glyphs are accessible with plstring3(3plplot).)
       Set up the call to this function similar to what is done for plline3(3plplot). The glyph is specified with a PLplot user string.  Note that
       the  user string is not actually limited to one glyph so it is possible (but not normally useful) to plot more than one glyph at the speci-
       fied points with this function.	As with plmtex(3plplot) and plptex(3plplot), the user string can contain  FCI  escapes	to  determine  the
       font, UTF-8 code to determine the glyph or else PLplot escapes for Hershey or unicode text to determine the glyph.

       Redacted form: plstring3(x, y, z, string)

       This function is used in example 18.

ARGUMENTS

       n (PLINT, input)
	      Number of points in the x, y, and z arrays.

       x (PLFLT *, input)
	      Pointer to an array with X coordinates of points.

       y (PLFLT *, input)
	      Pointer to an array with Y coordinates of points.

       z (PLFLT *, input)
	      Pointer to an array with Z coordinates of points.

       string (const char *, input)
	      PLplot user string corresponding to the glyph to be plotted at each of the n points.

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 						PLSTRING3(3plplot)

PLPOIN3(3plplot)						    PLplot API							  PLPOIN3(3plplot)

NAME

       plpoin3 - Plot a glyph at the specified 3D points

SYNOPSIS

       plpoin3(n, x, y, z, code)

DESCRIPTION

       Plot  a	glyph  at  the specified 3D points.  (This function is largely superseded by plstring3(3plplot) which gives access to many[!] more
       glyphs.) Set up the call to this function similar to what is done for plline3(3plplot). code=-1 means try to just draw a point.	Right  now
       it's  just  a  move and a draw at the same place.  Not ideal, since a sufficiently intelligent output device may optimize it away, or there
       may be faster ways of doing it.	This is OK for now, though, and offers a 4X speedup over drawing a Hershey font "point" (which is actually
       diamond	shaped	and therefore takes 4 strokes to draw).  If 0 < code < 32, then a useful (but small subset) of Hershey symbols is plotted.
       If 32 <= code <= 127 the corresponding printable ASCII character is plotted.

       Redacted form: plpoin3(x, y, z, code)

       This function is not used in any example.

ARGUMENTS

       n (PLINT, input)
	      Number of points in the x and y arrays.

       x (PLFLT *, input)
	      Pointer to an array with X coordinates of points.

       y (PLFLT *, input)
	      Pointer to an array with Y coordinates of points.

       z (PLFLT *, input)
	      Pointer to an array with Z coordinates of points.

       code (PLINT, input)
	      Hershey symbol code (in "ascii-indexed" form with -1 <= code <= 127) corresponding to a glyph to be plotted at each of the n points.

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 						  PLPOIN3(3plplot)