fsbrain (version 0.5.5)

rglvoxels: Draw 3D boxes at locations using rgl.

Description

Draw 3D boxes at all given coordinates using rgl, analogous to spheres3d. Constructs the coordinates for triangles making up the boxes, then uses triangles3d to render them.

Usage

rglvoxels(centers, r = 1, voxelcol = NULL, do_show = TRUE, ...)

Value

list of `fs.coloredvoxels` instances, invisible. The function is called for the side effect of visualizing the data, and usually you can ignore the return value.

Arguments

centers

numerical matrix with 3 columns. Each column represents the x, y, z coordinates of a center at which to create a cube.

r

numerical vector or scalar, the cube edge length. This is the length of the axis-parallel edges of the cube. The vector must have length 1 (same edge length for all cubes), or the length must be identical to the number of rows in parameter `centers`.

voxelcol

vector of rgb color strings for the individual voxels. Its length must be identical to nrow(centers) if given.

do_show

logical, whether to visualize the result in the current rgl scene

...

material properties, passed to triangles3d. Example: color = "#0000ff", lit=FALSE.

Examples

if (FALSE) {
   # Plot a 3D cloud of 500 red voxels:
   centers = matrix(rnorm(500*3)*100, ncol=3);
   rglvoxels(centers, voxelcol="red");
}