Customize spatial positioning methods

In DataMesh One, users are able to view DataMesh Studio scenarios in Mixed Reality. To ensure that the digital objects are to the desired scale relative to the real environment, DataMesh One users can change the size of the overall scenario and typically use all elements from the first scene to perform adjustments. To ensure that all digital objects are scale relative to each other, DataMesh Studio provides two tools to help scenario editors maintain spatial awareness while engineering their scenes: Reference Models and QR Marker.

Reference Models are transparent models that cannot be selected, edited, or moved unless you are in reference mode, and are completely invisible when the scenario is playing. They allow you to position your elements in relation to it, without interfering with your editing process.

Here is how to utilize reference models in your scenes:

1. To enter reference mode, select Scenario > Modify Scenario Positioning from the toolbar.

2. Find the model you would like to use as your reference model in the resources pane, then drag it into the workspace. In reference mode, you can freely position and adjust your reference model.

3. Once you are done, click the Quit button at the top right of your workspace to exit reference mode.

4. Play the scenario in DataMesh One and use joystick position scenario.

Note: In DataMesh One, the Position Reference setting needs to be set to First Frame, aligning with the first frame of the first scene in the script for positioning.

5. Click  to complete positioning.

QR Markers allow you to view your scenario in Mixed Reality through multiple locations in the virtual space. Each QR Marker corresponds to a QR code, and by scanning a physical copy of that code using DataMesh One, you can generate the digital elements found in your scenario. The layout and position of your roles depend on where you placed your QR Markers and which QR code you scanned. You can also toggle between horizontal markers for QR codes on the floor or a table, and vertical markers for QR codes on the wall.

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 menu 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 Elements pane and drag it to the desired location.

3. Click a blank space in the workspace 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.

Note: In DataMesh Studio versions 5.6 and up, the maximum number of markers you can add is 100. Otherwise, you can only add up to 10.

Clicking the Remove Marker button per time will sequentially delete a QR code within the scene from back to front.

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

5. Log in to DataMesh FactVerse Services, find the scenario and download the position QR code on the resources detail page.

6. Print the downloaded position QR 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

Actions are the basis of scenario expression and interactive capability.

Actions are the basis of scenario expression and interactive capability. After selecting an element, 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 element. Depending on the type of the element and its current state, the available action options may vary.

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

    1. Movement: Effects that alter the position, rotation, and size of the model or sub-elements.
    2. Disassemble: Action effects that disassemble or spread sub-elements within the model.
    3. Cross Section: Create a cross 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 another scene. Jump to the target scene by clicking the model.
    6. Color Change: Effects that change the color of the model or sub-elements.

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

Action Sequence: Multiple actions can be added to an element 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 elements, allowing you to define the position, rotation, and scale of an element when it appears in the scene, as well as the duration of the appearance.

When you add an element 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 element to further customize its appearance.

    • You can use the Position and Rotation settings to adjust the initial pose of an element. The Position setting determines the location of the element’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.

The Movement action can make the elements in the scene move along a straight or curved path, and change their position, rotation angle, and size through operations such as moving, rotating, and scaling. By adding movement actions, you can create various dynamic effects for elements, such as acceleration, deceleration, or uniform motion.

How to move an element in a straight path

The Movement action enables an element to move along a straight path.

Here are the steps to add and set the Movement action for an element to move along a straight path:

    1. Select the element you would like to move during the scene.
    2. Click the button next to the element’s name in the attributes pane and select the Movement option from the drop-down menu.
    3. Move the element in the workspace to change its position or fine-tune the movement parameters in the attribute area, and then set the Duration of the movement action.
    4. By selecting the Movement Type, set the speed of the movement 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.
      • Organic: The movement accelerates to full speed, maintains the speed, and then decelerates to rest.

How to move an element in a curved path

You can also use the Movement action to make an element move along a curved path.

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

    • Curved Path: This option is disabled by default. Enabling this option allows the role’s path to curve around control points.
    • Face the Path: When this option is enabled, the element will always face the direction that it is moving.
    • Control Point: These are points along the element’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 elements to move along a curved path in the movement action:

    1. Select the element you would like to move in the scene.
    2. Click the button next to the element name and select Movement.
    3. Check the Curved Path option.
    4. Adjust model position, rotation, and scale and click Create a control point at the current position.
    5. Repeat Step 4 to create other control points for the curved path.
    6. Adjust the position and curvature of the control point to make the curved path smoother.
    7. Configure Duration and Movement Type of the movement.
    8. Click the Play button to preview the effect of the movement action.
    9. Fine-tune the settings of the movement 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 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:

1. Select the model in the Elements 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 Disassemble action to any element that contains sub-elements. By default, the Disassemble action will expand all primary sub-elements under the element. You can set the disassemble effect for all sub-elements in a Disassemble action, or you can continue to add Disassemble actions for sub-elements that contain lower-level sub-elements, thereby achieving an outward-to-inward sequential expansion effect.

Add a Scatter action

To add a Disassemble action for a selected element or sub-element, click the button next to the element name in the attributes pane. Then, in the action menu, select Disassemble. This will add a Disassemble action to the element or sub-element.

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

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

Exercise 1

To achieve the Disassemble configuration for a monster model and one of its arms within a Disassemble 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 Disassemble in the action menu.

3. Configure Disassemble 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 Disassemble action for the arm, and set Disassemble Type, Range or Distance and Duration.

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

Exercise 2

To add a separate Disassemble 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 Disassemble in the action menu.

3. Configure Disassemble 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 Disassemble in the action menu.

6. Configure Disassemble 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 disassemble actions. The first disassemble action pertains to the Disassemble action effect of the entire monster model, while the second disassemble action specifically applies to the arm.

Reassemble

Reassembling means removing the Disassemble effect that has been applied to the model, thereby restoring it to its original state.

You can follow these steps to remove the Disassemble action:

1. Select the disassembled model in the workspace.

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

3. Check the Reset option.

4. This will cause all the previously separated sub-elements 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 cross section

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

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

2. Click the button near the element’s name in the attributes pane and select the Cross 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 cross section action as follows:

    • Animation Direction: 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.
    • Removal Corner: 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.
    • Removal Axis Angle: 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 it according to the effect.

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

1. Select the sub-element 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 Animation Direction is set to None.

Repair a cross 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 element that you want to repair.

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

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

4. Configure the Section action through the settings of Animation Direction, Removal Corner, Removal Axis Angle, 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 element you would like to attach a link to.

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

3. In the Link Settings in the attributes pane, make sure the Disable option is unchecked, and then select the scene you would like the model to be able to jump to using the Link Scene option.

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 an element during any scene after the scene where it was first placed.

The steps to add a Disappear action to an element are as follows:

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

2. Click the button next to the element’s name in the attributes pane and select the Disappear option. At this point, the element 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 element into its own center until it disappears and Left or Right makes the element move a short distance in the corresponding direction before vanishing.

The Color Changes action is an animation effect that enables an element 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 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 element that you want to change color during the scene.

2. Click the button next to the element’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 element to change to, the transform type, and the duration.

Transform Type

    • None: The color of the element will directly change to the specified color without any animation effect.
    • Gradual: The element’s color will transition into a new color over a period of time, creating a smooth and gradual change in color.
    • Flash: The element 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 element performs the action, its color will change according to the settings.

Elements

In DataMesh Studio, elements are all the various types of objects that you can incorporate into your scene. This ranges from 3D models to attachment resources, built-in tool models, expanded tools, light sources, cameras, and more. You can combine these elements together in order to create organic 3D scenes that can be used for display, training, and demonstrations.

In DataMesh Studio, you can convert a variety of 3D model files into models, which can then be found in your resources tab. 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

To utilize an external model in DataMesh Studio, you must first upload it through our FactVerse Services platform. There are two ways to do this:

    • Directly through FactVerse Services: 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.
    • 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.

Model element attributes

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 models, which include Appear, Model Attributes and IoT Data Binding.

Appear: This option controls how the model first appears onto the screen. For more detailed information, refer to Appear.

Model Attributes: These are settings specific to models, and can only be configured within the first scene that the model appears in.

    • Create Negative Space: This attribute causes an element to become “globally transparent” during Mixed Reality (MR) mode, which means that any part of a digital element that is behind the globally transparent element in the viewer’s perspective will become transparent as well. This is useful if you want to create a door that leads to a place that should not be physically possible.
    • Scale Multiplier: This is a model-only attribute that increases the sensitivity of the Scale attribute based on the number that you enter. This allows you to make models bigger and smaller than the normal scale attribute allows.

IoT Data Binding: This allows you to import external data regarding the behavior of the model in your scenario, such as model movement, rotation, and color changes. This primarily is used to establish a connection between models and digital twin objects. For more detailed information about IoT Data Binding, please refer to IoT Data Driven Instructions.

Attachment elements refer to 2D resources such as images, videos, audio files, and PDF documents. They provide additional instructions for model structures, operation flows, guidelines, and more. These resources serve as valuable aids in enhancing the scenario experience. To use attachment elements, 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 workspace of DataMesh Studio.

Images

Images in your scenario can be used as a background for your virtual environment, diagrams that showcase information that is hard to otherwise convey, and blueprints that present a secondary visual aid. This feature increases the effectiveness of your scenario, especially for visual learners.

Supported image formats in DataMesh Studio include JPG and PNG.

