Usage Instructions

The Tile Management function enables the storage of S3M tile data into a MongoDB database. Once the data is saved to the MongoDB database, a configuration file is generated at a specified path. After connecting to the MongoDB database, you can perform operations such as adding, deleting, and querying the data.

Function Entry

• 3D Data tab->3D Tile group->Tile Management

Procedure for Saving to MongoDB

1. Click the 3D Data tab->3D Tile->Tile Management button to open the MongoDB Tile Management panel. In the panel, click the Save to MongoDB button to pop up the MongoDB Tile Management dialog box.
2. SourceData Setting: Add configuration files via the button, delete files from the list via the button, and set whether to display the absolute path of the configuration file via the button.
3. Connection Information Setting: Set the relevant information for the MongoDB server and database. Before using this function, you need to start the MongoDB server. For specific information, refer to MongoDB Usage Guide. The parameters are described as follows:
   • Server Name: Enter the IP address of the server.
   • Database Name: Enter the name of an existing database in the text box.
   • User Name: Enter the user name for accessing the MongoDB database.
   • User Password: Enter the password for accessing the MongoDB database.
4. Output Configuration File Setting:
   • Storage Path: Set the save path for the newly generated *.scp configuration file. You can click the button on the right side of the combo box to select a save path or directly enter the path in the text box. The default save path for the target file is the same as the path of the source configuration file.
   • Data Name: Used to set the save name for the data in the MongoDB database, which is also the name of the newly generated configuration file.
   • Texture Compression Format: Set the texture compression format for the data. This applies only to S3M tile data generated from oblique photography 3D model data. Options include WebP, DXT (PC Device), CRN_DXT5 (PC Device), and KTX2.0, with DXT (PC Device) as the default. For data with different purposes, using different texture compression methods can reduce the amount of video memory used by texture images. If the texture compression format of the source data differs from the currently set format, the data will be recompressed during the save-to-MongoDB process.
     • WebP: A universal compressed texture format suitable for web/PC devices. Reduces the total data volume and improves transmission performance.
     • DXT (PC Device): A universal compressed texture format suitable for PC (Personal Computer) devices. Reduces video memory usage and improves rendering performance, but increases the total data volume.
     • CRN_DXT5 (PC Device): Slightly reduces video memory usage, significantly reduces total data volume, but requires longer processing time.
     • KTX2.0: Slightly reduces video memory usage, significantly reduces total data volume. Processing the same data takes longer than Standard CRN.
5. After setting the above parameters, click the "OK" button to execute the operation of saving data to the MongoDB database. Upon completion, the data will be saved to the MongoDB database, and a new configuration file will be generated at the specified local path, recording the database connection information and texture compression format.

Procedure for Connecting to a Database

1. Click the 3D Data tab->3D Tile->Tile Management to open the MongoDB Tile Management panel.
2. In the panel, click the Connect to Database button to pop up the MongoDB dialog box.
3. Fill in the following connection information:
   • Server Name: Enter the IP address of the MongoDB server.
   • Database Name: Enter the name of the database to connect to. If left blank, after connection, tile data from all accessible databases will be displayed.
   • User Name: Enter the username required to access the database.
   • User Password: Enter the corresponding password.
4. Upon successful connection, the panel will display a list of S3M tile data.
   • If a database name is specified, only tile data within that database is displayed.
   • If no database name is specified, tile data from all accessible databases (requiring consistent username/password or no authentication) is displayed.

Procedure for Querying and Deleting

1. After connecting to the database, in the Tile Management interface, select a tile data node, right-click to add the tile data to the scene or delete it. Note: Once a deletion operation on tiles in the MongoDB database is executed and completed, the tiles cannot be recovered.
2. After connecting to the database, enter characters in the search bar of the MongoDB Tile Management panel to retrieve data with corresponding names from the database.