Archives: Knowledge Base

Open local model

The steps to open a local model are as follows:

1. Log in DataMesh Importer.

2. Click the File menu and select Open Local.

3. Select a local model and click Open in the local resources folder.

Open cloud model

Steps to open a cloud model are as follows:

1. Click File menu and select Open Cloud.

The following figure is the Open Cloud File window:

2. After selecting a model, click Open to open and display the model in DataMesh Importer.

Adjust model material

The material of a model refers to the attributes used to describe the surface characteristics of an object, such as color, reflection, transparency, etc. It determines the appearance and visual effects of the model.

In DataMesh Importer, you can easily modify the material attributes of a model.

1. Open the model and go to the material list in the attributes pane.

2. Click on the edit button of the material you want to modify.

3. You will open the material properties window, where we provide several commonly used material spheres, including metal, wood, plastics, glass, marble, glaze, and concrete. You can use these material spheres to replace the original material of the model.

In addition, you can use various adjustable properties, including color, transparency, metallicity, and smoothness. These properties can be adjusted separately or in combination, making it easy for you to achieve the desired effect.

Note: When saving the model, the model with modified material will be saved in GLB format to the cloud.

Save model

The steps to save a model are as follows:

1. After opening the model, select the nodes that need to be saved in the left structure directory.

2. In the model attributes area on the right, view the model’s name, platform availability, basic parameters, animation list, and other information. Adjust the model material according to your needs.

3. If the model has not been modified, the Save option in the file menu will be grayed out.

4. If the model has been modified, click File > Save Model or the Save button in the Menus to upload the modified model to the cloud. Note: The original model file in the cloud will be overwritten by the new file.

5. In the Save Model window, enter the model file name, select the target path, and click Confirm.

6. Wait for the model to finish uploading, and the page will prompt that “Resources successfully uploaded”.

Save as

In DataMesh Importer, you can save the imported model as a new file by following these steps:

1. Click the File menu and select the Save As option.

2. In the pop-up Save As window, choose the path and file name for saving the model.

Note: You should avoid using the same file name as the model file in the cloud. It is recommended to choose a different file name or select a different folder in the same path when saving the model.

3. Click Confirm to save as a new file.

Change rendering environment

The rendering environment of a scene refers to the lighting effects set in the virtual scene, simulating the propagation, reflection, and refraction of light in the scene. It can affect the appearance, lighting, and shadow effects of objects, enhancing the realism and authenticity of the scene.

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

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

1. Click on the Settings 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 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 Importer, click on the Settings 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.

Recommended formats

• • FBX format (*.fbx): FBX format is a universal 3D model file that contains information such as animation, material properties, textures, skeletal animation, lighting, cameras, etc. FBX format supports Polygons, Curves, Surfaces, and Point Group Materials.

FBX format supports normal and texture coordinates. Textures and coordinate information can be stored in the FBX file, and no manual identification or adjustment of texture coordinates is required after the file is being imported.

Note: If the exported FBX model file has a corresponding texture, the texture should be embedded during the export process.

• • glTF format: glTF format has two formats: *.gltf and *.glb. DataMesh Importer does not support the *.gltf format, but it can be converted to the .glb format for use. Compared with FBX, glTF can store more material information and support more artistic effects. If the model has complex materials (such as reflection maps, metal texture maps, normal maps, etc.), it is recommended to convert them to glTF format for use.

Compatible formats

DataMesh Importer also supports the following model formats, but due to the characteristics of the format itself, it may not include hierarchy structure and color materials.

• • OBJ format (*.obj): The textures and materials in the OBJ format are stored externally, and only the index is stored in the main file. Therefore, importing the OBJ format into DataMesh Importer will lose color and texture.
  • STL format (*.stl): STL format is a simple format for 3D printing, which only includes the shape of the three-dimensional object surface and does not include material information such as color and texture. Therefore, there is no color and texture after importing the STL file into DataMesh Importer. The STL format also does not include sub-objects, so the models in the STL format do not have sub-objects after importing.
  • 3MF format (*.3mf): 3MF format is also a format for 3D printing, but it is more advanced than STL. It can include color information and sub-objects but does not have texture. Because it is a 3D printing format, the transparency in the color information of 3MF is meaningless and cannot represent transparent objects. In some 3MF formats, in addition to setting colors for sub-objects, colors are also set for each point. DataMesh Importer currently does not support setting colors for each point and will ignore this part of the data.
  • PLY format (*.ply): PLY format is a data file used to describe 3D scanning results. It usually does not include color but may have texture. Like OBJ, the texture is external, and only the information used for texture is stored in the main file. Therefore, importing the PLY format will lose texture. The PLY format also cannot include sub-objects.

