Archives: Knowledge Base

How to understand 3D coordinates in the scene

For a 3D coordinate system, the scene’s origin is at (0,0,0). We can represent the position of any role as a certain number of units to the left or right of the origin, a certain number of units above or below the origin, and a certain number of units in front of or behind the origin. These three dimensions are known as the X-axis, Y-axis, and Z-axis.

These three numbers provide the 3D coordinates of a point in space. For example, a point located 7 units to the right of the origin (X-axis), 3 units above the origin (Y-axis), and 4 units in front of the origin (Z-axis) has the （x, y, z） coordinates of (7,3,4). To specify a point in the opposite direction of the origin, we should use negative numbers. For instance, a point located at (-5, -2, -1) is 5 units to the left of the origin, 2 units belove the origin, and 1 unit behind the origin.

When playing a scenario edited in DataMesh Studio using DataMesh One, it integrates with real-world spatial positioning. Generally, the model from the first page of the scenario is used as a reference for spatial positioning.

Furthermore, DataMesh Studio provides two additional custom spatial positioning methods: Reference model positioning and QR code positioning.

Reference model positioning

Reference model positioning refers to using one or more reference models to assist in scenario editing and spatial positioning.

Detailed steps to use reference model positioning are as follows:

1. Click the Scenario menu in the menus and select Modify Scenario Positioning from the drop-down menu to enter positioning mode.

2. In the Resources pane, locate the model you want to use as a reference background.

3. Click and drag the model from the Resources pane to the scene area.

4. Click the Quit button to exit the positioning mode and use the reference model to help position other models in the scenario.

5. Play the scenario in DataMesh One and perform positioning in position mode.

Note: The Position Reference settings need to be set to First Frame, aligning with the first frame of the first scene in the script for positioning.

QR code positioning

QR code positioning refers to spatial positioning by scanning the locating code in the scenario during playback.

Note: DataMesh FactVerse Services does not support downloading positioning codes from scenarios created using versions of DataMesh Studio prior to 5.5. To download the positioning codes, you need to open the scenario using DataMesh Studio 5.5 or above, re-upload the scenario, and then you will be able to download the included positioning codes from the FactVerse Service platform.

The steps for using QR code positioning are as follows:

1. Click the Scenario menu in the menus and select Modify Scenario Positioning from the drop-down menu to enter positioning mode.

2. Select the QR code (QR Code_ <number>) that needs to be positioned from the Roles pane and drag it to the desired location.

3. Click a blank space in the scene area to deselect the QR code. Then, in the attributes pane, click the Add Marker button under the Stage Attributes section to add a new marker.

You can add 100 markers at most. The No.1 to No.10 marker is compatible with the markers in the version of DataMesh Studio before 5.5.

4. Click the Quit button to exit the positioning mode, edit the scenario and save it.

5. Log in DataMesh FactVerse Services, find the scenario and download the positioning code in the detail page of the scenario file.

6. Print the downloaded positioning code.

7. In the MR mode of DataMesh One, scan the QR code printed in step 6 and then the model will appear above the QR code.

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. A 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. Model roles can generally add six types of actions: Pose Adjustment, Scatter, Section, Disappear, Link and Color Changes. When the model comes with animations, there will be an Configure Animation action. Attachment and tool roles only have Pose Adjustment and Disappear actions.

Action List: Multiple actions can be added to a role in the same scene, and the action list of all actions for that role will be displayed in sequence above the role’s attribute pane.

Appear

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 Appear action 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.

Pose Adjustment

When you select Add Pose in the action menu, it adds a Pose Adjustment action. The Pose Adjustment action allows roles in the scene to move along a straight or curved path and change their position, rotation angle, and size through translation, rotation, and scaling.

With the Pose Adjustment action, you can create dynamic effects for roles, including smooth acceleration, deceleration, and uniform motion.

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. Click on the role name in the role list to select the role you want to add pose for.

2. Click the button  next to the role name and select the Add Pose option.

3. Move the role in the scene area 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 transformation speed of the pose adjustment action remains constant.
  • Accelerate: The pose adjustment action accelerates from a stationary state to uniform motion.
  • Decelerate: The pose adjustment action decelerates from uniform motion to a stationary state.
  • Smooth All: The pose adjustment action first accelerates to maximum speed and then gradually decelerates to a stationary state, making the action change smoother and more natural. This transform type is the default setting for the pose adjustment action.

Curved path

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

Use Curved Path: By enabling the Use Curved Path option, you can create a pose adjustment action for a role along a curved path. This option is disabled by default.

Rotate Along Path: When the Rotate Along Path option is enabled, the orientation of the role will always align with the direction of the path.

Waypoint: Waypoints are the intermediate points along the path. By adding waypoints, you can determine the curvature and direction of the curve, resulting in a smoother curved path. The starting point of the path represents the initial position of the role (from the previous action or the previous scene), while the end point of the path represents the final position of the role in the current scene.

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

1. Click on the role name in the role list to select the role.

2. Click the button next to the role name and select the Add Pose option.

3. Check the Use Curved Path option.

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.

Animation

The Animation action refers to a pre-defined action within a model. When a model contains animation, 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.

Scatter

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 action setting pane, you can choose between two types of scatter effects: Exploded and Axial.

• • Exploded: The exploded scatter effect disperses sub-roles from the center of the model to the surrounding area. By adjusting the Range slider or numerical value, you can modify the magnitude of the explosion. Larger values will scatter sub-roles farther away, while smaller values will scatter them closer.
  • Axial: The axial scatter effect arranges sub-roles in a single direction. By adjusting the Distance slider or numerical value, you can control the spacing between sub-roles. Larger values increase the spacing, while smaller values decrease it. The scatter Direction refers to the direction in which the sub-roles are arranged. Because sub-roles cannot scatter below the desktop, the option to scatter in the downward direction is not available.

Example 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 scene area, 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 scene area, you can see there is only one scatter action in the action list.

Example 2

To add a scatter the monster model and its right arm in separate scatter actions, 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 scene area, 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 scene area, 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 the Scatter action

