Basics

Installation

System requirement

To ensure optimal performance of DataMesh Studio, here are the minimum and recommended system requirements.

System	Minimum Configuration	Recommended Configuration
Windows PC	Software: •      Window10 or later •      Direct3D 11.0 or higher Hardware: •      CPU: Intel®Core™i5-6200U 2.30Ghz •      RAM: 8GB •      GPU: NVIDIA GTX 1050Ti	Software: •      Window10 or later •      Direct3D 11.0 or higher Hardware: •      CPU: Intel®Core™i7-11700 3.60Ghz •      RAM: 16GB •      GPU: NVIDIA GTX 3070
macOS	Software: •      Monterey 12.7.6 Hardware: •      CPU: Intel Core i5 •      RAM: 8GB •      GPU: Intel Iris Graphics 6100	Software: •      Monterey 14 Hardware: •      Chip: Apple M1 •      RAM: 16GB
iPadOS	Software： •      iPadOS 14.6 Hardware： •      Chip：A12 •      RAM：6GB	Software： •      iPadOS 17 Hardware： •      Chip：M1 or newer •      RAM：8GB or more

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

Download

Before installing DataMesh Studio, please make sure you have downloaded the installer.

DataMesh Studio Windows PC download link：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
iPadOS	Apple Store	https://apps.apple.com/cn/app/datamesh-studio/id1525519778?l=en

Account Permission

Before using DataMesh Studio, you’ll need to request access from your enterprise administrator. They will create a user account for you on the FactVerse platform and grant you permission to use DataMesh Studio and any other required features.

Login

The following picture shows the login interface:

• • Server list: You can switch servers to China, Japan, or Singapore.
  • Private deployment: When an enterprise deploys a private server, users need to set a private deployment service code when logging in.
  • Microsoft account login: For more information, please refer to  Microsoft account login.
  • SSO login: For more information, please refer to SSO login.
  • Forgot Password: Click Forgot Password to open the server login page and reset your password.

Standard login

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

Steps

1. Open the login interface: Launch DataMesh Studio to access the login screen.

2. Configure server:

a) Select a public server: If your organization is hosted on a public server, select the relevant server from the list.

b) Configure a private deployment server: If your organization uses a private deployment server, click on the private deployment icon to set up your service code.

3. Enter your account credentials: Input your FactVerse username and password.

4. Agree to the terms of service: Check the box that says, “I have read and agree to the DataMesh ‘Terms of Use’ and ‘Privacy Policy,’” then click the Login button.

5. Select your organization (optional): If you have multiple organizational accounts, a list will appear for you to choose from. If you only belong to one organization, you’ll be taken directly to the homepage after a successful login.

Microsoft account login

Log in using the Microsoft account method, utilizing Microsoft’s identity and access management service, Microsoft Entra ID, to enhance security for users when accessing FactVerse services.

Steps

1. Open the login interface: Launch DataMesh Studio to access the login screen.

2. Configure server:

a) Select a public server: If your organization is hosted on a public server, select the relevant server from the list.

b) Configure a private deployment server: If your organization uses a private deployment server, click on the private deployment icon to set up your service code.

3. Agree to the terms of service: Check the box that says, “I have read and agree to the DataMesh ‘Terms of Use’ and ‘Privacy Policy,’” then click the Login button.

4. Log in using your Microsoft account credentials: Click the Microsoft account login icon , then follow the prompts to enter your Microsoft account password to log in.

SMS verification login

When a company enables the dual authentication of account passwords and SMS in FactVerse, users are required to undergo an SMS verification process when logging into the DataMesh client and FactVerse 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 platform to complete the binding.

The steps for using SMS verification are as follows:

1. Open the DataMesh One login interface.

2. Configure server:

a) Select a public server: If your organization is hosted on a public server, select the relevant server from the list.

b) Configure a private deployment server: If your organization uses a private deployment server, click on the private deployment icon to set up your service code.