Always Face User: This toggles whether or not the image always faces the user, regardless of direction or viewing angle.

Audio

In DataMesh Studio, you can enhance the immersive experience of your scenarios by adding audio files that act as 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 element in the scene and click the delete button.

    • Background Music: This toggles whether this audio file is played in mono, where there is no sense of direction or dimensionality to the sound, or stereo, where the user’s position changes the direction and effect of the audio.
    • Hide During Scenario Playback: This toggles whether or not the audio file is visible when the scenario is in progress.
    • Autoplay: This toggles whether or not the audio file plays automatically.
    • Loop: This toggles whether or not the audio file restarts from the beginning once it has ended.
    • Volume: This allows you to adjust the volume of the audio file.

Video

There are still situations where you would want to include 2D videos in your scenario, such as functioning as a tutorial while the user follows the instructions in the virtual space or imitating a real-life screen to add realism to your simulation.

We recommend using MP4 and MOV formats for video files.

    • Always Face User: This toggles whether or not the video always faces the user, regardless of direction or viewing angle.
    • Autoplay: This toggles whether or not the audio file plays automatically.
    • Volume: This allows you to adjust the volume of the video file.

PDF documents

In DataMesh Studio, you can add PDF documents to the scene by dragging and dropping them from the resources pane. 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.

You can design and create custom tools in Unity following the provided tool production specifications. Afterward, use the DataMesh plugin to export your tools 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 the steps below to add an extension tool:

1. Open the zip file in the Importer and click the Save button to upload the file to the FactVerse Services platform.

2. Open the libraries tab in the resources pane of DataMesh Studio.

3. Click the ellipsis ︙ icon next to the Extensions header and select New Extension from the drop-down menu.

4. In the New Extension window, fill in Name, and Type and select the extension file from the server.

5. Once configured, you will see the newly added extension under the Extensions section.

DataMesh Studio comes with a multitude of built-in tools which can be found in the libraries tab of the resources pane. These tools can help users in scenario creation. The method of adding these tools is the same as adding regular models: direct drag and drop.

Text

Text is used for showing information, explaining a concept, or describing the purpose of an element in the scene.

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

Textbox

You can add a textbox via dragging and dropping it to the workspace. 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, alignment etc. After checking Always Face User, the text will always face the user regardless of viewing direction.

AI Assistant

The AI Assistant feature in DataMesh Studio is built upon the FactVerse AI capabilities of the FactVerse Services platform. Users can generate textual content through cconversation with the AI Assistant.

The workflow for using the AI Assistant is as follows:

1. On the FactVerse Services platform, create a knowledge base and an AI Assistant. If an AI Assistant is not configured, the system provides a default AI Assistant with no configuration. For more detailed information, please refer to the FactVerse Services User Manual.

2. In the workspace of DataMesh Studio, add a textbox.

3. Select the textbox, and in the right-side textbox attributes panel, you can see a FactVerse AI tool below the content box.

4. Click the switch icon to display a list of available AI Assistants for content generation. If there are no AI Assistants available for switching, the switch icon will not be displayed, and the system default AI Assistant will be used.

5. Enter a question, and the AI Assistant will automatically generate content and populate the textbox with it.

6. Click Text to speech button, and a Create audio window will pop up.

    • Language: The language of the audio file, currently supporting Chinese, English, Japanese, and Korean.
    • Gender: The gender of the voice for the audio.

7. After selecting the language and gender, click Confirm to create the voice.

8. Once created, you can click Audio Preview to listen to the generated audio. Clicking Confirm will add the generated audio content to the text box.

9. When editing the content of a textbox that already has generated audio, you will see a prompt saying, “The text content has been changed and does not match the audio.”
Note: This prompt will only appear once during editing. If you reopen the textbox, you will be reminded again when editing.

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 element.

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 workspace, and then configure the Website URL you want to embed in the attributes pane. During playback, the web tool will display the website on its screen. 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 other elements by identifying their horizontal planes. Stretching the four corners of the ruler aligns both ends of the ruler with the ends of the target element, and the measured length is displayed in the middle of the ruler.

Ruler Attributes

    • Auto Measure: When this is enabled, the actual measurement length of the ruler is displayed above it. 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.
    • Color: This sets the color of the ruler element.
    • Size: This sets the size of the ruler element.

Button

The button is a tool that can be used to display information and control the order and duration of scenes.

In the attributes pane, you can change the label of the button, adjust its size and color, and set which scene the button will travel to when pushed.

Guide

The guide element is a 2D row of arrows that travel forward in a straight line. DataMesh Studio provides four guide style options that change the appearance of the arrows, and you can also modify the size and movement speed of the arrows.

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, new scenarios come with two light source elements. They 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 element 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, Brightness and Generate Shadows or not etc.
    • Add movement to the light source: You can add movement to the light source element which is used to simulate light movement, such as sunrise and sunset, and headlights of a moving vehicle.

Light Source Types

Directional Lights: This type of light illuminates the entire virtual environment in the same direction and can be thought of as sunlight. The light’s source does not come from the element itself, but from a distant point outside of the environment which can be adjusted by rotating the element.

Point Lights: This creates a localized light source that illuminates the surrounding environment within a specified radius. Its brightness will decay with distance and will eventually disappear completely once you are out of its range. Point light is commonly used to simulate weaker light sources such as candles, lanterns, or light bulbs.

Spot Lights: This type of light narrows its range into a cone shape, similar to a flashlight. Its brightness also decays with distance, but the spread of its range will widen as well. Conical light is commonly used to simulate spotlights, flashlights, and classic desk lamps.

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.

Brightness

Brightness 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.

Generate Shadows

This option toggles whether or not elements generate shadows from this element’s light.

Shape

Our library also provides several 3D shapes for you to utilize, which include Pyramids, Spheres, Cylinders, Cubes, and Arrows. You can change the color of every shape, and there are multiple other customization options that are unique for each shape.

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

Symbols

Our library includes several universal symbols that may be relevant based on the needs of your simulation: Correct, Incorrect, Warning, and Electricity Hazard. Symbols are important because they can be applied to multiple different situations and their meanings are instantly comprehensible regardless of language barriers or literacy levels, making your scenario more accessible to all viewers.

Hand Gestures

Our library includes three types of 3D hand gesture models: Hold, Reach and Point. These elements can be used to convey meaning, machine operation instructions, and examples of what not to do. The hands can be swapped between left and right in the attribute panel, so that you can simulate both hands of the same person doing different things.

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 color, font size, alignment, title and select digital twins.

IoT data binding

Click + Select Twins, a Digital Twin list will pop up. This list displays all the digital twins’ names under this account and supports searching by the digital twin’s name. After selecting digital twins, the original + Select Twins UIwill change to the name of the selected digital twin. Click the name of the selected digital twins, you can select digital twins again.

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

Arrow

Our library includes many different arrows that can be applied to a multitude of different situations.

Special Effects

DataMesh Studio contains many special effects tools, including Lightening, Water Leak, Fire and Gas Leak.

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: Changes the color of the special effect.
    • Life Cycle: Sets how long the special effect exists, in seconds.
    • Initial Speed: Set the initial 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.

Similar to the light source element, all scenarios start out with one camera. However, the camera cannot be deleted, and more cameras cannot be added. Since the camera defines what the viewer sees from the scenario, there has to be exactly one in every scene. 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 viewers of your scenario.

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

Camera Attribute

    • Apply Camera Movement: This option is enabled by default, which means that any movement effects you have set for the camera will occur during the preview. If you are viewing a scenario made using previous versions of this application, you may need to deselect this due to compatibility issues.
    • Disable Preview Movement: This option is only available when the Apply Camera Movement setting is enabled. If this option is checked, users cannot move the camera during a preview, and can only follow the camera’s preconfigured path. If this option is not checked, users can freely adjust the camera angle during the preview.

Camera POV

There are two buttons under Camera POV:

    • Get Camera POV: This function changes your view of the scene to your camera’s current point of view.
    • Set Camera POV: This function changes the camera’s point of view to your current view of the scene.

How to move the camera in a straight line

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 element’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 Apply Camera Movement.

2. In the attributes pane, click the button next to the element name, then select Movement.

3. To add a linear movement to the camera, make sure that the Curved Path option is disabled. Then, you can use either of the following two methods:

a). Method 1: Drag the camera to where you would like it to move to, and you can rotate it to change its angle as well. You should see a blue and white line connecting the camera to its old position, which represents the path that the camera will take to reach its new location.

b). Method 2: Change your view of the scene to what you would like the next camera angle to be, then select the camera in the elements pane. In the attributes pane, press the blue Set Camera POV button that is located underneath the Camera POV This will bring the camera to your location and set the camera’s point of view as what you currently see in the workspace.

4. In the attributes pane, you can change both the duration value to control how fast the camera moves to its new location, and the movement type in order to control its acceleration along the path.

5. Repeat Step 2-4 to add multiple linear camera movements. You can create a motion trajectory consisting of multiple straight-line segments, as shown in the figure below:

How to move the camera in a 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 Movement parameters such as Face the Path and Control Point to achieve the desired curve path effect.

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

Curved Path: Enabling this option allows the camera’s path to curve around control points.

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

Control Point: These are points along the camera’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 camera movements.

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

1. Click to select the camera in the Elements pane and choose Apply Camera Movement in the attributes pane to enable camera movement.