Removing the 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 scene area.

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. After removing the Scatter action, the sub-objects of the model will be restored to their original positions and states.

Section

The Section action allows you to add virtual sections to a model. By adding a section, you can simulate a real cutting operation on the model, which is useful for design and presentation purposes. You can add a section to any node of the model. Additionally, you can configure section effects for other nodes within this section action, including defining the section direction and applying section animation.

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 next to the role’s name in the attributes pane and select the Add Section option.

3. In the scene area, a draggable and rotatable section body will appear, consisting of three infinitely extended surfaces. You can adjust the position of the section body by dragging it. Any part of the model that the section body passes through will be cut off.

4. Configure the section in the attributes pane.

You can configure section as follows:

Section Animation: Three types of Section Animation are available for selection, including Along X Axis cut in/cut out, Along Y Axis cut in/cut out, and Along Z Axis cut in/cut out.

Section Point: The position of the point where the three faces of the section body intersect.

Section Part: The direction in which the section body rotates along the three axes.

Preset: To quickly select the section direction, you can choose Preset. The eight blue cubes in the Preset represent the model, and the yellow part represents the cut-out position. The cubes in the Preset are associated with the model. When you adjust the angle or rotate the model, the cubes in the Preset will also rotate accordingly.

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

When adding a section action to a role, all its child roles will be affected by the section. If you want to preserve the shape of the child role, you can remove the section action from the child role to avoid being affected by the section action of the parent role.

The steps are as follows:

1. Select the child role from which you want to remove the section effect.

2. Open the Enable option in the Adjust Section settings, then check the Reset option and select None in the Section Animation settings.

Remove a section

To remove the section action and restore the role to its initial state before the section, follow these steps:

1. Select the role or the child role containing the section action.

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, check the Reset option.

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.

Link

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 action will be invalid. 

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. The model or sub-object selected in the scene area will have a hot zone box, which can be dragged to set the interactive range.

The hot zone is an area in which a mouse click allows for navigation or interaction. When an object is selected, the scene area displays a default hot zone box around the selected object, encompassing it. The hot zone box is in the shape of a rectangular prism, and each of its six faces has a cone-shaped handle at its center. These cone-shaped handles can be dragged to adjust the size of the hot zone.

Disappear

The Disappear action refers to the animation effect of a role disappearing in a scenario. By adding a Disappear action, the role can achieve the effect of disappearing in a specific scene of the scenario.

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

1. Select the role that needs to add a disappear action.

2. Click the button next to the role’s name in the attributes pane and select the Add Disappear option. At this point, the role in the scene area will be in a semi-transparent state, indicating that it has disappeared.

3. In the Adjust Disappear setting in the attributes pane, select the Disappear Type. You can choose from four styles: None, Zoom, Right, and Left.

Color Changes

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’s 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 to add the color changes action to.

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

3. In the Color Changes settings in the attributes pane, set Color, Transform Type, and other parameters.

Transform Type

None: The color of the role will directly change to the specified color without any special animation effect. 

Gradient: The color will gradually transition over a period of time, creating a smooth and gradual change in color. 

Flash: The color will rapidly alternate between the original color and the specified 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.

In DataMesh Studio, roles are the resources used to build 3D content. They include 3D models, attachment resources, built-in tool models, expanded tools, light sources, cameras, and more. You can combine these roles to create authentic 3D scenes that can be used for display, training, and demonstrations. Roles play a crucial role in constructing immersive and interactive experiences within DataMesh Studio. 

Model roles

In DataMesh Studio, you can utilize various 3D model files to create model roles within the scene. To use a 3D model, you need to create it using an external application program and then upload it to the resources of the FactVerse Services platform. 

Supported file formats for models include: .fbx, .glb, .obj, .stl, .3mf, and .ply. 

Upload models

There are two ways to upload a model file to the FactVerse Services platform: 

• • Upload model files on the FactVerse Services platform: You can upload model files directly on the platform. For detailed steps on how to upload a model file, please refer to DataMesh FactVerse Services User Manual.
  • Upload files via DataMesh Importer: DataMesh Importer allows you to not only upload models, but also check their structure, materials, and adjust attributes such as color, transparency, metallicity, and smoothness. For more information, please refer to DataMesh Importer User Manual. 

After uploading the model, you can add it to the scene by dragging and dropping it from the My Resources section in the Resources pane of DataMesh Studio. Once added, you can manipulate the model by moving, rotating, and zooming according to your requirements. Additionally, you can set model attributes and add actions as needed. 

Initial attributes of model roles

After dragging a model from the Resources pane to the scene in DataMesh Studio, the model will be placed in the scene and automatically selected. At this point, the attributes pane will display the initial attributes of the model roles, which include Appear, Model Attributes and IoT Data Binding. 

Appear: The Appear section represents the default initial action after adding roles to the scene. For more detailed information, refer to Appear. 

Model Attributes: Model Attributes are configuration settings specific to model roles and can only be configured within the first scene where the model appears. They are used to define fixed attributes of the model roles, including Obscure and Origin Scale. 

• • Obscure: The Obscure attribute allows you to designate a primary model (not a sub-model) as an obscure object. The obscuring object is transparent and blocks other models behind it. When using MR mode to play your scenario, the 3D content is always displayed in front of the real world. When you want real-world objects to block the 3D content, you need to create a model representing the real-world object and set it as an obscuring object. The roles set as obscuring objects are invisible but can block models behind them, giving the impression that the models are being blocked by real-world objects.  

• • Origin Scale: The Origin Scale attribute is like the Scale attribute in the Appear attributes settings. The product of these two scale factors determines the actual size of the model. The Origin Scale attribute is to adjust the model’s size when it is too large or too small. By modifying the scale factors, subsequent adjustments to the scale can be made more easily based on a 1x scale.

IoT Data Binding: The IoT Data Binding feature is one of the advanced functionalities in DataMesh Studio. It allows you to import external data to drive the behavior of model roles in your scenario, such as model movement, rotation, and color changes. This configuration item is used to establish a connection between model roles and digital twin objects. For more detailed information about IoT Data Binding, please refer to IoT Data Driven Instructions. 

