debian man page for plpoin

PLPOIN(3plplot) 						    PLplot API							   PLPOIN(3plplot)

NAME
       plpoin - Plot a glyph at the specified points

SYNOPSIS
       plpoin(n, x, y, code)

DESCRIPTION
       Plot  a	glyph  at  the	specified  points.   (This  function is largely superseded by plstring(3plplot) which gives access to many[!] more
       glyphs.) 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 plot-
       ted.

       Redacted form: plpoin(x, y, code)

       This function is used in examples 1,6,14,21,29.

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.

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