load

Load or import 3D file

Since R2022b

Syntax

load(actor,source)

load(actor,source,scale)

Description

load(actor,source) loads the 3D file called source to the actor specified by actor.

load(actor,source,scale) specifies the overall scale applied to all the actors in source.

Input Arguments

actor — Actor class where 3D file is loaded

sim3d.Actor object

Actor class where the 3D file is loaded, specified as a sim3d.Actor object.

source — Name of location from where actor is loaded

character array

Name of location from where actor is loaded, specified as a character array. The source can be a file path or file name. load supports these as sources.

File Formats

• MAT

• STL

• FBX

• URDF

• x3d

MATLAB Objects

• RigidBodyTree

• surf (only 3D shapes based on polygons)

• patch (only 3D shapes based on polygons)

scale — Scale applied to loaded model

real positive scalar

Overall scale applied to the entire loaded model, specified as a real positive scalar. Scale parameters of individual objects are not affected by using this parameter.

Tips

You can load STL files even with sim3d.Actor objects that are not currently added to the World.

Version History

Introduced in R2022b