Attachment roles

Attachment roles refer to supplementary resources such as images, videos, audio files, and PDF documents. They provide additional instructions for model structures, operation flows, creation norms, and more. These resources serve as valuable aids in enhancing the scenario experience. To use attachment roles, you need to upload the corresponding resources to the FactVerse Services platform. Once uploaded, you can easily drag and drop them from the My Resources section of the Resources pane into the scene area of DataMesh Studio.

Images

You can use images as supplementary instructions to enhance the visual experience of scenarios. They can provide visual references, serve as backgrounds, or act as base maps for various purposes. For instance, you can convert a building floorplan into a PNG image and use it as a layout reference in the scene for better visualization. 

Supported picture formats in DataMesh Studio include JPG and PNG. 

Facing User option is disabled in default. When checking the Facing User option, the image will always face users no matter how the view angle changes.

Audio

In DataMesh Studio, you can enhance the immersive experience of scenarios by adding audio files to the scene for background music or sound effects.

We recommend using MP3 and OGG formats for audio files in DataMesh Studio.

To add audio files to the scene, you can simply drag and drop them from My Resources to the scene in DataMesh Studio. If you need to adjust the attributes of audio files, such as volume and loop playback, you can select the file and modify its settings in the attributes pane. If you want to remove audio files from the scene, you can select the audio role in the scene and click the delete button. 

Set for BGM: When the option is checked, the audio role will be set as background music which is a global sound source. If this option is unchecked, the audio file will be served as ordinary sound effect with stereo effect and produce different sound effect according to different position.

Play Hide: Visible or not when play.

Auto Play: Play automatically or not.

Loop: Loop playback or not.

Volume: Adjust volume.

Video

The function of Facing User in the video attributes is the same as these in image roles. AutoPlay and Volume are the same as these in audio roles.

Recommended video format in the DataMesh Studio: MP4, MOV.

PDF documents

In DataMesh Studio, you can add PDF documents to the scene by dragging and dropping them from My Resources. After adding a PDF file, you can set the default page number to be displayed in the attributes pane. This way, when you navigate to this scene in the scenario, the PDF file will show the specified page number. 

Extension tools

You can design and create your tools in Unity following the provided tool production specifications. Afterward, use the DataMesh plugin to export your creations as a zip file. Once exported, you can open and view the zip file using DataMesh Importer. You can also upload the zip file to the FactVerse Services platform, making it available as a built-in tool for use in DataMesh Studio.

You can follow below steps to add an extension tool:

1. Click Libraries in the Resources pane of DataMesh Studio.

2. Click the ellipsis ︙ icon next to Extend and select Add extension tools from the options.

3. In the Add extension tool window, fill in Extension Gadget Name, Gadget Type and select the extension gadget file.

4. Once configured, you will see the added extended tool under the Extend section in Libraries.

Tools

In DataMesh Studio’s Libraries pane, various tool models are built-in, such as Text, Components, Shape, Symbol Name, Hand, IoT, etc. These tool models can help users in scenario creation. The method of adding these tool models is the same as adding regular models, and you can drag and drop them into the scene area.

Text

Text is used for showing information, explaining, or describing the task of roles in the scene.

In DataMesh Studio, you can add three types of text: Text, Tag and Web Tools.

Text

You can add a text via dragging and dropping it to the scene area. In the first scene where the text is added, the text will automatically have an appearing animation effect. You can adjust its position and rotation angle just like adjusting a model and resize the text box by dragging its four corners. In the attributes pane below, you can enter the text content and press Enter to create line breaks. Additionally, you can modify the width and height of the textbox, background color, text size, text color and alignment etc. After checking Facing User, the text will always face users’ direction of observation despite the changes in scene view.

Tag

A Tag tool consists of a textbox, a connection line, and an anchor. After adding a tag, you can move it to the desired model by clicking and dragging the anchor point. The anchor point can attach to the surface of the model and move along with it, and the text box will adjust its position accordingly. The properties displayed in the attributes pane for the tag are like those for text boxes. You can modify properties such as the width and height of the tag’s textbox, background color, font size, font color, and alignment. Like text boxes, tags present a textual description to the user, but with the addition of an anchor point that can attach to another role.

Web Tools

Web Tools allows you to embed website content into a scene. You can drag and drop the Web Tools from the Text tools section into the scene area, and then configure the Website URL you want to embed in the attributes pane. During playback, the web tool will display the configured website content. With the web tool, you can embed various online information, data, or real-time information directly into the scene, and can have simple interactions with the web page, resulting in a more vivid and intuitive presentation effect.

Components

Ruler

The Ruler can measure the distance of roles. It can identify horizontal planes of nearby roles and be perpendicular to the horizontal plane. Stretching the four corners of the ruler aligns both ends of the ruler with the ends of the target role, and the measured length is displayed in the middle of the ruler.

Meter Attributes

• • Auto Measure: When Auto Measure is enabled, the actual measurement length of the ruler is displayed on the ruler. Otherwise, the content configured in the Text Attributes is displayed.
  • Left/Right Endpoint: The X-axis coordinate of the left/right endpoint is relative to the center of the ruler. Therefore, the Left Endpoint can only be entered as a negative value, and the Right Endpoint can only be entered as a positive value.
  • Meter Color: The overall color of the ruler.
  • Meter Scale: Refers to the thickness of the ruler line and the size of the arrow.

Button

Button is a commonly used interactive tool that can be used to display information, control scene flow (jump between scenes).

To add a button, you can drag a button component to the scene in the DataMesh Studio.

In the attributes pane, you can enter the content of button, adjust the size and color of the button, and set the target scene that the button will jump to. During scenario playback, when the user clicks the button, the scene will automatically jump to the target scene that has been set.

Guide

Guide tools are commonly used to guide positions in a scenario, telling viewers to go to a certain location, or representing a process such as machining or item transfer. DataMesh Studio provides four guide style options, and you can also modify the size and display speed of the guide.

