The Toolbar | Twinmotion Documentation

The Toolbar

An overview of the Toolbar in Twinmotion.

Windows
MacOS
Linux

The Toolbar provides access to a collection of tools you can use to modify and manipulate assets in the Viewport.

By default, only the Path tracer, Material picker, Translate , Rotate, and Scale tools are shown on the Toolbar.

ITwinmotion default toolbar

Path tracer, Material picker, Translate, Rotate, and Scale tools

To show or hide the other tools, click the Open and Close toggle icons on the Toolbar.

IClose icon

The Open icon on the Toolbar

IClose icon

The Close icon on the Toolbar

Tools in the Toolbar

The following table provides a brief description of the tools in the Toolbar.

Tool

Shortcut

Icon

Description

Path tracer

R

Path tracer icon

Enables or disables the Path tracer.

Material picker

T

Material picker icon

Selects materials on objects, and opens them in the Properties panel where you can view and edit their properties.

Open and Close

N / A

Open and Close toolbar icon

Shows or hides the other tools in the Toolbar.

Translate

7

Translate tool icon

Moves selected objects.

Rotate

8

Rotate tool icon

Moves and rotates selected objects.

Scale

9

Scale tool icon

Scales selected objects.

Move with collision

N / A

Move with collision tool icon

Enables or disables collision detection on objects. For more information, refer to Move with Collision.

Gravity

Shift + x

Gravity tool icon

Applies the force of gravity to objects. For more information, refer to Gravity.

Toggle local / world axis

Z

Toggle Local / World Axis icon

Switches between the local and world coordinate systems. For more information, refer to Toggle Local/World Axis.

Pivot edit

N / A

Pivot edit icon

Changes the position of the pivot point on objects, either manually or automatically. For more information, refer to Pivot Edit.

Reset edit

N / A

Reset pivot icon

Resets the position of the pivot point to its original location.

Center edit

N / A

Center-pivot icon

Positions the pivot point at the bottom and center of selected objects.

Physics-based Asset Placement Tools (Early Access)

The Toolbar features two physics-based tools—Move with collision and Gravity—that provide rigid-body physics simulation in real-time for objects in the Viewport. With these tools, you can make objects fall, bounce, and collide with each other in a manner that reflects motion and physics in real life. You can accurately move and place objects next to each other without any overlap, and scatter groups of objects randomly in a scene. Objects react in a natural, physics-based manner with the objects surrounding them, and the surfaces on which they are placed.

When Move with collision and Gravity are enabled, an invisible convex bounding box that uses simple collision is created and wrapped around each selected object (including the Starting ground) affected by physics. When these objects are manipulated, they detect and collide with the bounding boxes of other objects, and cannot be moved or rotated beyond these bounding boxes. This prevents objects from intersecting or overlapping each other.

IBounding boxes wrapped around objects

Simple bounding boxes wrapped around objects

Move with Collision

The Move with collision tool controls how objects interact with one another when they collide, and when they are placed next to each other.

When Move with collision is not enabled, objects can overlap and intersect with other objects and surfaces.

Using the Transform tool when Move with collision is not enabled

When Move with collision is enabled, objects collide with each other's bounding boxes and with surfaces in a realistic manner.

Using the Transform tool when Move with collision is enabled

The Move with collision tool can be used with the Translate, Rotate, and Scale tools. When collision is enabled, the icons of these tools are different, to indicate that Move with collision is enabled.

ITranslate, Rotate, and Scale tool icons with collision enabled

Translate, Rotate, and Scale tools when Move with collision is enabled

When collision is enabled, the function of the Scale tool changes. Instead of scaling objects, you can use it to move groups of objects closer and farther away from each other.

Gravity

When the Gravity tool is enabled, objects in the Viewport are affected by the force of gravity. For example, if you move an object or a group of objects above a surface, you can enable Gravity and make the objects tumble and fall on the surface in a realistic manner.

Each object is subject to the rules of gravity according to its own shape and weight. When using the Gravity tool, collision detection is activated. Objects detect the bounding boxes of other objects and collide with each other. You can use this feature to scatter multiple objects all at once, or place objects randomly and in different positions in a scene.

Gravity enabled on a group of objects

Limitations

The physics-based assets placement tools (Move with collision and Gravity) are still at an early stage of development and have some limitations. These are subject to change but currently include:

  • The tools can only be used with geometries that have simple 3D meshes. Collision and gravity do not have an effect on point cloud files and the following Twinmotion assets in the Library: Lights, Vehicles, Trees, Landscapes, Tools, Sounds, Doors, Particles, Decals, Animated humans, and Animals.

  • The tools have an effect on objects that are selected in a Scene graph container, but do not have an effect when the container itself is selected.

  • For collisions and gravity to work in real-time in the Viewport, the bounding boxes that surround objects use simple collision shapes that do not always wrap the objects in a completely accurate way. Because of this, the contact points between objects can sometimes be imprecise.

  • When using the tools with objects that have a high-poly mesh count, Twinmotion may freeze momentarily due to the complexity of the calculations.

  • When moving an object on a surface while Move with collision is enabled, the simple bounding boxes around each item come into contact. This can sometimes make the object lag behind the Gizmo. To correct this, elevate the object a few millimeters from the surface to increase the distance between both bounding boxes.

Pivot Edit

With the Pivot edit tool, you can change the position of the pivot point on the Gizmo manually, or automatically by either resetting it to its original position, or positioning it at the bottom and center of an object.

When an object in the Viewport is selected, a Gizmo appears on the object.

Gizmo on object

The Gizmo on a selected object

The center of the Gizmo represents the pivot point of the selected object or group of objects. The pivot point is the position from which objects are moved, rotated, and scaled.

Object rotating around a pivot point

In most cases, when you place an object from the Library in a scene, the pivot point of the Gizmo is located in the center and near the bottom of the object, and you do not need to change its location. However, there are some cases where you might want to change the location of the pivot point. For example, if you want to rotate an object from another pivot point on the object. In the example below, the pivot point is repositioned manually on the bottom right corner of the object, which rotates from this new pivot point location.

Object rotating around a pivot point placed on the bottom right corner

Another reason for changing the pivot point is if the Gizmo is located far away from the object itself, making it difficult to manipulate the object. This can happen when you place objects in the Viewport that are not from the Twinmotion Library. You can correct this using the Pivot edit tool by manually moving the pivot point closer to the object, or by automatically positioning the pivot point at the center and bottom of the object.

You can change the location of the pivot point on one object only, or on a group of selected objects. If you change the pivot point, you can reset it to its original location.

Toggle Local / World Axis

With the Toggle local / world axis tool, you can toggle between local axis and world axis to transform objects according to either the local or world reference coordinate systems. The local reference coordinate system is known as local space, and the world reference coordinate system is known as world space.

By default, objects in Twinmotion are moved, rotated, and scaled in world space (world axis). The Gizmo uses the X, Y, and Z axes of the world reference coordinate system to transform objects.

The X, Y, and Z axes on the Gizmo

The X, Y, and Z axes of the Gizmo

When you switch to local space (local axis), the Gizmo uses the axes of the selected object instead, meaning the object can be moved, rotated, and scaled according to the position of its own axes.

The images below show the position of the axes for the same object in world space and in local space.

IThe Gizmo in world space

IThe Gizmo in local space

The axes of the Gizmo on an object in world space.

The axes of the Gizmo on an object in local space.