rgl (version 0.105.22)

merge.mesh3d: Merge "mesh3d" objects.

Description

Attempts to merge "mesh3d" objects. Objects need to be similar enough; see Details.

Usage

# S3 method for mesh3d
merge(x, y, ..., attributesMustMatch = FALSE)

Arguments

x, y

"mesh3d" objects to merge.

…

Optional additional objects.

attributesMustMatch

See Details.

Value

A single "mesh3d" object merging the contents of the arguments.

Details

To allow objects to be merged, they need to be similar enough in terms of having the same list of material properties, normals, texture coordinates, etc.

If attributesMustMatch is TRUE, it is an error to have attributes in one mesh but not in another, and those attributes that only specify a single value must have equal values in all meshes.

If attributesMustMatch is FALSE, any non-matching attributes will be dropped from the final result.

Examples

# NOT RUN {
# Notice that the alpha setting for the cube is dropped, because
# the other shapes don't specify alpha.
shade3d(merge(cube3d(col="red", alpha = 0.5),
              translate3d(tetrahedron3d(col="green"), 2, 0, 0),
              translate3d(octahedron3d(col="blue"), 4, 0, 0)))
# }