You can find Guide in the Components of the Libraries of the Resources pane and drag it to the scene. In the attribute area, you can choose distinctive styles and control properties such as the size and position of the marker.

Light Source

By default, when a new scenario is created in DataMesh Studio, it will contain two light source roles. The light source can provide lighting effects for the scene, and the light source will be automatically hidden during scenario preview to ensure that the light source itself does not interfere with the scene’s appearance.

You can use following ways to operate light source:

• • Add light source: To add light source, you can drag the Light Source component from Libraries of Resources to the scene. The newly added light source will be displayed in the role list.
  • Delete light source: Select the light source to be deleted and click the delete button in the toolbar. Please note that each scene needs to keep at least one light source.
  • Edit light source attributes: After selecting the light source, you can edit the light source attributes in the attributes pane area, such as light source Color, Intensity and Shadowed or not etc.
  • Add pose to the light source: You can add pose to the light source role which is used to simulate light movement, such as sunrise and sunset, headlights of a moving vehicle.

Light Source Type

Directional: Directional light is a kind of global light resource. It is only affected by the rotation angle which will affect the light angle and the direction of shadow. Its position does not affect directional light. Directional light is commonly used to simulate sunshine.

Point: Point is a kind of local light which lights up the surrounding environment. It can affect roles within the lighting range radius. The lighting effect will decay as the distance increases, eventually disappearing completely within a specific range. Point light is commonly used to simulate light sources such as light bulbs.

Conical: Conical light source constrains the lighting range within a specified direction cone area. The lighting effect is also affected by distance, but the lighting range will increase as the distance gets farther, until it is beyond the lighting range. Conical light is commonly used to simulate spotlight.

Light source color

In DataMesh Studio, the default color of a light source is white. You can change the color of the light source to change the color of the light that shines on the object. Generally, white light sources are suitable for “ordinary” lighting used to shade objects.

Light source intensity

Light intensity refers to the brightness of the light emitted by the light source, which can be adjusted in the range of 0.01-5.00. By adjusting the light intensity, you can change the brightness of the light shining on the object.

Shadowed

• • Checked: Shadows will be generated for corresponding roles based on the direction of the light.
  • Unchecked: Roles will not produce shadow.

Shape

The Shape tools included in DataMesh Studio are Cone, Sphere, Cylinder, Cube, Arrow. You can quickly create various shapes by simple dragging and adjusting properties, adding more elements and rich visual effects to the scene.

You can set attributes of shape model in the attributes pane, such as shape, color, base area, and height of cone.

Symbol Name

DataMesh Studio includes several types of signs: Right, Wrong, Warning, and Electric. These signs are designed to emphasize important information within the scene and help you showcase and direct the audience’s attention. For instance, you can add a Right sign to highlight the right answer, or a Wrong sign to alert the audience to incorrect information. The Warning sign is useful for displaying cautionary messages, and the Electric (lightning) sign can be utilized for special visual effects or attention-grabbing elements. These signs enhance the overall visual communication and engagement of your scenarios.

Hand

DataMesh Studio includes three types of hand models: Hold, Crawl and Point. These hand models can be used to simulate user gestures, such as holding or grasping an object, or pointing to a location in the scene. After dragging the corresponding hand model into the scene area, you can set the hand model’s left and right hand and color attributes in the attributes area. By using hand models, you can more vividly simulate users’ actual operational behavior, enhancing the immersion and interactivity of the scene.

IoT Data Pane

IoT Data Pane can be used to display real-time IoT data and simulated data. You can select data in the attributes pane, and set the background, text color, font size, and data prefix of the data at the same time. 

IoT Data Pane

• • Frame Size: The size of the text box can be set.
  • Text color: The color of the text font can be set.
  • Background color: The background color of the text box can be set.
  • Font size: The font size of the text can be set.
  • Alignment: The alignment of the text can be set, such as center, left, or right alignment.
  • Show Twin Names: Unchecked in default. If checked, the digital twin’s name will be shown.
  • Display Attribute Group Name: Unchecked in default. If checked, the attribute group name will be shown.
  • + Select Twins: Click + Select Twins, a Digital Twin list will pop up. This list displays all the digital twins’ names in the workgroup of this account and supports searching according to twin name. After selecting digital twins, the original + Select Twins position will change to the name of the selected digital twin name. Click the name of the selected digital twins, you can choose digital twins again.

For more details of IoT Data Binding, please refer to IoT Data Driven Instructions.

Arrow

DataMesh Studio provides many arrow models, including Steering Arrows, Unidirectional Arrows, Horizontal Surround Arrows, and Vertical Surround Arrows. You can use these arrow models to decorate your scene to better convey information. In the attributes area, you can adjust various attributes of the arrow model according to your needs.

Special Effects

DataMesh Studio contains many special effects tools, including Lightening, Stream, Fire and Smog.

You can drag special effects tool to the scene from Special Effects of Libraries of Resources pane and configure model attributes in the attributes pane.

The attribute descriptions for special effects are as follows:

• • Color: Set the color of the special effect, supporting the setting of RGBA values
  • Life Cycle: Set the life cycle of the special effect, i.e., the time the special effect exists, in seconds.
  • Initial Speed: Set the initial speed of the special effect, which affects the movement speed of the special effect.
  • Particle Quantity: Set the quantity of particles included in the special effect.
  • Direction: Set the direction of particle movement in the special effect.

Camera

In DataMesh Studio, the camera is a role that exists by default in the scene, like a light source role. However, it has a distinct characteristic in that it cannot be added or deleted; it is a permanent element within the scene. 

The primary function of the camera role is to define a trajectory of motion and corresponding perspective changes. This allows viewers to observe the scene’s contents based on the specified viewing path. By adjusting the camera’s position, rotation, and field of view, you can achieve various lens and motion effects. This capability enables you to incorporate diverse perspectives into the scenario, resulting in a more immersive and captivating experience for users. 

Camera Attributes and Camera Movement settings are shown in the figure below:

Camera Attribute

