plpoin3.3plplot - Man Page

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

Number of points in the x and y vectors.

x (PLFLT_VECTOR(3plplot), input)

A vector containing the x coordinates of points.

y (PLFLT_VECTOR(3plplot), input)

A vector containing the y coordinates of points.

z (PLFLT_VECTOR(3plplot), input)

A vector containing the z coordinates of points.

code (PLINT(3plplot), 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


October, 2023 PLplot API