How Can We Help?

Actions

< All Topics

Actions are the basis of scenario expression and interactive capability.

Actions are the basis of scenario expression and interactive capability. After selecting a role, click the  button in the upper right corner of the attributes pane. An action menu for adding actions will appear. Clicking the action option in the menu to add the corresponding action to the role. Depending on the type of the role and its current state, the available action options may vary.

For models, typically you can add the following six types of actions:

    1. Pose Adjustment: Effects that alter the position, rotation, and size of the model or sub-roles.
    2. Scatter: Action effects that scatter or spread sub-characters within the model.
    3. Section: Createe an section effect on the model to show its internal structure.
    4. Disappear: Create an effect that makes the model disappear.
    5. Link: Link the model to other scene. Jump to the target scene by clicking the model.
    6. Color Change: Effects that change the color of the model or sub-roles.

If the model comes with built-in animations, you can also configure animation options. For attachment roles and tools, you can only add pose adjustments, disappear actions, and link actions.

Action List: Multiple actions can be added to an role in the same scene, and clicking on a bar in the action list provides easy access to them.

Appear is the initial configuration option of all roles, allowing you to define the position, rotation, and scale of a role when it appears in the scene, as well as the duration of the appearance.

When you add a role to the scene, you can drag and rotate it to adjust its position and rotation. Additionally, you can make precise parameter adjustments to the Appearaction properties of the role to further customize its appearance.

    • You can use the Position and Rotation settings to adjust the initial pose of a role. The Position setting determines the location of the role’s center in the scene’s coordinate system. For more information on position coordinates, please refer to How to understand 3D coordinates in the scene.
    • Reset All: The Reset All button allows you to restore the positions of all child objects of the model relative to the parent object.
    • Scale: The Scale setting is used to adjust the size of the model in the scene. You can still modify this configuration by using pose adjustment action in subsequent scenes.
    • Appear type: The default Appear type setting is Zoom, which means that the model will appear by gradually scaling up from the center point during playback. If set to Left or Right, the model will move a short distance in the corresponding direction and then stop at the designated appearance position.
    • Duration: The default duration is 1 second, which represents the length of time it takes for the Appear action to complete, from the start to the end.

You can select Add Pose in the action menu in order to make a role move during the scene. The role can move by rotating, changing its size, traveling to another location in either a curved or straight path, or a mixture of all three. To change a role’s attributes during a scene (growing, shrinking, rotating), all you have to do is change the attributes into the final state while Add Pose is active, and the role will mirror these changes during the scene.

How to move a role in a straight path

The Pose Adjustment action enables a role to move along a straight path.

Here are the steps to add and set the Pose Adjustment action for a role to move along a straight path:

    1. Select the role you would like to move during the scene.
    2. Click the button  next to the role’s name in the attributes pane and select the Add Pose option from the drop-down menu.
    3. Move the role in the workspace to change its position or fine-tune the pose adjustment parameter values in the attribute area, and then set the Duration of the pose adjustment action.
    4. By selecting the Transform Type, set the transformation speed of the pose adjustment action.
      • Uniform: The role’s movement speed remains constant throughout the motion.
      • Accelerate: The movement gradually accelerates to full speed.
      • Decelerate: The movement gradually decelerates from full speed.
      • Smooth All: The movement accelerates to full speed, maintains the speed, and then decelerates to rest.

How to move a role in a curved path

You can also use the Pose Adjustment action to make a role move along a curved path.

Here are some of the attributes that you will need to know in order to move a role in a curved path.

    • Use Curved Path: This option is disabled by default. Enabling this option allows the role’s path to curve around control points.
    • Rotate Along Path: When this option is enabled, the role will always face the direction that it is moving in.
    • Waypoint: These are points along the role’s path that guide the way that the path curves. You can set as many as you want, and setting multiple points along one curve allows for more gradual and smoother movements.