• Whether to Use Mirror Movement: By default, it is disabled, which means the user’s camera movement setting will not take effect in the preview; when turned on, the camera movement setting will be applied in the preview of the scenario.
• Manual Control of the Lens is Prohibited: When the camera movement setting is enabled, if this option is checked, users are not allowed to adjust the camera angle in the preview of the scenario and can only view the scenario content according to the configured camera movement setting. If this option is not checked, users can freely adjust the camera angle in the preview of the scenario.

Camera Movement

There are two buttons under Camera Movement:

• Set Preset: This function adjusts the current scene editing view to the playback preview view that is consistent with the camera. You can use this function to further verify the effect of the camera view.
• Set Current: This function adjusts the playback preview view of the camera to the editing view that is consistent with the current scene. Compared to manually dragging the camera role to modify the camera movement, this function is more convenient. Users only need to adjust the scene to find a suitable view and save it, without the need to adjust the camera position and rotation.

Add camera movement in straight-line path

When the view in the scene needs to change, such as bringing the camera closer or further away from the target position, orbiting or hovering around the target position, etc., you need to add pose action for the camera. After adding the action, dragging the camera with the mouse will show a straight-line path from the camera role’s initial position to the mouse position. At the same time, moving or rotating the camera will refresh the camera movement effect in the attributes pane.

You can follow below steps to add camera movement in straight line: 

1. Click on the camera to select it, then navigate to the attributes pane and check Whether to Use a Mirror Movement. 

2. In the attributes pane, click the button next to the role name, then select Add Pose.

3. To add a new camera perspective, you can use either of the following two methods: 

a). Method 1: Drag the camera to a desired position and rotate it in the scene area. This will update the camera’s position and orientation, creating a new perspective. 

b). Method 2: Adjust the scene view to the desired perspective, then select the camera in the Roles pane. In the attributes pane, locate the Camera Movement section and check the Set Current option. This will set the camera’s position and orientation to match the current scene view, creating a new camera perspective. 

4. Repeat step 2-3 to add multiple pose adjustment actions, you can create a motion trajectory consisting of multiple straight-line segments, as shown in the figure below:  

Add camera movement in curved path

Camera movement in curved path is an advanced camera movement. By using at least three path points, you can freely configure the positions of these points to create various camera movements in curved path. Compared to camera movement in straight-line path, curved camera movements make your scenario more dynamic and visually impactful.

Camera movement in curved path is shown in the figure below:

To use curved camera movement, you need to enable the camera movement feature in Camera Attribute, and then add pose action to the camera. You can set Pose Adjustment parameters such as Rotate Along Path and Waypoint to achieve the desired curve path effect. 

Rotate along Path: The camera direction always stays aligned with the path direction.

Waypoint: Waypoints are the middle points of the path. By adding waypoints, we can determine the bending direction and curvature of the curve, achieving a smoother curve path. The starting point of the path is the initial position of the camera (the position of camera in last action or last scene). The end point of the path is the final position of the camera role in the current scene.

The steps to create a camera movement in curved path are as follows:

1. Click to select the camera in the Roles pane and choose Whether to Use a Mirror Movement in the attributes pane to enable camera movement.

2. Click the button next to the role name to Add Pose action to the camera.

3. In the attributes pane, set Duration and check Curved Path for the Pose Adjustment action. 

4. To create waypoints in DataMesh Studio, you can choose either of the following methods:

a). Manually create a waypoint using the camera position: Select the camera and manually adjust the camera position and rotation angle, then click Create a Waypoint at the Current Position to create a waypoint for the curved path.

b). Create a waypoint using the current viewing angle: After adjusting the scene view, select the camera and click Create a Waypoint at the Current Position, then click the Use Current button under the Camera Movement diagram. The view of this waypoint will consist with the current edited scene view.

5. Repeat step 4 to create all the waypoints that you need to create.

Role operations

Add a role

To add a role in the scene, you can select a resource from the Resources pane and drag it into the scene.

Hide or show a role

You can hide or show a role in the role list. Click  or  to toggle its visibility status.

Delete a role

To delete a role, you need to select the role in the first scene where it appears, and then click the delete button in the toolbar. This will delete the role in all scenes.

Note: You can only delete a role in the first scene where it appears.

Select a role

When you select any role, the selected role in the scene area will have an orange highlight effect with four corners and buttons to help you visualize and adjust the model and certain tool roles.

Adjust the pose of a role

When the role is in the state of the Appear action or Pose Adjustment, you can position and adjust the posture of the role by translating, rotating, scaling, and adjusting the height.

Here are the simple steps to perform these operations:

• • Translating: After selecting a role, you can drag it to move it forward, backward, left, or right on the plane to change its position. You can also manually input the X and Z coordinate values in the attribute area to fine-tune its position. When the selection box appears in pink, it means that the model cannot be moved in the current state, such as in scatter or section actions. Adding pose adjustment actions to the model can restore visual operations.
  • Scaling: After selecting a role, you can drag the corners of the selection box to change its size. You can also manually input the model ratio in the attribute area for precise adjustment.
  • Rotation: After selecting a role, click the rotation arrows above, below, or on the right of the border of the selection box, and drag the arrow to rotate the role along the three axes and change the angle. You can also manually input the rotation angle in the attribute area for precise adjustment.
  • Height adjustment: After selecting a role, you can click the double arrow on the left side of the border and drag the arrow up or down to adjust the height of the role. You can also manually input the Y-axis value in the attribute area to fine-tune the height.

Move a role via move tool

Using the move tool can quickly and accurately move the role along a straight line, especially when you need to move the role to a precisely positioned location.

Here are the simple steps to drag the role along a straight line using Move Gizmo:

1. Click Tools in the toolbar and select Move Gizmo.

2. Click the role you want to move.

3. In the Move Gizmo, click the cone-shaped arrow corresponding to the X, Y, and Z axis lines respectively, and drag it to move the role along that axis line.

4. After dragging the role to the desired position, release the mouse button to complete the move operation.

Multiselect roles