3. Enter your account credentials: Input your FactVerse username and password.

4. Agree to the terms of service: Check the box that says, “I have read and agree to the DataMesh ‘Terms of Use’ and ‘Privacy Policy,’” then click the Login button.

5. Select your organization (optional): If you have multiple organizational accounts, a list will appear for you to choose from. If you only belong to one organization, you’ll be taken directly to the homepage after a successful login.

6. Enter the SMS verification code: 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. After entering the code, you will be directed to the homepage to complete the login.

SSO login

Once your company has enabled the SSO (Single Sign-On) feature, you can log into DataMesh Studio using the company’s unified identity authentication system, streamlining the login process and enhancing security. Follow the steps below to complete the SSO login:

1. Open the login interface: Launch DataMesh Studio to access the login screen.

2. Configure server:

a) Select a public server: If your organization is hosted on a public server, select the relevant server from the list.

b) Configure a private deployment server: If your organization uses a private deployment server, click on the private deployment icon to set up your service code

3. Agree to the terms of service: Check the box that says, “I have read and agree to the DataMesh ‘Terms of Use’ and ‘Privacy Policy,’” then click the Login button.

4. Select SSO Login: Click the “SSO Login” button to open the Enterprise ID window.

5. Enter enterprise ID: For your first login, you need to enter the enterprise ID (please contact your company administrator to obtain this ID), then click “OK”.

6. Proceed to the third-party login process:

a) If you’re logged into the company’s office system: The system will automatically redirect you, retrieving your authentication information from the office system and prompting you to select an account. After you make your selection, the system will log you into DataMesh Studio automatically, so you won’t need to manually enter your account details.
b) If you’re not logged into the company’s office system: The system will redirect you to the company’s SSO authentication page. Follow the prompts to enter your company account and password, or complete verification using methods like dual authentication.

User interface

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:

• • New Scenario: Click the New Scenario button to create a new scenario.
  • Open cloud scenario: Click the Open button to open a scenario from FactVerse.
  • 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 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.

Editing interface

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

The editing interface consists of the menu, toolbar, resources pane, elements pane, workspace, timeline, and attributes pane.

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. New storyline: This feature is only visible to users with storyline permissions. Users can create new storyline files to edit the scenario’s navigation logic. For more detailed information, please refer to the Storyline chapter Open: Open a cloud scenario from FactVerse. 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: Export the scenario in dirpkg format and save it as a file. Close: 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: Supports modifying the scenario positioning method. For detailed information, please refer to  Scenario positioning. Modify Play Mode: This feature is only visible to users with learning management service permissions, allowing users to select how to play the scenario in training mode within DataMesh One. For more details, please refer to the Modify scenario play mode.
Assessment	Task: Attach a task to your current scene that viewers will have to complete. For more details, please refer to  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	Language: You can switch to different interface languages. The DataMesh Importer offers four interface languages: Simplified Chinese, Traditional Chinese, English, and Japanese. After users log in, the interface language will default to the system language. If the system language is not one of these four application languages, the interface language will default to English. Account: o    User account: Display currently the current user. o    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. o    1 (Lowest Quality): The most basic rendering level, ideal for quickly viewing the model or when the device performance is limited. o    6 (Highest Quality): The best image quality and detail display, but it may significantly impact software performance. About: Check the 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 The ‘Ungroup’ button, when selected for a certain group, can dissolve that group; after ungrouping, the corresponding group in the element list disappears, and all elements within the group revert to their state prior to grouping. If the group includes sub-groups, the ungrouping operation of the parent group does not affect the sub-groups.
	Copy Copy the selected element, and grouped elements can also be copied.
	Paste Paste the most recently copied content.
	Delete Delete the selected element.
	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 element. 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 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 to the current scene, including:

• • Light: By default, every new scenario contains one light .
  • 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 the earliest at the left to the 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 scene.
  • 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.

Keyboard shortcuts

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