Skip to contents

Generate multiple spheres as a single mesh

Source: R/mesh_utils.R
generate_multi_spheres.Rd

Batched variant of generate_sphere(): all spheres are generated into one mesh with a single vertex/triangle array, which is much faster than generating and merging them one by one. This is the function to use for thousands of nodes, e.g. the nodes of a network graph or a point cloud. The returned mesh can be added to a scene and rendered with render_scene() or render_mesh().

Usage

generate_multi_spheres(
  centers,
  radii = 1,
  colors = c(1, 1, 1, 1),
  segments = 16L
)

Arguments

centers

Nx3 numeric matrix of sphere centres (or a length-3 vector for a single sphere).

radii

Numeric vector of radii (length 1, recycled; or one per sphere).

colors

RGBA colour(s): a single vector applied to all spheres, or an Nx4 numeric matrix (values in [0, 1], alpha optional).

segments

Subdivision count per sphere (default 16).

Value

A mesh descriptor list with vertices, triangles and colors.

See also

generate_sphere, generate_multi_cylinders

Examples

centers <- matrix(c(0, 0, 0, 2, 0, 0), ncol = 3, byrow = TRUE)
mesh <- generate_multi_spheres(centers, radii = c(0.5, 0.3),
                               colors = c(1, 0, 0, 1), segments = 12)
nrow(mesh$vertices) > 0
#> [1] TRUE