When you need to adjust multiple roles at the same time, you can use the multiselect operation. The multiselect operation is applicable to roles that can be transformed, such as position, rotation, and scaling (including parent and child roles). You can use the shortcut key Ctrland click on the role in the scene to select multiple roles or use Shift and click on two roles’ names in the role list to select all roles between them.

After selecting multiple roles, you can perform the following operations on them:

• • Move and rotate: Adjust the position and rotation angle of multiple roles by moving and rotating the multi-selected roles.
  • Copy and paste: Use Ctrl + C and Ctrl + V to copy and paste these roles.
  • Delete multiple selected roles: Click the delete button in the toolbar to delete multiple roles at once. Note: Child roles cannot be deleted.
  • Set the center point of multi-selected roles: You can set the center point of multi-selected roles in the attributes pane. The center point setting will affect the rotation method and result of multi-selected roles.
    • Public Center: Refers to the center point of the bounding box that contains all multi-selected roles. The default center point of the multi-selected roles is the public center.

• • • Assign Roles: Select the center point of a certain role in the multi-selected roles as the center point of the multi-selected roles.

Group roles

The grouping operation combines multiple roles into a single entity, creating a new group role. After the multi-selection operation, you can click the grouping button in the toolbar to group these roles together.

You can perform the following operations on the group:

• Move and rotate: You can adjust the position and rotation angle of the group by moving and rotating it. 
• Ungroup: After selecting a group, click the ungroup button   in the toolbar to dissolve the group. After ungrouping, the corresponding group entity in the role list disappears, and all roles in the group return to their state before grouping. If the group contains other sub-groups, the sub-groups will remain grouped after ungrouping.  
• Rename: The default name of a group is “Group” followed by a sequence number, such as Group1, Group2. After creating the group, you can modify the group name in the attributes pane. 
• Set the center point of the group: You can set the center point of the group in the attributes pane. The center point setting will affect the rotation method and result of the group. There are two ways to set the center point: 
  • Public center: Use the center point of the bounding box that contains all the roles in the group as the center point of the group. The default center point of the group is the public center. 
  • Assign Roles: Select the center point of a certain role in the group as the center point of the group. 

Note: When you click on a role in a group in the scene, the system will prioritize selecting the group. If you need to select a specific role in the group, click again to select that role. 

Scenes in DataMesh Studio is a kind of way to organize the content of a scenario. A scenario can consist of one or multiple scenes, each containing various elements such as 3D models, pictures, videos, music, light sources, and cameras. Each scene functions as a node within the scenario, allowing you to create, edit, and manage scenes effectively within DataMesh Studio.

Scenes play a vital role in DataMesh Studio as they provide a core foundation for editing and managing scenarios. They allow you to organize and control the content of a scenario in a more intuitive manner. You can easily switch between different scenes to ensure consistency and smooth transitions within your scenario. Scenes offer you a flexible approach to scenario creation, empowering you with more creative possibilities. 

Manage scenes

To manage scenes in DataMesh Studio, you can perform the following operations:

• • Create a new scene: Click the + button in the thumbnail area or right click on the scene in the thumbnail area and select Add Scene.

• • Delete a scene: Right-click on the scene in the thumbnail area and select Delete Scene.

• • Rename a scene: Select the scene in the thumbnail area and click the edit button in the attributes pane to rename the scene.

Use the scene catalog

In DataMesh Studio, the scene catalog is used to display the structure and chapters of the current scenario.

By clicking the scene catalog icon , you can browse the entire scenario, understand the scenario’s structure, and chapter content, and navigate to the desired chapter and scene.

The following are the basic operations on the scene catalog:

• • New Chapter: Each chapter in the scene catalog represents an independent scene or plot. In DataMesh Studio, you can right-click on a scene in the thumbnail area, select New Chapter, and the New Chapter window will open. Fill in the chapter name, and you can add a new chapter before the scene.

If you uncheck Scene content before inheritance option in the New Chapter window, you can create an empty scene. This means that the scene will not inherit any content from the previous chapter. It provides flexibility in creating the structure of your scenario.

• • Delete Chapter: To delete a chapter in the scene catalog, right-click on the chapter name in the thumbnail area and select Delete Chapter. This will remove the chapter and all its associated scenes from the catalog.
  • Edit Chapter: To rename a chapter in the scene catalog, right-click on the chapter name in the thumbnail area and select Edit Chapter. This allows you to modify the name of the chapter.

Navigate the scene area

In DataMesh Studio, the scene area offers various functions to help you adjust and explore scenes efficiently.

You can browse the scene area by using drag-and-drop and zoom operations. Here are some fundamental operations:

Orbit the scene

To orbit the scene, follow these steps:

1. Press and hold the right mouse button anywhere in the scene area. The cursor will change to a magnifying glass, and a blue visual reference will appear in the view.

2. Move the mouse horizontally to rotate the scene. This allows you to change the viewpoint and observe models from different angles, providing a comprehensive view of the scene.

Pan the scene

To move the scene horizontally or vertically, follow these steps: 

1. Click on an empty space within the scene area. 

2. While holding down the left mouse button, drag the mouse to the left, right, up, or down on the screen. 

3. Alternatively, you can press and hold the mouse wheel and drag the mouse in the desired direction to pan the scene. This method ensures that the left mouse button is not used for selecting objects in the scene, allowing the mouse wheel to be exclusively used for scene panning. 

Raise or lower the scene

To raise or lower the scene in DataMesh Studio, follow these steps: 

1. Press and hold the Shift key on your keyboard. 

2. Click and hold the left mouse button in an empty area of the scene area. 

3. Move the mouse cursor up to lower the scene or down to raise the scene.

Zoom in and out of the scene

To zoom in and out of the scene in DataMesh Studio, you can use the scroll wheel on your mouse. Here are the steps: 

1. Place the mouse cursor over the scene area. 

2. Scroll up the scroll wheel to zoom in on the scene. 

3. Scroll down the scroll wheel to zoom out of the scene.

Reset view