2. Click the  button near the element name to add a Movement action to the camera.

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

4. To add a curved movement to the camera, make sure that the Curved Path option is enabled. Then, you can use either of the following two methods:

a). Method 1: Drag the camera along the path you would like it to follow and press the blue button Create a control point at the current position in the attributes pane when you would like the path to curve. You can also rotate the camera before doing so, and the camera will turn in that direction during the motion. Depending on your desired path, you may need to add multiple control points per curve.

b). Method 2: Click on the blue button Set Camera POV to change your view to the camera’s point of view. Then, move your view around the virtual environment in the same way you would like the camera to move, and use the Create a control point at the current position button to set control points when you would like to curve the camera in another direction. The more control points you set, the more accurate the camera will be when replicating your movements.

5. Repeat the previous step until you have achieved your desired movement. You can also edit the position and rotation of your camera during previous control points by selecting a control point, then adjusting the camera accordingly.

Add an element

To add an element to your scene, select the element from the resources pane and directly drag it into the workspace.

Hide or show an element

If you hover over an element’s name in the elements pane, a button will appear. Press this button to toggle the element’s visibility.

Delete an element

To delete an element, select it by clicking on its model in the workspace or its name in the elements pane. Then, press the delete icon in the toolbar or the delete button on your keyboard to remove the element from all scenes.

Note: Elements can only be deleted in their first appearance scene.

Select an element

To select an element, click on its model in the workspace or its name in the elements pane. A selected element will have an orange outline around it (blue for special elements like light sources and cameras), along with corner lines that can be dragged to change its size and buttons that can be dragged to rotate it or change its elevation. Dragging anywhere within the corner lines allows you to change the element’s position on the horizontal plane.

Adjust the movement of an element

When the element is in the state of the Appear action or Movement, you can position and adjust the posture of the element by panning, rotating, scaling, and adjusting the height.

Here are the simple steps to perform these operations:

    • Horizontal Movement: After selecting an element, you can drag it anywhere within the highlighted corner lines in order to move it across the horizontal plane. You can also manually change its X and Z coordinates in the attributes pane to fine-tune its new position. When the selection highlight is pink instead of orange or blue, this means that the model cannot be moved in its current state. This occurs when the element’s subcomponents are spread out due to the disassemble effect, or when the element is currently applying the cross-section effect.
    • Resize: After selecting an element, you can drag the corners of the selection box to change its size during the scene. You can also change its scale attribute, which will affect its size.
    • Rotation: After selecting an element, drag the rotation arrows above, below, or to the right of the selection highlight to rotate the element during the scene. You can also manually input the rotation angle in the attribute pane for precise adjustment.
    • Vertical Movement: After selecting an element, you can drag the double arrow icon to the left of the highlight up or down to adjust its vertical movement during the scene. You can also manually input the Y-axis value in the attribute pane.

Move an element via Directional Movement

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

Here are the simple steps to drag the element along a straight line using Directional Movement:

    1. Click Tools in the toolbar and select Directional Movement.
    2. Select the element that you want to move in a straight line during the scene.
    3. Three cone-shaped arrows will appear, which each correspond to an axis in the 3D space. Dragging an arrow will move the element along the corresponding axis in a straight line.

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

Multiple selection

When you need to perform the same action on multiple elements at the same time, you can use the multiple selection operation. To do this, hold down the Ctrl key and add elements to your selection by clicking their model in the workspace or their name in the elements pane.

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

    • Move and rotate: Adjust the position and rotation angle of multiple elements by moving and rotating the multi-selected elements.
    • Copy and paste: Use Ctrl + C and Ctrl + V to copy and paste these elements.
    • Delete multiple selected elements: Click the delete button in the toolbar to delete multiple elements at once. Note: Sub-elements cannot be deleted.
    • Set the center point of multi-selected elements: You can set the central point of all the selected elements in the attributes pane, which affects their behavior when rotated.
      • Central Location: The center point is the central location of the bounding box for all selected elements. It is a default option.

      • Central Elements: Select one element as the center point from the selected elements.

Group elements

The grouping function behaves like a more permanent form of multiple selection; it  combines multiple elements into a single entity and creates a new group element in the elements pane. To create a new group, select all elements that you would like to include, then press the group button  in the toolbar.

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: Select a group, then press the ungroup button  in the toolbar to disband the group. This causes the group element in the elements pane to disappear, and all elements previously in the group will now behave independently of each other. If you had groups within the disbanded group, those elements would remain grouped.
    • 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 central point of the group in the attributes pane, which affects their behavior when rotated.
        • Central Location: The center point is the central location of the bounding box for the group. It is a default option.
        • Central Elements: Select one element as the center point from the group.

Note: When you click on an element that belongs to a group, the system will prioritize selecting the group. If you need to select a specific element within the group, click on that element when the group is selected.

Scenes

Scenes in DataMesh Studio are the smallest unit of a scenario, with each containing various elements such as 3D models, pictures, videos, music, light sources, and cameras.

Scenes allow you to customize the structure of your scenarios, and you can easily switch between different scenes to ensure consistency and smooth transitions. In addition, you can group scenes together to form chapters, which can help you better organize your scenario.

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

    • Create a new scene: Click the + button in the timeline to add a new scene at the end, or right click on a scene in the timeline and select Add Scene to add a new scene to the right of the selected scene.
    • Delete a scene: Right-click on the scene in the timeline and select Delete Scene.
    • Rename a scene: Select a scene in the timeline and click the edit button in the attributes pane to rename the scene.

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

You can change your view of the workspace by dragging and zooming. Here are some fundamental operations:

Orbiting

To change your view of a scene around a central point, follow these steps:

1. Press and hold the right mouse button anywhere in the workspace. The cursor will change to a magnifying glass, and a blue highlight will appear.

2. Move the mouse in any direction to rotate your view around a central point. This allows you to observe models from different angles, providing a comprehensive view of the scene.

Panning

To move your view on a horizontal plane without changing its angle, follow these steps:

1. Click on an empty space within the workspace.

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 instead, leaving your left click free to perform other actions.

View height

To raise or lower your view, 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 workspace.

3. Move your cursor up to raise your view or down to lower your view.

Zoom

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

1. Place the mouse cursor over the workspace.

2. Scroll up to zoom in on the scene.

3. Scroll down to zoom out of the scene.

Focus

The focus function is used to center your view on a specific element, or on the very center of the virtual environment.

The focus function includes the following operations:

  • Scene focus: When there is nothing selected, click the Focus button located in the top right corner of the workspace to return your view back to its original starting position, which is centered at the very middle of the virtual environment.
  • Element focus: After selecting an element, click the focus button in the top right corner of the workspace to focus your view on the element from the front, and at a slightly elevated position. You can also do this by double-clicking the element in the elements pane at the bottom left of the screen, and focusing on an already focused subject moves your view even closer.

View cube

The View Cube is in the top right corner of the workspace and consists of six sides representing view angles from the front, back, left, right, top, and bottom. This allows users to quickly center their view on selected elements from different directions. In addition, the cube provides an intuitive visual reference for which direction you are facing, ensuring that users can easily reorient themselves when they need to.

The view cube allows you to center your view on either the scene, or a selected element:

    • Centered on the scene center: If no elment is selected, clicking on any face of the cube will focus your view onto the scene center from the direction that the face corresponds to.
    • Centered on the element: If an element is selected, clicking on any face of the cube will focus your view onto the element from the direction that the face corresponds to.

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 workspace.

1. Perspective Projection (Default)

Perspective projection is a projection mode where objects appear smaller when they are farther away from your view, and larger when they are closer.

2. Orthographic Projection

Orthographic projection is a projection mode where objects are the same size regardless of the distance away from your view. This provides a more technical view of the scene and is helpful when you want to easily access elements that are far away.

In scenarios with consecutive scenes in different locations, or if you would like to utilize dynamic camera movement, scene transitions are crucial for controlling the flow of the scenario.

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

1. 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. Buttons: This allows viewers to navigate between scenes while the scenario is playing. For more details, please refer to Button.

3. Elements: Links allow you to give elements navigational properties when interacted with them. For more details, please refer to Link.

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

The attributes of a scene will be shown as follows:

A. The scene name, along with a button  that allows you to rename the scene

B. Play Next Scene:

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

b). Autoplay After: This allows you to set a timer that every scene will follow, which is useful when you want every scene to be the same length. Once the timer runs out, the scenario will automatically progress to the next scene.

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

Scenarios

A scenario is a .dirpkg file created and edited in DataMesh Studio that consists of multiple scenes, each containing user-added models, pictures, attachments, text, and tools etc. In a scenario, not only you can compose and structure each scene, but also animate dynamic transitions in between the scenes. Scenario management is available in the Digital Assets service module of the DataMesh FactVerse Services platform.

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 a scenario file is already open, 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.

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 a scenario file is already open, you can open a cloud scenario by clicking the File menu and selecting Open Scenario. Note: In this situation, you will be prompted to save the currently edited 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 the 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.

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 by choosing between Export Basic Scenario, Export Full Scenario and Export Accelerated Scenario.

  • Export Basic Scenario: The exported scenario file only contains the basic scenario file and an index to its resources, but not the resources themselves. Note: To import and use this basic scenario file, you must have access to all the resources within the scenario.
  • Export Full Scenario: The exported scenario includes the basic scenario file and all its resources but does not include an accelerator. This option outputs a lower file size, but scenarios will take a longer time to load.
  • Export Accelerated Scenario: The exported scenario includes the basic scenario file, all of its resources, and the resource acceleration attachment. This option outputs a higher file size but takes significantly less time to load.

