plpoin3.3plplot man page

plpoin3 — Plot a glyph at the specified 3D points


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


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.


n (PLINT, input)

Number of points in the x and y arrays.

x (const PLFLT *, input)

Pointer to an array with X coordinates of points.

y (const PLFLT *, input)

Pointer to an array with Y coordinates of points.

z (const 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.


Many developers (who are credited at have contributed to PLplot over its long history.

See Also

PLplot documentation at


August, 2015 PLplot API