The reset view function is commonly used to restore the scene view and focus the camera on a specific role. Resetting the view automatically adjusts the camera position and angle, ensuring that the target role is fully presented in the center of the scene area. You can also switch the perspective to a specific role by double-clicking its name in the role list. 

The reset view function includes the following operations:

• • Reset scene view: Click the reset button located in the top right corner of the scene area to reset the current scene view to the default view. The default view is positioned above and in front of the scene, looking towards the center. 

• • Reset role view: After selecting a role, click the reset button in the top right corner of the scene area to adjust the view to a position in front and above the selected role. 

• • Focus on a role: Double-click the target role in the Roles pane to switch the current view to focus on that specific role. 

Scene gizmo

The scene gizmo is in the top right corner of the scene area. It consists of six sides representing the front, back, left, right, top, and bottom views. Each side displays a different orientation to help users navigate and understand the spatial layout of the scene. The gizmo provides a visual reference for the six directions, allowing users to easily manipulate and adjust their view accordingly.

The scene gizmo allows you to adjust the scene view with respect to either the scene center or a role center:

• • View Centered on Scene: When no role is selected, clicking on any side of the gizmo will maintain the same camera distance from the scene center. The scene center will serve as the view center, and the view will switch to the corresponding standard view direction.
  • View Centered on Role: When a role is selected, clicking on any side of the gizmo will maintain the same camera distance from the role center. The role center will become the view center, and the view will switch to the corresponding standard view direction.

Projection modes

DataMesh Studio supports two projection modes: perspective projection and orthographic projection. 

To switch the projection mode of the scene, you can click the projection toggle button in the scene area. 

1. Perspective Projection (Default) 

Perspective projection is a projection mode where objects appear smaller when they are farther away from the camera in the scene interface, and larger when they are closer to the camera. 

2. Orthographic Projection 

No matter how far the camera is, objects are shown in the same size. Orthographic Projection likes watching the scene from an infinite distance. It provides a more “technical” insight for the scene, which is easy to model and judge scale. 

Set scene transitions

In scenarios with multiple branching storylines, scene transitions are crucial for controlling the flow of the scenario. 

In DataMesh Studio, there are several ways to set scene transitions: 

1. Setting scene transitions in the attributes pane: You can configure scene transitions directly in the attributes pane. This allows you to define the transition type and specify the target scene. For more information, please refer to Set scene attributes. 

2. Using buttons for scene transitions: When editing buttons in DataMesh Studio, you can configure them to trigger scene transitions. During scenario playback, you can click on the buttons to transition to the specified scenes. For more details, please refer to Button.  

3. Using models or sub-objects for scene transitions: You can add transition links to models or sub-objects and set the target scene for the transition. During scenario playback, clicking on the model or sub-object will trigger the scene transition. For more details, please refer to Link. 

Set scene attributes

When you click the empty space in the scene area, the attributes pane will display the scene attributes. 

The attributes of a scene will be shown as follows: 

A: (the edit button) + the scene name. 

B: Scene Switch: 

a). When you Tap: When the user clicks on the scene, it will transition to the next scene. 

b). Auto Switch, After: Set a delay time (in seconds) for the scene transition. After the specified delay, it will automatically transition to the next scene. 

c). After checking: The scenario will transition to the next scene when this checkbox is checked by the user. 

C: Ground opacity: Set the opacity of the ground in the scene. 

A scenario is a project file created and edited in DataMesh Studio. It consists of multiple scenes, each containing user-added models, pictures, attachments, text, and tools etc. In a scenario, you can configure jumping connections between scenes to enable interactive scene transitions. The scenario file format is .dirpkg and can be created, edited, saved, imported, and exported within DataMesh Studio. Scenario management is available in the Digital Twin service module of the DataMesh FactVerse Services platform.

Create a new scenario

To create a new scenario, click the Create button on the homepage. This will open the scenario editing interface and create a new scenario. By default, each new scenario includes two light sources and one camera.

If you are editing scenario in the edit interface, you can create a new scenario by clicking on the File menu and selecting New Scenario. Note: In this situation, you will be prompted to save the currently edited scenario.

Open a cloud scenario

To open a cloud scenario, follow these steps:

1. Click Open on the homepage.

2. In the Open Scenario window, select a cloud scenario and click Open.

If you are editing a scenario in the edit interface, you can click the File menu and choose Open Scenario to open a cloud scenario. Note: In this situation, you will be prompted to save the currently edited scenario.

Save a scenario

To save a scenario to the DataMesh FactVerse Services platform, follow these steps:

1. In the edit interface of DataMesh Studio, click the save button , or go to the File menu and select Save.

2. If this is your first time saving the scenario, you will be prompted to enter a scenario name, select a storage path, and click the Confirm button in the Save Scenario window to save scenario.

Import a local scenario

To import a local scenario into DataMesh Studio, please follow these steps:

1. On the homepage of DataMesh Studio, click the Import button. This will open a window displaying your local resources.

2. In the local resources window, locate and select the scenario file you want to import, then click the Open (O) button.

3. The scenario will be opened in the DataMesh Studio edit interface, allowing you to view, edit, and save the scenario.

Export a scenario

To export a scenario, follow these steps:

1. Click on the File menu and select Export Scenario. This will open the Export Scenario window.

2. In the Export Scenario window, you can configure the export options, such as selecting to Export Scenario, Export in Paly Resources and Export Resource Acceleration Attachment.

Export Scenario: The exported scenario file only contains the basic scenario file and does not include the resources within the scenario. Note: To import and use this basic scenario file, you must have access to all the resources within the scenario.

Export in Play Resources: The exported scenario includes the basic scenario file and all related original resources (not accelerated). You can directly use the scenario after importing, but the related resources need to be reaccelerated.

Export Resources Acceleration Attachment: The exported scenario includes the basic scenario file, related original resources, and the resources acceleration attachment. You can use the scenario and the accelerated resources directly after importing.

Preview a scenario

DataMesh Studio supports three play modes:

• • Preview from the Beginning: In the edit interface, you can play the entire scenario using the following methods:

