Main Content

add

Add actor to 3D environment

Since R2022b

    Description

    add(world,actor) adds actor to world.

    example

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

    Examples

    collapse all

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

    Empty virtual world scene

    Delete World

    Delete the world object.

    delete(world);

    Input Arguments

    collapse all

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

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

    Handle to the parent actor where actor is being attached.

    Version History

    Introduced in R2022b