DataMesh Studio supports three play modes:

  • Start from Beginning: In the edit interface, you can play the entire scenario using the following methods:
      • Click the Preview menu and select Start from Beginning.
      • Click the first scene thumbnail to set it as the current scene, and then click the play button.
  • Start Preview: 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 Start Preview.
  • Current Scene Only: In the edit interface, select a scene, and click the Preview menu and select Current Scene Only to play the currently 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.

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

In DataMesh Studio, you can choose either the built-in rendering environment or customize the rendering environment for scenario creation, making the virtual scene realistic and immersive.

To change the rendering environment of a scenario, you can follow these steps:

1. Click on the Scenario menu and select Change rendering environment from the dropdown menu. You can open the Change rendering environment window.

2. In the Change rendering environment window, you can choose one of the following system-built rendering environments:

    • None: No specific environment rendering effects
    • Default
    • Cloudy outdoors
    • Empty hall
    • Streets in the city
    • Abandoned warehouse
    • Spacious and bright warehouse
    • Old and cluttered factory
    • Cozy and neat kitchen

You can also create a custom rendering environment to suit the scenario’s background and sky effects for different scene requirements and creative purposes.

Steps for custom reflection environment:

1. Prepare six images: These images should correspond to the front, back, left, right, top, and bottom directions of the rendering environment. The images should be in PNG format and follow English naming conventions (Front, Back, Left, Right, Top, Bottom).

2. Compress these images into a zip file and change its extension to .dmcm.

3. Upload this .dmcm file to the resource library on the DataMesh FactVerse Services platform.

4. In DataMesh Studio, click on the Scenario menu and select Change rendering environment from the dropdown menu to open the Change rendering environment window.

5. In the Change rendering environment window, select the Custom tab and click Select rendering environment.

6. In the window for Select rendering environment, find the uploaded .dmcm file.

7. After selecting the file, click the Confirm button to complete the customization of the rendering environment.

In DataMesh Studio, the table of contents is used to display a list view of the structure of scenes chapters in the current scenario.

By clicking the table of contents button , you can browse the entire scenario, grasp the overall structure and chapter contents, and quickly jump to the desired chapters and scenes.

The following are the basic operations on the scenario structure:

    • Start New Chapter: Each chapter in the table of contents represents a group of scenes. To start a new chapter, you can right-click on a scene in the timeline, select New Chapter, and a window will appear. Type in the chapter’s name, and this will make the selected scene a starting point for a new chapter.

Keep Elements: This option is a checkbox found in the New Chapter window that toggles whether or not you keep the elements from the previous scene. When checked, all the elements remained where they were. When unchecked, this converts the scene into a completely blank slate by removing all of its elements.

    • Delete Chapter: To delete a chapter, right-click on the chapter name in the timeline and select Delete Chapter. This will remove the chapter and all its associated scenes from the catalog.
    • Rename Chapter: To rename a chapter in the scene catalog, right-click on the chapter name in the timeline and select Rename Chapter.

Quick start

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

1. Define the scenario content

This includes the scenes, steps, elements, data, and interactions that the scenario needs to express.

2. Upload resources

Upload any 3D models and other resources that you will need for your scenario, such as audio, video, pictures, and PDF files. You can upload both 2D and 3D resources through our FactVerse Services platform, and if you need to edit a 3D model prior to uploading, our DataMesh Importer supports that.

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. Populate your scenario

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

ii. Add elements: Add various elements from My Resources and Libraries, including models, attachment elements, and tool elements.

iii. Edit element attributes: Select an element and modify its position, rotation, and scale.

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

v. Publish the scenario: DataMesh Studio enables easy publishing of the content to our servers.

5. Preview scenario

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: You 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.

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 the Create button on the homepage to create a new scenario.

3. Find the 3D coffee machine model in the My Resources section on the left, then drag and drop it into the workspace. This adds the model into the scene.

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 2 seconds in the Attributes pane. This sets the time that the 3D model takes to appear, and you can also set the duration of functions and transitions as well.

6. In the Resources pane, click the Libraries tab. From the Libraries section, select the Tag. Drag the tag to the workspace and drop it above the coffee machine model. You can customize the tag by adjusting its size, moving the anchor, and modifying the text size and content.

7. Click the + button in the timeline to create a new scene named “Scene_2”.

8. Add a “disappear” action to the tag in “Scene_2”. This ensures that the tag disappears during scene 2. For more details, refer to Disappear.

9. Select the coffee machine model in the workspace and click Disassemble in the action menu to separate all components of the coffee maker to easily see its inner workings. For more details, please refer to Disassemble.

Set the Disassemble Type as Axial, which organizes all sub-components into a line.

10. Click the + button again to create a third scene. Select the coffee machine model in “Scene_3” and click Disassemble.

11. Select the Reset checkbox in the disassemble action to reassemble the coffee machine model back to its initial status.

12. Add a cross section action to the coffee machine model.

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

13. Create “Scene_4” and select the coffee machine model. In “Scene_4”, we will implement the action of removing part of the coffee machine model to display a cross section. Click on Cross Section to add a cross section action to the coffee machine model.

14. In the attributes pane, tick the Reset checkbox. After the completing section, the coffee model will resume to original status. Adjust the position of the removal corner and removal axis angle of the removal cube.

15. Adjust your view of the scene so that the coffee machine is in the center of the workspace, then select the camera in the Elements pane. In the attributes pane, click the blue button Set Camera POV. For more information on camera movements, refer to the Camera section.

16. In the timeline, select the first scene and click   in the Menu to preview the scenario.

17. Click  to save the scenario.

Basics

System requirement

To make sure DataMesh Studio works well, the following content are minimum and recommended configuration requirements.

System

Minimum Configuration

Recommended Configuration

Windows PC

Software

  • Window10 or above
  • Direct3D 11.0 or above

Hardware

  • CPU: Intel®Core™i5-6200U 2.30Ghz
  • RAM:8GB
  • GPU: NVIDIA GTX 1050Ti

Software

  • Window10 or above
  • Direct3D 11.0 or above

Hardware

  • CPU: Intel®Core™i7-11700 3.60Ghz
  • RAM:16GB
  • GPU: NVIDIA GTX 3070

macOS

Software:

  • Monterey 12.0.1

Hardware

  • CPU: Intel Core i7
  • RAM:8GB
  • GPU: Intel Iris Plus Graphics 640

Software

  • Monterey 12.0.1

Hardware

  • Chip: Apple M1
  • RAM:16GB

Note: macOS platform supports Intel i7 and M1 chip, Intel i5 device is not supported any more.

Download

Please make sure you have downloaded the installation program beforebefore installing DataMesh Studio 6.1.

Download link for DataMesh Studio:

DataMesh Studio 6.1-Windows PC download short URL: datame.sh/Studio

Platform

App Store

URL

Windows PC

Microsoft Store

https://apps.microsoft.com/store/detail/datamesh-studio/9N57Q5SL7XKX?hl=en-us&gl=us

macOS

Apple Store

https://apps.apple.com/cn/app/datamesh-studio/id1525519778?l=en

iOS

Apple Store

https://apps.apple.com/cn/app/datamesh-studio/id1525519778?l=en

Before using DataMesh Studio, you need to request permission from the organization administrator. The administrator will add your user account, bind it to a department and position on the FactVerse Services platform, and grant you access to use DataMesh Studio along with other necessary functionalities.

The following picture shows the login interface:

  • Language: DataMesh Studio supports Simplified Chinese, English, Japanese, and Traditional Chinese.
  • Server List: This changes which server you connect to; we have servers located in Mainland China, Japan, and Singapore. Make sure that the server you connect to is the same one that your organization uses.
  • : Private Server icon. If your organization uses a private server, you will need to enter a code before logging in.
  • Third-party Login: For more information about third-party login, please refer to the specific section on Third-party login in the user manual.
  • Forgot Password: Click Forgot Password, open the server login interface to reset password.

Regular login

To log in to DataMesh Studio, use your FactVerse account and password on the login interface.

Steps

1. Open the login interface of DataMesh Studio.

2. Select the correct language and server.

3. If your organization has a private server, follow these directions below. Otherwise, skip to step 4.

a). Click the private server icon .

b). In the popup, enter the private server’s code.

c). Click Confirm return to the login interface.

4. Enter your FactVerse account and password.

5. Click the Login button.

a). If you have only one account, you will be directly logged in.

b). If you have multiple accounts, select the correct one from a list and you will be logged in.

Third-party login

DataMesh Studio supports using Third-party login methods for logging in, using Microsoft Entra ID, an identity and access management service, in order to enhance user security.

Steps

1. Open the login interface of DataMesh Studio.

2. Select the correct language and server.

3. If your organization has a private server, follow these directions below. Otherwise, skip to step 4.

a). Click the private server icon .

b). In the popup, enter the private server’s code.

c). Click Confirm return to the login interface.

4. Click the Microsoft third-party login icon, and then enter your third-party account and password to log in.

SMS verification login

