add

Add actor to 3D environment

Since R2022b

Syntax

add(world,actor)

add(world,actor,parent)

Description

add(world,actor) adds actor to world.

add(world,actor,parent) additionally updates the world scene graph by attaching actor to parent.

Examples

Create World and Actor Using MATLAB

This example shows how to create a 3D environment with an empty actor and view in the Simulation 3D Viewer window using MATLAB®. You can use the sim3d.World to create a world object and sim3d.Actor to create an empty actor object. You can then add the actor to the 3D environment and visualize the 3D environment in the Simulation 3D Viewer window. For an example that shows how to create a 3D environment with an actor using Simulink®, see Create World and Actor Using Simulink.

This process does not build an appearance for the actor, so the Simulation 3D Viewer does not render a visualization of the actor. For an example that shows how to build an appearance for an empty actor, see Build Actor from 3D Graphic Primitives Using MATLAB.

Create World

Create a world object.

world = sim3d.World();

Create Actor

Create an actor object. The sim3d.Actor object creates an empty actor without any visual meshes.

actor = sim3d.Actor();

Add the actor to the world.

add(world,actor);

Run Simulation

Run a simulation set for 10 seconds with a sample time of 0.02 seconds.

sampletime = 0.02;
stoptime = 10;
run(world,sampletime,stoptime);

Delete World

Delete the world object.

delete(world);

Input Arguments

world — World object

sim3d.World object

World object to which the actor object is being added, specified as a sim3d.World object..

actor — Actor object

sim3d.Actor object

The sim3d.Actor object being added to the 3D world.

parent — Parent actor object

sim3d.Actor object

Handle to the parent actor where actor is being attached.

Version History

Introduced in R2022b