rgl (version 1.3.1)

pch3d: Plot symbols similar to base graphics

Description

This function plots symbols similarly to what the base graphics function points does when pch is specified.

Usage

pch3d(x, y = NULL, z = NULL, pch = 1, 
      bg = material3d("color")[1], cex = 1, radius, 
      color = "black", lit = FALSE, ...)

Value

A vector of object id values is returned invisibly. Separate objects will be drawn for each different combination of pch value from 0 to 25, color and bg, and another holding all the character symbols.

Arguments

x, y, z

The locations at which to plot in a form suitable for use in xyz.coords.

pch

A vector of integers or single characters describing the symbols to plot.

bg

The fill color(s) to use for pch from 21 to 25.

cex

A relative size of the symbol to plot.

radius

An absolute size of the symbol to plot in user coordinates.

color

The color(s) to use for symbols.

lit

Whether the object responds to lighting or just shows the displayed color directly.

...

Other material properties.

Author

Duncan Murdoch

Details

The list of symbols encoded by numerical pch values is given in the points help page.

See Also

points3d, text3d and sprites3d for other ways to label points, points for the base graphics symbol definitions.

Examples

open3d()
i <- 0:25; x <- i %% 5; y <- rep(0, 26); z <- i %/% 5
pch3d(x, y, z, pch = i, bg = "gray", color = rainbow(26))
text3d(x, y, z + 0.3, i)
pch3d(x + 5, y, z, pch = i+65)
text3d(x + 5, y, z + 0.3, i+65)