The following are steps to add and configure roles to move along curved path in the pose adjustment action:

    1. Select the role you would like to move during the scene.
    2. Click the button next to the role name and select the Add Pose
    3. Check the Use Curved Path
    4. Adjust model position, rotation, scale and click Create a Waypoint at Current Location.
    5. Repeat step 4 to create other waypoints for the curved path.
    6. Adjust the position and curvature of the waypoint to make the curved path smoother.
    7. Configure Duration and Transform Type of the pose adjustment.
    8. Click the Play button to preview the effect of the pose adjustment action.
    9. Fine-tune the settings of the pose adjustment action for the curved path as needed.

Some models come with their own predefined animations, which can be configured in the Action. When a model contains animations, we can configure the animation of the model role in DataMesh Studio, such as setting the playback mode and duration of the animation.

Here are the steps to configure the animation of a model role:

1. Select the model role in the Roles pane.

2. Click the button in the attributes pane and select the Configure Animation option.

3. In the attributes pane, you can see all the animation names that the model contains.

4. You can select the animation you want to configure, set its playback mode to Play Once or Play Loop, and modify the Duration of the animation.

You can add a Scatter action to any role that contains sub-roles. By default, the Scatter action will expand all primary sub-roles under the role. You can set the scatter effect for all sub-roles in a Scatter action, or you can continue to add Scatter actions for sub-roles that contain lower-level sub-roles, thereby achieving an outward-to-inward sequential expansion effect.

Add a Scatter action

To add a Scatter action for a selected role or child role, click the  button next to the role name in the attributes pane. Then, in the action menu, select Add Scatter. This will add a Scatter action to the role or child role, allowing you to configure the scattering effect.

In the Scatter attributes pane, you can choose between two types of disassembly effects: Exploded and Axial.

    • Exploded: This option separates sub-roles by pushing them outwards from the center of the parent role. By adjusting the Distance slider or value, you can modify the distance of the sub-role from the parent role.
    • Axial: This option arranges sub-roles in a straight line along an axis. By adjusting the Distance slider or value, you can change the spacing of roles in the line. The Direction option refers to the direction in which the sub-roles are arranged.

Exercise 1

To achieve the scattering configuration for a monster model and one of its arms within a Scatter action, you can follow these steps:

1. Select the monster model in the scene.

2. In the attributes pane, click the button next to the name of the monster model, and select Add Scatter in the action menu.

3. Configure Scatter Type, Range or Distance and Duration.

4. In the workspace, click to select the right arm of the monster model.

5. In the attributes area, Enable the scatter action for the arm, and set Scatter Type, Range or Distance and Duration.

6. Select the monster model again in the workspace, you can see there is only one scatter action in the action list.

Exercise 2

To add a separate Scatter action to the right arm of the monster model, you can follow these steps:

1. Select the monster model in the scene.

2. In the attributes pane, click the button next to the name of the monster model, and select Add Scatter in the action menu.

3. Configure Scatter Type, Range or Distance and Duration.

4. In the workspace, click to select the right arm of the monster model.

5. In the attributes pane, click the  button and select Add Scatter in the action menu.

6. Configure Scatter Type, Range or Distance and Duration.

7. Reselect the monster model in the workspace, and you will notice that the action list in the attributes area now displays two scatter actions. The first scatter action pertains to the scattering of the entire monster model, while the second scatter action specifically applies to the arm.

Remove a Scatter action

Removing a Scatter action means removing the scatter effect that has been applied to the model, thereby restoring it to its original state.

You can follow these steps to remove the Scatter action:

1. Select the scattered model in the workspace.

2. In the attributes pane, click the button next to the model’s name and select Add Scatter in the action menu.

3. Check the Reset option.

4. This will cause all the previously separated sub-roles to merge together to form the original model.

This action allows you to show the interior of a model by ‘cutting’ into it, which is an effective way to show how a model’s physical counterpart might function. You can adjust which part of the model is removed, how long the cut animation takes, and which direction the cut is made in.

Add a section

To add a section to a model, follow these steps:

1. Select the model that you want to add a section to.

2. Click the button near the role’s name in the attributes pane and select the Add Section option.

3. The Removal Cube will appear in the workspace, which is a transparent blue cube with three lines that represent each axis. This cube allows you to choose the section of the model that you want to remove. You can drag and rotate the Removal Cube in order to customize your desired cross section, and its position can change whether the model is cut in half, or if a corner is removed.