Model specification recommendation

High-performance equipment: This specifically refers to mid-to-high-end PC hosts, top-tier iOS devices, and high-end Android models.

Examples of high-end Android models include:

• • CPU: Snapdragon 8+ Gen1, Dimensity 9000
  • RAM: 12G/16G

Mid-performance equipment: Common PC hosts, mid-to-high-end iOS devices, and mid-range Android models；

Examples of mid-range Android models include:

• • CPU: Snapdragon 778G
  • RAM: 8G

Low-performance equipment: Common iOS devices, HoloLens2 and Android low-end models.

The data in the table is recommended as reference values, representing typical values under normal circumstances. It does not guarantee applicability in any environment. The final display effect is influenced by numerous factors, and the actual operating effect shall be subject to the critical value of any item.

The layout of DataMesh Importer user interface is as follows:

Menu

The Menu includes functions such as File, Settings, and Information Panel. You can perform operations such as opening local models, opening cloud models, and saving models.

File menu

• • Open Local: Open a locally saved model file.
  • Open Cloud: Open a model file from the FactVerse resources.
  • Save Model: Upload the currently imported model to the FactVerse resources.
  • Save As: Perform a Save As operation on the current model and specify a new name for it.

Save

It is the same as the Save Model function in the File menu. It saves the model resource to the FactVerse resources.

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 > User account: Display current login user account.
  • Account > Log out: Exit current user account.
  • 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.
  • Change Rendering Environment: Support modifying the rendering environment of the scene, which can include system-built rendering environments or custom rendering environments. For detailed information, please refer to the guide on Change rendering environment.
  • Upload log: You can upload the latest seven log files to FactVerse.
  • Operating Parameters: Display the application’s Memory, FPS, DrawCall, Batches, Polygons, Vertices, and other key data.
  • About: View the current application version number.
  • Quit: Close the application.

Information Panel

Display attributes information of the model.

Node structure directory

The Node structure directory is a feature in DataMesh Importer that displays the hierarchical structure and node relationships of the imported 3D models. The Node structure directory can help you better manage and control the structure of the imported 3D model. You can select, deselect, and merge nodes as needed to flexibly adjust the model’s hierarchical structure. This can improve the model’s operability and flexibility, making it easier for you to perform subsequent model editing and scene creation work.

In the Node structure directory, you can perform the following operations:

• • Smart Select All: With Smart Select All, you can quickly select or deselect all nodes for batch operations.
  • Single node selection: Each node has a checkbox that you can click to select or deselect the node. Through the checkbox, you can selectively control the components of the model. When you upload the model, the selected nodes will be uploaded as separate objects, while the unselected nodes will be merged into other nodes.
  • Select same-level nodes quickly: By double-clicking the checkbox of a node, you can quickly select or deselect all nodes at the same level. This feature makes it convenient for you to perform mass selection or deselection operations on nodes at the same level.

Note: When the number of nodes exceeds 500, you need to manually select the nodes.

Scene area

The Scene area can load and display imported 3D models. Users can import various format model files (such as FBX, GLTF, OBJ, etc.) and present them as realistic 3D objects in the Scene area. Users can freely browse and observe the model in the Scene area.

When loading and displaying imported 3D models in the Scene area, users can use the following methods to adjust the scene perspective:

• • Rotate the scene: Hold down the right mouse button at any position in the scene and move the mouse horizontally to rotate the scene in all directions for a comprehensive view of the model.
  • Pan the scene: To move the scene to the left, right, forward, or backward in the scene, click on a blank area in the scene, hold down the left mouse button, and drag the mouse to the left, right, or up and down on the screen. You can also hold down the mouse wheel and drag the mouse in the direction you want to pan.
  • Zoom the scene: To zoom in and out of the scene, you can use the scroll wheel on the mouse. Scroll up to zoom in and scroll down to zoom out.
  • Raise and lower the scene: To raise and lower the scene, hold down the Shift key and the left mouse button, and move up and down on the blank area of the scene. Move up to lower the scene and move down to raise the scene.

Model Attributes pane

The Model Attributes pane displays the current model’s performance on various platforms and its basic attribute information. At the same time, the attributes pane provides material editing functions that allow users to adjust and modify the model’s materials. Users can choose the type of material ball for the model (such as metal, wood, plastic, etc.), or customize the color, glossiness, roughness, and other attributes of the material to achieve the desired visual effect.