When a company enables the dual authentication of account passwords and SMS in FactVerse Services, users are required to undergo an SMS verification process when logging into the DataMesh client and FactVerse Services platform. Upon the first login to DataMesh Importer, you will encounter a prompt asking you to bind your mobile number for login verification. You will need to log in to the FactVerse Services platform to complete the binding.

The steps for using SMS verification are as follows:

1. Open the DataMesh One login interface.

2. Select the correct language and server.

3. If your organization has a private server, follow these directions below. Otherwise, skip to step 4.

a). Click the private server icon .

b). In the popup, enter the private server’s code.

c). Click Confirm return to the login interface.

4. Enter your FactVerse account and password, then click the Log in button.

5. (Optional) Select the company your account belongs to: If you have multiple enterprise accounts, a list of company accounts will be displayed for you to choose from.

6. If the selected company has enabled dual authentication with FactVerse account passwords and SMS, the mobile phone you bound will receive a login verification code, valid for 5 minutes.

7. Enter the code to complete the login process.

There are two main user interfaces in DataMesh Studio: the Homepage and the Edit Interface.

Homepage

After a successful login, you will enter the homepage. From here, you can access recently edited scenarios, create new scenarios, open scenarios from the cloud, import local scenarios, clear cache, and upload logs.

The homepage supports the following functions:

    • Create scenario: Click the Create button to create a new scenario.
    • Open cloud scenario: Click the Open button to open a scenario from FactVerse Services.
    • Import local scenario: Click the Import button to import a local scenario (*.dirpkg) into DataMesh Studio.
    • Open a recently edited scenario quickly: This displays a list of your six most recent scenarios.
    • Upload log: This uploads the last seven logs to the FactVerse Services platform. Used for troubleshooting.
    • Clear cache: This gives you the option to clear all of your cache, or resources that are infrequently used.
    • Provide feedback: Click Provide Feedback to provide product feedback to service@datamesh.com.
    • Version: This shows you details about the current version of the application.
    • Log out: Select your username on the top-right corner of the homepage, and then select Log Out to log out.

Edit interface

In the edit interface, you can organize 3D models, edit, and arrange demo procedure of the 3D content demo.

The edit interface consists of the menu, toolbar, resources pane, roles pane, workspace, timeline, and attributes pane.

Menu

The menu contains all the tools and commands you may use when creating 3D content. The following table provides the instructions for each menu function:

Menu

Function

File

New scenario: Create a new scenario in the selected directory. If the current scenario has not been saved, you will be prompted to save it before proceeding.

Open Scenario: Open a cloud scenario from FactVerse Services. If the current scenario has not been saved, you will be prompted to save it before proceeding.

Save: Save the current scenario.

Save as: Save the current content as a new scenario in the selected directory.

Export Scenario: Export the scenario in dirpkg format and save it as a file.

Close Scenario: Close the current scenario and return to the homepage. If the current scenario has not been saved, you will be prompted to save it before closing.

Quit: Exit DataMesh Studio. If the current scenario has not been saved, you will be prompted to save it before exiting.

Edit

Undo: Revert the previous operation performed by the user.

Redo: Restore the previously canceled operation of the user.

Delete: Remove the selected element from the interface.

Scenario

Rename: Change the scenario’s name.

Set Cover Image: Upload a picture as the scenario’s cover image.

Change Rendering Environment: Support modification of scenario rendering environment. You can use built-in indoor and outdoor rendering environments or customize rendering environments. For more details, please refer to Change rendering environment.

Modify Scenario Positioning: This allows you to set a model as a reference, which proves helpful when you need to make edits in connection to a model without interfering with your process. For more details, please refer to Customize spatial positioning methods.

Modify Play Mode: The playback method for scenarios in DataMesh Learn can be set to page-by-page flipping. For more details, please refer to the Scenario play mode.

Assessment

Task: Attach a task to your current scene that viewers will have to complete. For more details, please refer to Interaction position and assessment.

Preview

Start from Beginning: Preview the scenario from the first scene.

Start Preview: Preview the scenario starting from the current scene.

Current Scene Only: Preview the current scene only.

Tools

Directional Movement: When enabled, each object has three cones when selected that allow the user to move that object in straight lines across the X, Y, or Z axis.

Performance Statistics: Display important statistics such as FPS, Memory Usage, etc.

Settings

Languages: Switch to different languages: Simple Chinese, Traditional Chinese, English and Japanese.

Account:

  • User account: Display currently the current user.
  • Log out: Log out of the current account.

Upload Log: Upload the last seven logs to our servers.

Rendering Quality: To adapt to different device performance, DataMesh One provides six different rendering quality options. Increasing the quality can optimize screen aliasing, ripple, and shadow effects.

  • 1 (Lowest Quality): The most basic rendering level, ideal for quickly viewing the model or when the device performance is limited.
  • 6 (Highest Quality): The best image quality and detail display, but it may significantly impact software performance.

About: Check current application version.

Toolbar

The toolbar provides quick access to frequently used tools and commands in DataMesh Studio.

Icon

Description

Homepage

Clicking the Homepage button to return to the homepage. If there are any unsaved changes in the current scenario, a prompt will appear asking if you want to save the current scenario before navigating back to the homepage.

Save

Save any changes made to the scenario since the last save.

Undo

Revert the previous action.

Redo

Redo the last action that was undone using the Undo function.

Group

Group together the set of currently selected elements. This group is then saved in the Elements pane.

Ungroup

Ungroup a previously grouped set of roles. If a group contains other groups, those groups will remain in the grouped state after ungrouping.

Copy

Copy the selected element, and grouped elements can also be copied.

Paste

Paste the most recently copied content.

Delete

Delete the selected role.

Preview
Preview a scenario.

Resources pane

The Resources pane is in the upper left window. You can adjust the size of the Resources pane by dragging the bottom or right edge of the window. Clicking on the Resources title can expand or collapse the pane.

The Resources pane can be divided into two sections: My Resources and Libraries.

My Resources

My Resources section contains a variety of resources uploaded by users, which can be used to build 3D scenes.

Filter: You can filter resources by tags in order to display all resources that have that tag.

Storage Directory: The file path to your current folder. Click  to return to the previous folder.

Search Bar: Use the search bar to search for the resource you are looking for.

Refresh: Click  to refresh resources materials. Any resources added before the refresh will appear.

Resources Status:

    • Uncached: A gray icon means that a resource has not been downloaded, and you must do so before you can use it in your scenario.
    • Downloading: Clicking on a grayed out resource will initiate the download process. The download progress will be displayed.
    • Cached: Once the material has been successfully downloaded, its icon will be highlighted. You can then drag and drop the material to the workspace.

Libraries

The Libraries section comprises built-in models and advanced resources created and added by users. If you do not have any available resources in My Resources, you can still experience DataMesh Studio using the built-in models available in Libraries.

Elements pane

The Elements pane is on the bottom left of the interface and contains all the elements in the current scene.

The Elements pane supports the following functions:

    1. Show/Hide: When you hover over an element, an icon will appear to the left of the role. Clicking on this icon will show a hidden element or hide a visible element.
    2. Select: Clicking on an element will select it.
    3. Focus: Double-clicking on an element will transport the scene viewer to its location.
    4. Resize: Dragging the right edge of the elements pane will adjust its size.
    5. Collapse: Clicking on the Elements pane header will collapse the pane.

Workspace

The workspace is in the middle of the interface and shows you the virtual environment of your scenes and scenarios. You can drag elements from the resources pane to the workspace in order to add them to your scenario. During playback, the elements in the scene will interact based on user-defined logic.

The workspace displays various elements that you have added into the current scene, including:

  • Light Source: By default, every new scenario contains two light sources .
  • Camera: By default, every new scenario contains one camera .
  • User-added resources, such as models in the scene.
  • Scenario name: The current scenario name is shown in the top-left corner of the workspace. The default format for scenario names is “Project-<date>-<number>”. You can change the scenario name when saving the scenario.
  • View cube : Located in the upper-right corner of the workspace, the view cube indicates the current viewing angle direction. Clicking the view cube allows you to switch between six views (front view, rear view, left view, right view, top view, and bottom view).
  • Focus button :

When no element is selected: Clicking the button will focus the view to the center of the scene, resetting the current scene view to the default perspective. The default perspective is positioned in the front and above, looking towards the center of the scene.

After selecting the element:

      • Clicking the focus button will switch the view focus to the selected element.
      • Clicking the focus button a second time will move closer to the selected element.
  • Projection switch button : Toggles between perspective mode, where objects appear smaller the further they are from your view, and orthographic mode, where objects remain the same size. For more details, please refer to Projection modes.
  • Table of Contents : Gives a list view of the order of scenes and chapters in the current scenario.

Attributes pane

The attributes pane is located on the right side of the interface and enables you to edit the attributes of scenes and elements. You can add actions to elements and configure their behaviors via the attributes pane.

The attributes pane is context-sensitive; it shows the attributes of anything that is selected. If nothing is selected, then the attributes pane will display attributes of the overall scene.

The following picture illustrates the layout of the attributes pane if a model is selected:

For more details about the parameters in the attributes pane, please refer to following sections:

    • Set scene attributes: This section introduces how to edit and configure scene attributes.
    • Elements: This chapter introduces various elements in the scenario and provides guidance on how to edit and adjust elements’ attributes.
    • Actions: This chapter helps you understand how to add and configure action effects for elements.

