merge.mesh3d: Merge '"mesh3d"' objects.

In rgl: 3D Visualization Using OpenGL

Description

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

Usage

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

Arguments

x, y	"mesh3d" objects to merge.
...	Optional additional objects.
attributesMustMatch	See Details.

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.

Value

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

Author(s)

Duncan Murdoch

Examples

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

Example output

Warning messages:
1: In rgl.init(initValue, onlyNULL) : RGL: unable to open X11 display
2: 'rgl.init' failed, running with 'rgl.useNULL = TRUE'. 

rgl documentation built on Feb. 1, 2021, 3:01 a.m.