• • Available Platforms: The platform availability indicates the availability of models on different platforms. The size and complexity of the model’s structure can affect its performance on different platforms. When using DataMesh Importer to open a model, we will prompt you to see whether the DataMesh application on three platforms supports the model’s normal operation.
  • Polygons: The polygons refer to the number of polygons in the model. It is an important indicator for measuring model complexity and detail level. Higher polygon counts usually mean more details and more refined appearance but may also lead to performance burdens. In DataMesh Importer, when the polygon count of the model is too large, it may affect the use of the application and give corresponding prompts.
  • Vertices: The model vertices refer to the total number of vertices in the model. Vertices are the basic building blocks of the model, forming polygons by connecting vertices, thus forming the entire model. The vertices are related to the detail and complexity of the model. A high vertex may increase rendering and computational burdens. Therefore, when using DataMesh Importer, if the vertices of the model are too large, prompts may be given.
  • Textures: The texture count refers to the number of texture images applied to the model. Textures can give the model visual effects such as color, texture, and reflection. Increasing the number of textures may increase memory usage and render burdens. In DataMesh Importer, the textures can provide an evaluation of the model’s texture usage, allowing users to understand the details of the model.
  • Materials: The materials represent the number of materials used in the model. Materials define the characteristics of the model’s surface, such as color, transparency, metallicity, and smoothness. In DataMesh Importer, users can edit and adjust each material, including modifying properties such as color, transparency, metallicity, and smoothness. Understanding the number of materials in the model can help users understand the changes in appearance and detail control of the model.
  • Animation: When the model has built-in animation, users can click the Play button to play it.

After opening DataMesh Importer, click on the settings button in the toolbar, and select Account > Account Login from the drop-down menu to open the login page.

Following figure is the login interface:

The login interface supports the following configuration:

• • Server List: You can switch to different servers, including China, Japan, and Singapore.
  • Private Deployment: If an enterprise has deployed a private server, users need to enter the exclusive service code for the private deployment when 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 page, and proceed with the password reset.

Regular login

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

1. Open the login interface of DataMesh Importer.

2. Configure server:

a. Select public server: If your enterprise is deployed on a public server, choose the server belonging to the enterprise account from the server list.
b. Set up private deployment server: If your enterprise uses a private deployment server, you need to click on the private deployment icon to set the exclusive service code.

3. Enter your account and password of FactVerse.

4. Check the box “I have read and agree to the DataMesh ‘Terms of Use’ and ‘Privacy Policy’”, then click the Sign in button.

5. Select your enterprise account (Optional):

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

1. Open the login interface of DataMesh Importer.

2. Configure server:

a. Select public server: If your enterprise is deployed on a public server, choose the server belonging to the enterprise account from the server list.
b. Set up private deployment server: If your enterprise uses a private deployment server, you need to click on the private deployment icon to set the exclusive service code.

3. Check the box “I have read and agree to the DataMesh ‘Terms of Use’ and ‘Privacy Policy’”, then click the Sign in button.

4. Click the Microsoft third-party login icon, and then enter the 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, 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.

Once your phone number is bound, the steps for using SMS verification are as follows:

1. Open the DataMesh Importer login interface

2. Configure server:

a. Select public server: If your enterprise is deployed on a public server, choose the server belonging to the enterprise account from the server list.
b. Set up private deployment server: If your enterprise uses a private deployment server, you need to click on the private deployment icon to set the exclusive service code.

3. Enter your FactVerse account and password.

4. Check the box “I have read and agree to the DataMesh ‘Terms of Use’ and ‘Privacy Policy’”, then click the Sign 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.

System configuration requirements

Download and installation

Download link for DataMesh Importer 7.0-Windows PC: datame.sh/ImporterPC

Account permission

Before using DataMesh Importer, you need to request permission from your company administrator. The company administrator will add your user account, associate it with a department and position, and provide access to DataMesh Importer and other required features on the FactVerse service platform.

DataMesh Importer is a lightweight and efficient 3D model viewing tool that supports importing various formats of 3D model resources, including FBX, GLTF, OBJ, PLY, 3MF, and STL formats. With DataMesh Importer, you can intuitively understand the structure and basic attributes of the imported model, quickly preview the running effect of the model on different devices and adjust and edit the material properties of the model to optimize the rendering effect.

DataMesh Importer also supports one-click upload of models to the cloud resource library of DataMesh FactVerse, facilitating team collaboration and resource sharing. At the same time, when used in conjunction with DataMesh Studio, it can easily add 3D models to presentations, providing users with an efficient 3D content creation tool.