Timeline

The timeline is located directly below the workspace and contains thumbnails of all the scenes for easy recognition. The order of the scenes goes from earliest at the left to latest at the right. In addition, users can click on each thumbnail to quickly switch to the scene that the thumbnail represents. Here are the features of the timeline:

    • Add Scene: By right clicking and selecting this option, you can add a scene directly to the right of the selected scene. Additionally, you can add a new scene at the end of the timeline by clicking on the “+” button.
    • Delete Scene: Delete the selected
    • New Chapter: Create a new chapter.
    • Add Previous Scene: Add a previous scene to the current scene.

Additionally, you can navigate through the timeline via keyboard shortcuts:

    • ← switch to the previous scene.
    • → switch to the next scene.

The timeline provides an intuitive interface for managing and navigating scenes. It gives users the ability to easily locate and switch between different scenes and manage and adjust scene settings.

DataMesh Studio provides keyboard shortcuts to enhance user productivity. For example, using Ctrl + S allows you to quickly save their current project, while Ctrl + Z enables them to undo the most recent operation.

Operation

Windows

MacOS

New

Ctrl+N

Command+N

Open

Ctrl+O

Command+O

Save

Ctrl+S

Command+S

Save as

Ctrl+Shift+S

Command+Shift+S

Close

Ctrl+W

Command+W

Exit

Alt+F4

Command+Q

Paste

Ctrl+V 

Command+V 

Delete

Delete

Delete

Undo

Ctrl+Z 

Command+Z

Redo

Ctrl+R

Command+R

Group

Ctrl+G

Command+G

Ungroup

Ctrl+Shift+G

Command+Shift+G

New scene

Previous scene

Drag visual reference

Shift+left button

Shift+left button

Element range selection

Shift+ left button muti-selection

Shift+ left button muti-selection

Element disjointed selection

Ctrl+ left button

Command + left button

1.  Explore an expanded range of shortcut keys for improved workflow.

2. Receive timely updates through the update announcements feature (When there is a server maintenance and update plan, a one-time update notice will be displayed on the client).

Overview

DataMesh Studio is a 3D editing software that allows you to combine digital models with 3D elements in order to create scenarios that can be viewed in mixed reality. These scenarios are essentially 3D files that can be used to instruct, train, or test your employees on their performance in your workspace. In addition, you can upload real-time data to interact with models of your equipment in order to generate digital twins that simulate the behavior of their real-life counterparts. With support for our cloud storage service and management platform, DataMesh FactVerse, you can easily import and export resources and scenarios to your account.

Service Content of Each App + Cloud Platform

Cloud Platform

DataMesh services include digital twin management services, collaborative event services, model data, model acceleration services, data fusion services, AI intelligent generation services, and other services related to digital twin businesses provided to enterprise organization users.

1. Digital Twin Management Service

With digital twin management services, you can manage and maintain your digital twin assets. You can create and manage digital twin templates, attribute groups, digital twins, resources, behavior trees, scenes, etc., to manage the digital twin content of the virtual world. This provides comprehensive support for enterprise training, guidance, experience, monitoring, control, and simulation.

2. Collaborative Event Service

Collaborative events represent independent collaborative actions. You can use collaborative event services to create and manage events and participate in collaborative actions during scenarios and scene playback.

3. Model Data Service

You can convert your model files into usable model formats in DataMesh services through the model data service. The converted files can be directly imported into 3D editors.

4. Data Fusion Service

If you have purchased relevant services and obtained product feature permissions, you can access simulation data and real-time data through data fusion services. With data fusion services, you can integrate and process data from different sources (databases, APIs) for more comprehensive data analysis and insights.

5. AI Intelligent Generation Service

If you have purchased relevant services and obtained product feature permissions, you can build an enterprise private knowledge base and create knowledge assistants that meet business requirements. Additionally, you can generate voice resources based on your requirements during conversations and store them in the cloud for use in DataMesh client applications.

II. Studio

DataMesh services include cloud resource management services, 3D content creation services, custom spatial positioning services, assessment services, and reflection environment services provided to enterprise organization users.

1. Cloud Resource Management Service

With cloud resource management services, you can save your created 3D content to the cloud platform. Additionally, you can manage and maintain your 3D content assets through cloud resource management services.

2. 3D Content Creation Service

You can create the 3D content you need using DataMesh services. Additionally, you can organize 3D models and arrange demonstration processes through the editing interface to produce 3D content tailored to your business needs.

3. Custom Spatial Positioning Service

Through the custom spatial positioning service, you can position objects in real space during the process of creating 3D content. In DataMesh services, you can choose between two custom spatial positioning methods: reference model positioning and QR code positioning.

4. Assessment Service

With a DataMesh Learn license, you can use the position interaction and assessment functions in DataMesh services to create training and assessment scenarios. By defining interactive positions for roles, you can establish user interactions with the scenario, thereby creating scenarios with assessment tasks and scoring.

III. One

DataMesh services include 3D/MR content viewing, playback services, 3D content editing services, collaborative playback services, and offline mode services provided to enterprise organization users.

1. 3D/MR Content Viewing Service

With DataMesh services, you can browse 3D content, including models, images, PDF files, and pre-made scenarios, uploaded to the cloud platform. Additionally, you can display 3D content on virtual reality devices, smartphones, tablets, and other terminals for a more vivid, intuitive, and immersive presentation.

2. 3D/MR Content Editing Service

To enhance the playback and viewing experience, you can use the editing mode during the playback of 3D content. This allows you to adjust the position, size, rotation angle, and transparency of models or sub-objects, tools, and other resource content in scenarios during the playback of 3D content.

3. Collaborative Playback Service

Through collaborative playback services, you can engage in multi-user collaborative playback, facilitating collaborative learning and communication.

IV. Importer

DataMesh services include model viewing services, model material editing services, and cloud resource management services provided to enterprise organization users.

1. Model Viewing Service

Through DataMesh services, you can intuitively understand the hierarchical structure, node relationship structure, and basic attributes of imported models. This allows for a quick preview of how models will perform on different devices.

2. Model Material Editing Service

Within DataMesh services, you can easily modify the material properties of models. You can use various commonly used material spheres provided, including metal, wood, plastic, glass, marble, glazed, and concrete, to replace the original materials of the model. Additionally, you can adjust multiple attributes such as color, transparency, metallicity, and smoothness. These attributes can be adjusted individually or in combination, enabling you to easily achieve the desired effects.

3. Resource Cloud Management Service

The cloud resource management service supports one-click uploading of models to the cloud resource library, facilitating team collaboration and resource sharing. Manage and maintain your 3D content assets through the cloud resource management service.

V. Designer

DataMesh services include digital twin content creation services, cloud resource management services, and assessment services provided to enterprise organization users.

1. Digital Twin Content Creation and Preview Service

You can use DataMesh services to create and edit digital twin scenes, allowing accurate simulation and visualization of real-world scenes. Additionally, you can connect to business systems, organizing and driving scene operations based on actual scenario data.

2. Cloud Resource Management Service

Save your created digital twin content to the cloud platform. Manage and maintain your digital twin content assets through the cloud resource management service.

3. Assessment Service

With a DataMesh Learn license, you can use the assessment functionality within DataMesh services to create training and assessment scenes. By assigning tasks and positions to the digital twin, you can create scenes with assessment tasks and scoring.

VI. Checklist

DataMesh services include patrol inspection and spot check services provided to enterprise organization users.

Through the use of the patrol inspection and spot check service, you can regularly or systematically inspect, assess, and maintain equipment, systems, facilities, or areas to ensure normal operation, prevent potential issues, and promptly discover and resolve abnormal conditions that may affect safety, performance, or functionality. Also, you can view inspection records and equipment statistics on the FactVerse Services platform, understand the overall condition of equipment and tasks, and provide opinions on task completion through annotations.

VII. Inspector

DataMesh services include Level of Detail (LOD) grading rendering viewing services, Mixed Reality (MR) visualization services, cloud data storage services, and collaborative services for enterprise organizational users.

1. LOD Grading Rendering Viewing Service

You can use the LOD grading rendering viewing service to dynamically adjust the model accuracy and image continuity during the scene rendering process.

2. 3D/MR Content Viewing Service

Through 3D/MR technology, you can map 3D architectural scenes and engineering information to the real environment of the construction site, greatly enhancing the spatial experiential sense in design, construction, acceptance, and other stages.

3. Collaborative Service Based on On-Site Annotation Inspection

Collaborative services support users at various stages to share various types of data based on the same building scene, realize simultaneous data sharing on mobile devices and the FactVerse cloud platform, and support the transfer of inspection data to the CMS system, assisting in subsequent on-site construction management work.

User Agreement Standard Template – Using Cloud Platform as an Example

DataMesh Service Agreement

Updated Date: November 20, 2023

Effective Date: November 2x, 2023

Welcome to use DataMesh products and services!

Note: Before using DataMesh services, you should carefully read and comply with the “DataMesh Service Agreement” (hereinafter referred to as “this Agreement”). Please carefully read and fully understand the content of each term, especially the terms that exempt or limit liability, dispute resolution, and legal applicability. Terms that exempt or limit liability will be displayed in bold, and you should pay special attention to them.

