addMesh

Add mesh on top of current mesh

Syntax

addMesh(actor,vertices,normals,faces)

addMesh(___,tcoords,vcolor)

Description

addMesh(actor,vertices,normals,faces) adds a partial mesh defined by vertices, normals, and faces. The resulting geometric mesh creates a single solid body.

addMesh(___,tcoords,vcolor) adds a mesh additionally defined by the texture coordinates tcoords and the vertex colors vcolor.

Input Arguments

vertices — Vertex positions

real positive (N,3) vector

Vertex positions, specified as a real positive (N,3) vector. This vector includes all vertex positions to be used for the mesh geometry.

Example: vertices = reshape(1: 6, 2, 3)

Data Types: double

actor — Actor class where property is being added

sim3d.Actor object

Actor class where mesh is being added, specified as a sim3d.Actor object.

faces — Faces of actor shape

real positive (N,3) vector

Faces of actor shape, specified as a real positive (N,3) vector. This vector defines how each triangle of the mesh is drawn. Length must be a multiple of 3.

Example: faces = [1: 3; 4 : 6]

Data Types: double

normals — Normal vectors

real positive (N,3) vector

Normal vectors for each vertex, specified as a real positive (N,3) vector. This vector must be the same length as vertices vector.

Example: normals = reshape(7: 12, 2, 3)

Data Types: double

vcolor — Vertex colors

real positive (N,3) vector

Vertex colors, specified a real positive (N,3) vector. This vector must be the same length as vertices vector.

Example: vertexcolor = reshape(25 : 33, 3, 3)

Data Types: double

tcoords — Texture coordinates

real positive (N,2) vector

Texture coordinates of each vertex, specified a real positive (N,2) vector. This must be the same length as vertices array.

Example: texturecoord = reshape(21 : 24, 2, 2)

Data Types: double

Version History

Introduced in R2022b