addVisual

Add visual geometry data to rigid body

Syntax

addVisual(body,"Mesh",filename)

addVisual(body,"Mesh",filename,tform)

Description

addVisual(body,"Mesh",filename) adds a polygon mesh on top of any current visual geometry using the specified .stl or .dae file, filename. Multiple visual geometries can be added to a single body. The coordinate frame is assumed to coincide with the frame of body. You can view the meshes for an entire rigid body tree using show.

addVisual(body,"Mesh",filename,tform) specifies a homogeneous transformation for the polygon mesh relative to the body frame.

Input Arguments

body — RigidBody object

handle

RigidBody object, specified as a handle. Create a rigid body object using rigidBody.

filename — Name of mesh file

string scalar | character vector

Name of mesh file, specified as a string scalar or character vector. This file must be a valid .stl or .dae file.

Data Types: char | string

tform — Polygon mesh transformation

4-by-4 homogeneous transformation

Mesh transformation relative to the body coordinate frame, specified as a 4-by-4 homogeneous transformation.

Version History

Introduced in R2017b