By following the prompts on the registration page, enterprise organization creation page, or other informational cues, and by agreeing to this Agreement and completing the account registration or enterprise organization creation, or by actually using the services in a manner permitted by DataMesh, you hereby acknowledge that you have fully read, understood, and accepted all the terms of this Agreement. This Agreement shall then become legally binding, and henceforth, you shall not claim the invalidity of this Agreement or request its revocation on the grounds of not having read its contents or not receiving satisfactory answers from DataMesh to your inquiries.

I. Definitions

  1. This Agreement: Refers to this “DataMesh Service Agreement.”
  2. Enterprise Organization User: Refers to the administrator authorized by the enterprise organization to create the enterprise organizational structure, invite organization members to log in to DataMesh accounts as enterprise organization users, or configure enterprise accounts for users. After completing the creation of the enterprise organization, authorized administrators of the enterprise organization configure, activate, manage, and use DataMesh products. DataMesh enterprise organization users include but are not limited to legal entities, organizations, partnerships, or individual businesses.
  3. User: If an individual accepts this Agreement on behalf of themselves, “User” refers to that individual. If an individual accepts this Agreement on behalf of a company or other legal entity, “User” refers to the individual for whom the customer has ordered the services (or provided services, applicable to any free services provided by DataMesh) and authorizes them to use the services. For example, the user may include the customer and third-party employees, consultants, contractors, and agents who have business dealings with the customer. For example, the user may include the customer as well as employees, consultants, contractors, and agents of third parties who have business dealings with the customer.
  4. Personal Information Processor: Refers to the organization or individual that, as an enterprise organization user, has the right to decide the purpose and method of processing personal information during the use of DataMesh services for online 3D content creation, resource uploading, business data uploading, processing, 3D/MR content experiences, etc. When enterprise organization users and their administrators use DataMesh services for functions such as data uploading and 3D/MR content experiences, the personal information processor is the DataMesh enterprise organization user. DataMesh, based on administrator operations, configurations, and instructions, is entrusted to collect, store, use, process, transmit, provide, disclose, delete, and handle enterprise organization-controlled data.
  5. Personal Information: Refers to any information in customer data that directly or indirectly pertains to or is associated with (or can reasonably be considered to directly or indirectly pertain to or be associated with) a specific individual.
  6. Customer Data: Refers to electronic data and information related to services provided by customers or to customers, excluding non-DataMesh application information.
  7. Intellectual Property: Refers to any materials and any intellectual property created, conceived, written, created, developed, practiced, or delivered by DataMesh in the process of providing professional services mentioned in this Agreement, including but not limited to all designs, text, graphics, images, DLC models, any reports, computer software and/or software documentation, and other content excluding your content.
  8. Documents: Refers to the content in the help support accessible through the service. https://www.datamesh.com/support/

II. Contracting Parties

  1. This agreement is a contract jointly entered into by enterprise organization users (including administrators and users) and the DataMesh service provider regarding the user’s download, installation, and use of this software, as well as the use of related DataMesh services.
  2. Enterprise organization users and their administrators are collectively referred to as “users” or “you.”
  3. The DataMesh service provider includes DataMesh and other affiliated companies providing services related to DataMesh. The above-mentioned DataMesh service providers are collectively referred to as “DataMesh,” “us,” and “we.”
Region of Enterprise TenantContracting EntityAddress
Mainland China and Hong Kong-Macao regionDataMesh(Beijng) Technology Co., Ltd.Room A492, 4th Floor, Building 14, Cuiwei Zhongli, Haidai District, Beijing, China.
JapanDataMesh CorporationRoom 404, Ningyocho bld, Tensho Nihombashi, Ningyocho 3-3-5, Nihombashi, Chuo-ku, Tokyo
United StatesDataMesh Inc.1400 112th Ave SE, Suite 100, Bellevue, Washington, 98004, USA
Other regionsDataMesh Pte. Ltd.298 Tiong Bahru Rd, #05-01, Singapore 168730

III. Agreement Content and Effectiveness

  1. Acceptance of these Terms

If you access or use this service, it means you agree to be bound by all the following terms. Therefore, before using this service, please read all the terms. If you do not agree to all the following terms, please do not use this service. Additionally, if you find any term unreasonable, please inform us via the following email: compliance@datamesh.com.

  • Modification of these Terms

We reserve the right to modify these terms at any time. For example, if we introduce a new feature or for other reasons, we may need to modify these terms.

Whenever we make changes to these terms, these changes will take effect when we post the revised terms (indicated by the date at the top of these terms) or when you accept them; if we provide a mechanism for you to immediately accept the revised term, you are responsible for checking the updated agreement text after revisions to understand the changes to these terms.

If you continue to use this service after the revised terms take effect, you have accepted the changes to these terms.

IV. Service Content

  • DataMesh Service Content
  • DataMesh services include DataMesh client applications, server cloud platforms, and the integration of certain DataMesh features/services as third-party services in other software or hardware. The above is collectively referred to as “DataMesh services,” subject to the specific form of service implementation.
  • In this service, DataMesh provides various application versions, including but not limited to those for Windows, Mac, iOS, Android, and other operating systems (specifically based on versions provided by DataMesh). Users can choose to install the software version that matches their terminal devices. DataMesh will continuously update application versions. If a user has registered and used one version of the service, they can use other versions of the service under the same account. This agreement automatically applies to all versions of software and services used by the user.
  • DataMesh Service Form
  • Delegated Data Processing Services
  • Delegation of Enterprise Control Data Processing

Regarding the opening and use of relevant DataMesh services by enterprise organization users and administrators, DataMesh will process enterprise organization control data submitted or generated during the user’s use of DataMesh-related functions/applications based on the administrator’s actions and instructions. This includes 2D resources such as text, images, videos, audio, photos, and 3D content.

  • Delegation of User Personal Information Processing

Regarding the personal information of users involved in enterprise control data, enterprise organization users and their administrators understand and agree:

  • Delegated processing: In the process of using enterprise organization services, the user’s personal information published or transmitted by the user, necessary for the conclusion and performance of the contract, or necessary for the implementation of human resources management through legally established labor rules and labor contracts signed with the user, can be processed by enterprise organization users as personal information processors, and DataMesh, based on reasonable necessity, can process the user’s personal information through delegation.
  • User information processing restrictions: During the existence of DataMesh enterprise organizations and the collection, storage, processing, and transmission of enterprise organizational control data through the implementation of DataMesh services, DataMesh will not share enterprise organizational control data without the consent of the enterprise organizational administrator.
  • Without ambiguity, in the case of enterprise self-built application services and other third-party application services, enterprise organization users and their administrators act as user personal information processors. DataMesh provides platform technology services to enterprise organization users and third-party service providers. DataMesh does not bear joint responsibility for the processing of user information by third-party application service providers.

IV. Software Updates

  1. In order to improve user experience, and enhance service content and forms, DataMesh will continuously strive to develop new services and provide users with software updates from time to time. This may include software replacement, modification, feature enhancement, version upgrades, and other forms.
  2. To ensure the security and consistency of this software and service functionality, DataMesh reserves the right to update the software without special notice to users. This may involve version updates, changes, or restrictions to certain software functions or effects. Users may be required to update to the latest version of the product promptly.
  3. Users understand and agree that DataMesh may notify users of software updates through announcements, update logs, etc., on the DataMesh official website or DataMesh client pages. DataMesh is not obligated to provide users with special notifications regarding software updates.

V. Account Registration and Management

(I) Account Registration

You can log in and use DataMesh services through two methods: (1) using third-party app accounts approved by DataMesh (also known as “third-party authorized accounts”); (2) using enterprise accounts configured by enterprise organizations (“enterprise accounts”).

(II) Account Rights and Responsibilities

  1. Administrator Account Management Rights and Responsibilities

(1) The administrator account represents the account of the enterprise organization. Please ensure that you have obtained full authorization from DataMesh enterprise organization users and can act on behalf of DataMesh enterprise organization users for daily internal management work. It is reasonable to believe that you have signed service agreements, privacy policies, or other similar agreements or rules with the enterprise or organization you are associated with, and you are bound by them. Disputes arising from this shall not be our responsibility.

(2) The administrator account has user management, permission management, and other privileges. The operations and instructions performed by the administrator account will be considered as representing the will of the enterprise organization. Enterprise administrator account users have the right to manage users under the enterprise account.

(3) Administrator Declaration and Warranty:

When inviting organization members to join the DataMesh enterprise organization, administrators should ensure that they fully explain the basis for the invitation (such as the necessity for fulfilling contracts as an individual party or the necessity for implementing human resources management).

Administrators should safeguard business secrets learned during the use of DataMesh services, protecting user personal information, personal privacy, and other rights and interests.

As an administrator or sub-administrator of the enterprise organization user, you are responsible for your actions. The consequences of DataMesh providing or modifying services based on your actions are your responsibility. If losses occur to DataMesh or others due to this, you should compensate for them.

(4) You are obliged to properly safeguard the administrator account and password and should not disclose them to others under any circumstances. If you suspect that someone else is using your administrator account, you should notify DataMesh immediately. You should pay attention to improving the security of your devices and network. In case of theft of the administrator account, unauthorized personnel gaining administrative rights due to misoperation, etc., you are responsible for it.

(5) When you create an account or log in to this service using other services, you agree to maintain the security of your password and accept all risks of any unauthorized access to any data or other information you provide to this service. If you discover or suspect any security vulnerabilities in this service, please let us know as soon as possible.

