rgl (version 1.2.8)

merge.mesh3d: Merge RGL mesh 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)

Value

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

Arguments

x, y

"mesh3d" objects to merge.

...

Optional additional objects.

attributesMustMatch

See Details.

Author

Duncan Murdoch

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

open3d()
# 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)))