Scroll to navigation

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