4. Configure the section in the attributes pane.

You can configure section as follows:

    • Section Animation: The section animation consists of your chosen section fading out in an axis relative to the Removal Cube. This option allows you to choose which axis the fade occurs in.
    • Section Point: The position of the point where the three faces of the section body intersect. This shows you the point where all three of the Removal Cube’s axes meet. You can also manually input the point’s coordinates for extra precision.
    • Section Part: Each field represents the angle of one axis of the removal cube. You can manually input the angle in order to change which direction the removal cube is facing.
    • Preset: We provide a variety of presets that you might find helpful when choosing your cross section. Each preset has a corner of the model removed, along with a visual guide to help you choose the right one for you. In the visual guides, the blue cube represents your model, and the yellow cube represents the removed section. In addition, the visual guides rotate along with your perspective of the model in the workspace.

5. Click the Preview button to check the section action effect and adjust according to the effect.

When cross sectioning a role, the default behavior is that all of its sub-roles inherit the cross-section effect. If you would like a specific sub-role to not be affected, follow these instructions below.

1. Select the sub-role that you would like to be exempt from the cross sections effect.

2. In the cross-section settings, toggle the Enable option so that it is active, select the Reset checkbox, and make sure the Section Animation is set to None.

Repair a section

After cross-sectioning a model, you may want to reverse the process afterwards. You can simply remove the cross-section action, which will cause the model to suddenly be full again during the next scene, or you can repair it using the same animation for consistency. Here are the steps to do so.

1. Select the cross sectioned role that you want to repair.

2. Click the button next to the role’s name in the attributes pane and select Add Section from the action menu.

3. In the Adjust Section settings in the attributes pane, make sure that the Reset checkbox is checked.

4. Configure the Section action throught the settings of Section Animation, Section Point, Section Part, Preset and Duration.

5. Click the play button to preview the effect of removing the section and make section adjustments as needed.

When previewing a scenario or playing it in DataMesh One, you can easily navigate to the target scene by clicking on a model or sub-object that has a Link action associated with it.

Note: If the target scene is deleted, the link will become inactive. In addition, links are only active during the scene that they first appear in. To add another link to the model in a different scene, you must first remove the original link, then add the new link.

To add a Link action to a model or sub-object, follow these steps:

1. Select the model or sub-object that needs to add a Link action.

2. Click the button next to the role’s name in the attributes pane and select the Add Link option.

3. In the Link Settings in the attributes pane, uncheck the No jump option, and then select the Link scene in the Link Settings.

4. Once linked, the role will have a glowing blue box that signifies the link’s area. You can drag the surrounding blue cones in order to move this link area to your liking.

This action allows you to remove a role during any scene after the scene where it was first placed.

The steps to add a Disappear action to a role are as follows:

1. Select the role that you would like to disappear.

2. Click the button next to the role’s name in the attributes pane and select the Disappear option. At this point, the role will be grayed out, showing that it will disappear at the end of the scene.

3. In the Disappear settings in the attributes pane, select your preferred type. The Disappear type shrinks the role into its own center until it disappears and Left or Right makes the role move a short distance in the corresponding direction before vanishing.

The Color Changes action is an animation effect that enables a role to change colors during the animation. It can be applied to any node of a model, whether it is the entire model or specific sub-objects. When you add the Color Changes action to the entire model, the color changes will be applied to the currently selected model role and all its sub-objects, allowing for dynamic and visually appealing color transformations.

Here are the steps to add a Color Changes action:

1. Select the role that you want to change color during the scene.

2. Click the button next to the role’s name in the attributes pane and make sure that the Color Changes action is enabled.

3. Then, set the color you would like the role to change to, the transform type, and the duration.

Transform Type

    • None: The color of the role will directly change to the specified color without any animation effect.
    • Gradient: The role’s color will transition into the new color over a period of time, creating a smooth and gradual change in color.
    • Flash: The role will rapidly alternate between its original color and the new color within a certain time frame, creating a blinking or flashing effect.

After adding the Color Changes action, during the scenario playback, when the role performs the action, its color will change according to the settings.

Table of Contents