• • • • Click the Preview menu and select Preview from the Beginning.
      • Click the first scene thumbnail to set it as the current scene, and then click the play button .

• • Preview from Current Scene: In the edit interface, you can play the scenario starting from the current scene using the following methods:
    • • Select a scene thumbnail and click the play button .
      • Click the Preview menu and select Preview from Current Scene.
  • Preview the Current Scene: In the edit interface, select a scene, and click the Preview menu and select Preview the Current Scene to play current selected scene only.

The scenario will be played in full screen. Press Esc on the keyboard or click the close button in the top right corner of DataMesh Studio to exit the play mode.

Change the reflection environment of a scenario

The reflection environment of a scenario in DataMesh Studio refers to the background environment and lighting effects used to simulate light propagation, reflection, and refraction in the virtual scene. It influences the appearance, lighting, and shadow effects of objects, enhancing the overall realism and fidelity of the scenes.

By default, there is no specific reflection effect for newly created scenario in DataMesh Studio. You can create reflection environment of the scenario by choosing indoor or outdoor environments provided by the system, or by using a skybox to create a more authentic and immersive virtual reality experience.

To change the reflection environment, follow these steps:

1. Click the Scenario menu and select Change Reflection Environment. This will open the Select Reflection Environment window.

2. In the Select Reflection Environment window, choose one of the following options:

• • None: The default setting, where no specific reflection environment effect is applied.

• • Indoor: Suitable for indoor scenes, simulating the light reflection features of an indoor environment.

• • Outdoor: Suitable for outdoor scenes, simulating the light reflection features of an outdoor environment.

• • Customize: Allows you to select different skybox pictures to create a suitable environment background and sky effect for your scenario, catering to specific scene needs and creative purposes.

3. If you choose the Customize option, follow these additional steps:

i. Prepare six skybox pictures corresponding to the front, back, left, right, top, and bottom views. The pictures should be in PNG format and follow English naming conventions (Front, Back, Left, Right, Top, Bottom).

ii. Compress the pictures into a ZIP file and change the file extension to “.dmcm”.

iii. Go to the Resources page of the DataMesh FactVerse Services platform and upload the .dmcm file.

iv. In DataMesh Studio, click the Scenario menu, select Change Reflection Environment to open the Select Reflection Environment window.

v. In the Select Reflection Environment window, select Customize and locate the uploaded .dmcm file.

vi. After selecting the file, click the Confirm button to finish customizing the reflection environment.

Creating a scenario: Basic process

When creating and using a scenario in DataMesh Studio, please follow the steps below:

1. Define the scenario content

Define the scenes, steps, roles, data, and interactions that the scenario needs to express.

2. Upload resources

Upload 3D models and attachment resources required for scenario creation, such as audio, video, pictures, and PDF files.

• • Use DataMesh Importer or the FactVerse Services platform to upload 3D models.
  • Upload pictures, audio, and other resources through the FactVerse Services platform.

3. Create a new scenario

After logging in, create a new scenario where you can utilize the resources and tools in DataMesh Studio to create and edit 3D content.

4. Edit the scenario

i. Edit scenes: Organize the scenario content by using multiple scenes, scene catalog, and scene jumping.

ii. Add roles: Add various roles from My Resources and Libraries, including model roles, attachment roles, and tool roles.

iii. Edit role attributes: Select a role and modify its position, rotation, and scale.

iv. Add action and interaction: Add action and interaction effects to the roles.

v. Publish the scenario: DataMesh Studio enables one-click publishing of the content to the cloud.

5. Quick scenario preview

You can quickly preview a scenario by using the URL or QR code. Simply open the URL link in a browser or use DataMesh One to scan the QR code for an instant preview.

Note: Users must have access permissions to the directory where the scenario is located.

6. Remote coordination

With DataMesh One, you can engage in 3D MR coordinated operations remotely with other users.

Example: Create a digital twin scenario for illustrating a coffee machine

This example demonstrates how to quickly create a simple scenario with a coffee machine model and four scenes. We will apply tags, disappearance, scatter, and remove scatter actions to the coffee maker model, as well as incorporate some basic camera movements.

Prerequisites

The coffee machine model has been uploaded to the FactVerse Services platform.

Steps

1. Log in to DataMesh Studio.

2. Click Create on the homepage to create a new scenario.

3. Find the coffee machine model in the My Resources section on the left side and drag and drop it into the scene area.

4. Click on the coffee machine model in the scene and adjust its position, rotation angle and scale by using drag-and-drop and rotation operations.

5. Select the coffee machine model and set its Duration to 2s in the attributes pane.

6. In the Resources pane, click the Libraries tab. From the Libraries section, select Tag. Drag the tag to the scene area and drop it above the coffee machine model.

7. You can customize the tag by adjusting its size, moving the anchor, and modifying the text size and content.

8. Click the + button in the thumbnail area to create a new scene named “Scene_2”.

9. Add a “disappear” action to the tag in “Scene_2”. For more details, refer to Disappear.

10. Select the coffee machine model in the scene area and click Add Scatter in the action menu to add a scatter action to the model. For more details, please refer to Scatter.

Set the Scatter Type as Axial.

11. Create “Scene_3”. Select the coffee machine model in “Scene_3” and click Add Scatter.

12. Select the Reset checkbox in the scatter action to restore the coffee machine model to its initial status.

13. Add an Section action to the coffee machine model.

To configure the section action of the coffee machine model, you can move the section cube to adjust the section’s position.

14. Create “Scene_4” and select the coffee machine model. In “Scene_4”, we will implement the action of removing the section of the coffee machine model.

15. Click on Add Section to add a section action to the coffee machine model.

16. In the section settings of the attributes pane, check the Reset checkbox. To configure the removal of the section, adjust the position of the section cube and set the direction for quick sectioning (Preset).

17. Adjust the viewing angle of the scene and select the camera in Roles pane. Click Set current to save the current viewing angle. For more information on camera movements, refer to the Camera section.

18. In the thumbnail area, select the first scene and click  in the Menus to preview the scenario.

19. Click to save the scenario.