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, tools, etc. In a scenario, not only you can compose and structure each scene, but also animate dynamic transitions between the scenes. Scenario management is available in the Digital Assets module of the DataMesh FactVerse platform.

Create a new scenario

To create a new scenario, click the Create button on the homepage. This will open the scenario editing interface and create a new scenario. By default, each new scenario includes one light 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.

Open a cloud scenario

To open a cloud scenario, follow these steps:

1. Click Open on the homepage.

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

If you are editing a scenario, 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.

Save a scenario

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

1. In the editing 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.

Import a local scenario

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

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

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

3. In the open window, select the path where the scenario resources (model files, images, audio, etc.) are stored. The scenario resources will be stored in the FactVerse resource library according to the original scenario directory structure.

4. Click Confirm to complete the import of resources within the scenario.

5. In the editing interface of DataMesh Studio, the scenario will be automatically loaded and opened. You can browse, edit, and save this scenario.

Export a scenario

To export a scenario, follow these steps:

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

2. In the Export Scenario window, you can configure the export options 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.

Preview a scenario

DataMesh Studio supports three play modes:

• • Start from Beginning: In the editing 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 editing 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 editing interface, select a scene, 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.

Change rendering environment

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 the system-built rendering environments. When you choose “None,” there is no specific environment rendering effects.

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

Manage scenario structure

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 of 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 table of content.
  • Rename Chapter: To rename a chapter in the scene catalog, right-click on the chapter name in the timeline and select Rename Chapter.

Create multilanguage scenario

DataMesh Studio supports users to add multi-language text content to scenarios, thus creating multi-language scenarios. When playing scenarios in DataMesh One, the text content in the scenario will be presented according to the interface language. The multi-language text feature supports the following languages: Simplified Chinese, English, Traditional Chinese, and Japanese.

Multilanguage scenario title

You can add multilanguage text content to the scenario title using the following steps:

1. Click on the Scenario menu and choose Rename.

2. In the scenario title editing box, enter the scenario title.

3. Click on the multi-language icon in the scenario title editing box to open the Multi-language text window.

The language list in the top right corner of the Multilanguage text window displays the source text language. You can switch the source text language using this language list.

4. Enter the source text and multilanguage text content for the scenario title.

a) Users with FactVerse AI permissions can use the AI Translate function to separately translate the scenario title into the four languages or use the Translate function to quickly translate the text content into the four languages.

Note:

• • Using the AI translation function consumes a certain number of tokens for each translation in each language. The number of tokens consumed is based on the length of the content.
  • Using the Translate All function only consumes tokens for non-source text languages. The number of tokens consumed is based on the length of the content. Text boxes that are the same as the source text language directly display the source text content, so no tokens are consumed.

b) Users without FactVerse AI permissions need to enter text content manually.

5. Click Confirm to save the multi-language text content of the scenario title.

Note: When playing the scenario, the scenario title content displayed will match the interface language of the playback device. If a certain language content is empty, no content will be displayed during playback.

Multilanguage scene name

To add multilanguage names to scenes, please follow these steps:

1. Without selecting any elements, choose the scene you want to edit from the timeline.

2. In the attribute pane, click the edit icon next to the scene name.

3. Click the multilanguage icon in the scene name editing box to open the Multilanguage text window.

4. In the Multilanguage text window, enter the source text and multi-language text content for the scene name.

5. Click Confirm to save the multilanguage text content for the scene name.

Other multilanguage text content

Apart from the scenario title and scene name, users can also add multilingual text content to the following sections:

• • Chapter name: In the window for creating or editing chapters, click the multilingual icon to open the multilingual text window and add multilingual text to the chapter name.

• • Textbox content: Click the ellipsis icon in the top right corner of the textbox content editing box, select the multilingual text option, open the Multilingual text window, and add multilingual text to the text box content.

• Tag text: Click the ellipsis icon in the top right corner of the tag text content editing box, select the multilingual text option, open the multilingual text window, and add multilingual text to the tag text content.

• Button text: Click the ellipsis icon  in the top right corner of the button text content editing box, select the Multilingual text option, open the Multilingual text window, and add multilingual text to the button text content.