VI. DataMesh Service Usage Guidelines

  1. This service allows you and other users to provide content through posting, linking, and other means. You are responsible for the content you provide in this service, including its legality, reliability, and appropriateness.
  2. When you provide content through posting, linking, or other means in this service, you grant us the rights and licenses to use, copy, modify, and format your content on or through this service. We may adjust the format or storage method of your content for display throughout the service, but we will not edit or modify the substantive content of your content itself.
  3. In addition to our limited rights to your content, you retain all rights to the content you post, link, or otherwise provide on this service.
  4. You can remove it by deleting the content you’ve posted. Once you delete your content, it will no longer appear on this service. However, copies of the deleted content may be retained in our system or backups for a period of time.
  5. You may not post, link, or otherwise provide any of the following content on this service:
  6. Defamatory, slanderous, biased, fraudulent, or deceptive content;
  7. Illegal or unlawful content that may result in liability;
  8. Content that may infringe or violate any party’s patents, trademarks, trade secrets, copyrights, privacy rights, publicity rights, or other intellectual property or other rights;
  9. Mass or repetitive promotional activities, political propaganda, or commercial information targeting users who are not following you (spam);
  10. Private information of any third party (e.g., addresses, phone numbers, email addresses, social security numbers, and credit card numbers);
  11. Viruses, damaged data, or other harmful, disruptive, or destructive files or code.
  12. Additionally, you agree not to do any of the following on this service or to other users:
  13. Use this service in a manner that may interfere, disrupt, negatively affect, or inhibit other users from fully enjoying this service, or that may damage, disable, overburden, or impair the operation of this service;
  14. Interfere or damage this service or the servers and networks connected to this service, or violate any rules, procedures, policies, or regulations regarding the connection networks of this service;
  15. Modify or falsify instructions or data during software operation, add, delete, or alter the functionality or performance of the software, or operate or disseminate software or methods used for the above purposes, whether or not these actions are for commercial purposes;
  16. Interfere with the software, its components, modules, data, etc., either on your own, authorizing others, or utilizing third-party software
  17. Collect any personal information of other users, or intimidate, threaten, track, or harass other users of this service in any way;
  18. Evade or attempt to evade any filters, security measures, rate limits, or other features designed to protect the functionality of this service, its users, or third parties.

VII. DataMesh Intellectual Property

DataMesh has invested significant effort in creating the DataMesh service, including logos and all designs, text, graphics, images, DLC models, and other content (excluding your content). This property is owned by us or our licensors and is protected by applicable copyright laws and regulations. We grant you the right to use it.

However, unless explicitly stated, your rights do not include:

  • Modifying the service or any part of it in a manner not permitted by DataMesh.
    • Using any data mining, robots, or similar data collection or extraction methods.
    • Reverse engineering or accessing the service to build a competitive product or service.
    • Using the service for purposes other than its intended purpose. If you do any of these, we may terminate your use of the service.

VIII. DataMesh Enforcement Regulations

1. You agree and accept that DataMesh has the right to monitor your use of the service. Following laws, regulations, and the relevant provisions of this agreement, DataMesh may take corresponding measures, including but not limited to deleting information, suspending or terminating services, and reporting to relevant authorities.

2. If you violate laws and regulations, infringe on the legitimate rights of third parties, or violate this agreement and related rules, DataMesh has the right to verify, notify, delete, block, and take measures such as reclaiming accounts, restricting, or terminating the use of part or all of the services according to relevant laws and regulations. This may also include public disclosure and reporting to authorities.

3. If you use DataMesh’s paid services, DataMesh has the right to suspend/terminate the corresponding service without assuming breach liability until you correct the violation.

4. If the content you publish or actions you take result in third-party lawsuits, complaints, claims, or adverse consequences leading to penalties against DataMesh, you shall bear full responsibility and indemnify DataMesh from any damages. Additionally, you shall compensate DataMesh for any losses incurred.

IX. Service Fees

1. Any free trials, free features, and services provided by this service should not be considered as DataMesh giving up the right to charge in the future. DataMesh has the right to notify you of the charging standards and methods through announcements on the DataMesh website or specific DataMesh service applications seven days in advance. If you continue to use the relevant DataMesh services, you are required to pay the corresponding fees according to the charging standards published by DataMesh.

2. DataMesh has the right to unilaterally adjust the fee standards and charging methods seven days in advance based on actual circumstances and notify you in the form of announcements without obtaining your prior consent.

3. You are responsible for paying for internet access, data traffic, and other communication fees charged by third parties when using this service.

X. Suspension or Termination of Service

1. Due to the special nature of internet services, DataMesh has the right to change the service content, suspend, or terminate all or part of the service (including free or paid services). Notice will be given through announcements on the DataMesh website or other official channels.

2. You understand and agree that DataMesh may regularly or irregularly maintain or inspect the platform equipment, facilities, and software and hardware providing network services. If the fee-based service is suspended for a reasonable time due to such circumstances, DataMesh is not liable after providing advance notice.

3. In case of any of the following breaches, DataMesh has the right to immediately suspend or terminate the service and request compensation for losses:

  • User violation of the account registration and management obligations in this agreement.
  • User failure to pay the corresponding service fees when using fee-based network services.
  • User violation of the obligations stipulated in the DataMesh service usage guidelines in this agreement.

XI. Privacy Policy

1. DataMesh makes efforts to adopt various reasonable physical, electronic, and managerial security measures to protect your information, ensuring that the information and communication content stored in DataMesh are not leaked, damaged, or lost. Strict management measures are also taken for employees or outsourced personnel who may have access to information. DataMesh will provide corresponding security measures to protect your information according to existing technology, providing reasonable security guarantees. DataMesh will do its best to prevent your information from being leaked, damaged, or lost at any time. However, please be aware that there are no absolute perfect security measures on the information network. Please handle relevant information carefully.

2. You should keep your DataMesh devices, accounts, and passwords safe and properly manage related information and content. You are responsible for data loss or theft caused by your own reasons and for the deletion or storage failure of related data in this software and service.

3. For specific privacy terms, please refer to the “DataMesh Privacy Policy.”

XII. Limited Liability

1. The service will be provided “as is” and “as available.” DataMesh makes no promises or guarantees regarding the effectiveness, accuracy, reliability, stability, completeness, and timeliness of the technology and information involved in the service.

2. Under no circumstances will DataMesh be liable for consequences such as inability to use or delayed services, data loss, system failures, etc., due to network connection failures, equipment failures, communication system failures, power failures, hacker attacks or network attacks, strikes, riots, fires, natural disasters, wars, government actions, orders from international or domestic courts, or third-party inactions.

3. Regardless of foreseeability and the form of action, DataMesh will not be liable for indirect damages (including but not limited to loss of profits or interest, business interruption).

4. You fully understand and agree that due to the special nature of the internet, the information and personal data you share in the service may be copied, reposted, or used for other purposes by others. You are fully aware of the existence of such risks, and you confirm that such risks should be entirely borne by you, and DataMesh is not liable for this.

XIII. Breach Liability and Compensation

1. If we find or receive reports from others that you have violated the provisions of this agreement, DataMesh has the right to delete, block relevant content without notice, and take measures including but not limited to restricting, suspending, terminating your use of DataMesh accounts and services, restricting, suspending, or terminating part or all of the services without assuming breach liability.

2. You agree that if you upload, transmit, or share information through the service, use other functions of this service, violate this agreement, or infringe on the rights of others, leading to any third party making claims or requests to DataMesh and its affiliated companies, or if DataMesh and its affiliated companies suffer any losses as a result, you agree to fully compensate (including but not limited to reasonable attorney fees).

XIV. Effective Notice

1. Any notice from DataMesh to you can be delivered by email, page announcements, personal prompts, mobile messages, or mail, and such notice shall be deemed to have been delivered or become effective within seven days from the date of sending.

2. You agree that any notice you send to DataMesh should be directed to the official contact information, communication address, email, or other contact information publicly disclosed by DataMesh, as notified to users through the method described in Article XVI, or by using other notification methods recognized by DataMesh.

XV. Dispute Resolution and Others

1. The interpretation and application of this agreement, as well as disputes related to this agreement, shall be handled under local laws and regulations, excluding the application of any conflicting laws. Jurisdiction belongs to the court/enforcement agency with jurisdiction over the place where this agreement is signed.

2. If any provision of this agreement is deemed invalid or unenforceable, the remaining parts shall still have legal effect.

3. DataMesh waives the rights granted by this agreement in case of user negligence or breach of contract, which shall not be construed as DataMesh waiving the right to exercise corresponding rights in the event of similar user negligence or breach of contract in the future.

4. This agreement shall supersede all prior oral and written agreements, arrangements, understandings, and communications between the parties on any matters related to this agreement.

5. You understand and agree that DataMesh has the right to independently decide on business strategies and transfer all rights and obligations under this agreement to its affiliated companies based on business adjustments. The transfer will be notified in the manner specified in this agreement.

XVI. Feedback and Contact Information

Please let us know your views on the service, these terms, and DataMesh services in general. When you provide any feedback, comments, or suggestions regarding the service, these terms, and DataMesh services, you irrevocably transfer all rights, ownership, and interests in your feedback, comments, and suggestions to us.

Questions or opinions regarding this service can be submitted to us via the email address assistance@datamesh.com.