ObliqueBuilder - Generate S3M

Usage Instructions

This tool can take SCP configuration files as source data and, through operations such as texture compression, lightweighting, and rebuilding the top layer, generate S3M tile data from oblique photogrammetry 3D model data. Loading S3M tile data can improve data loading efficiency and enable multi-terminal sharing and interoperability of data.

This tool is typically used together with GPA tools such as Generate Configuration File, Oblique Import - Individualize, Oblique Import - Generate Normal, Oblique Import - Modify Center Point, and Oblique Import - Clip.

When using this tool on a Windows operating system, the following software and hardware requirements must be met:

  • Compatible with OpenGL 3.0 or earlier versions;
  • Supports GLSL (OpenGL Shading Language) shader syntax below 1.30;
  • Graphics card memory greater than 1GB.

Parameter Descriptions

Parameter Name Parameter Description Parameter Type
Source Configuration File Add the source SCP configuration file. The configuration file can be obtained based on oblique photogrammetry 3D model data using the Generate Configuration File tool. String
Merge Layers
(Optional)		 When the number of configuration files in the file list is greater than or equal to 2, merging layers allows generating a new configuration file based on multiple configuration files, i.e., merging multiple data layers into one data layer.
Note: Checking this checkbox will modify the source data. It is recommended to back up the data before processing. 		Boolean
Storage Path: The file path to save the result data. String
Number of Threads:
(Optional)		 The number of threads assigned to this operation. Setting the thread count to 0 means the number of threads assigned to this operation is the maximum number of cores on the current computer. Integer
Rebuild Top Layer
(Optional)		 Set whether to perform top layer rebuilding. For oblique photogrammetry 3D data with poor top layer effects, you can reassign finer-level data as the new root node and rebuild the top layer, which can improve the visualization effect of the top layer, reduce data volume, and enhance loading efficiency. Boolean
Texture Compression Format:
(Optional)		 For data with different purposes, different texture compression formats are used to reduce the amount of video memory used by texture images, including WebP, DXT, CRN_DXT5, and KTX2.0.
  • WebP: Recommended when tile data is used on mobile devices; supports transparent textures.
  • DXT: When selected, the result data occupies the least video memory, has the shortest processing time, and the largest total data volume.
  • CRN_DXT5: When selected, the result data occupies slightly less video memory, has the longest processing time, and the largest total data volume.
  • KTX2.0: When selected, the result data is universal for PC and mobile; mobile devices do not currently support transparent textures.
Note: In the Linux environment with iServer 11.1.1 or later, the corresponding parameter value must be set based on whether the node depends on multi-concurrency.
  • If the node depends on multi-concurrency, the texture compression type cannot be set to CRN_DXT5.
  • If the node does not depend on multi-concurrency, all parameter values can be set. However, if the texture compression type needs to be set to CRN_DXT5, before starting iServer, temporarily comment out the LD_PRELOAD parameter in the product package/bin/setenv.sh file using the # symbol to ensure normal tile generation; otherwise, the tile generation process may be abnormal and result data may not be generated.
 TextureCompressType
Storage Type:
(Optional)		 The storage type of the result tile data, including Original and Compact.
  • Original means the data is not compressed, retaining the original information.
  • Compact means using a certain mechanism to compress and encrypt the tile data.
Currently, only source data in OSGB format supports generating compact format tile data. 		StorageType
Vertex Optimization Method:
(Optional)		 Set the vertex optimization method for the data, including No Compression, Draco Compression, and MeshOpt Compression.
  • No Compression: No compression is applied to the data.
  • Draco Compression: Compresses the data based on a certain algorithm, which can significantly reduce data volume and improve data loading experience.
  • MeshOpt Compression: Uses a series of algorithms to reduce the complexity of the data mesh, thereby reducing data volume and improving data rendering efficiency.
 VertexOptimizationType
S3M Version:
(Optional)		 Set the version of the S3M tile data, including: S3M 1.0, S3M 2.0, S3M 3.0, and S3M 3.01. S3MVersion
Lightweight
(Optional)		 Set whether to perform lightweight processing. After checking the lightweight checkbox, the geometry and texture objects of the data can be simplified, reducing the data volume of the result data after oblique import. Boolean
Texture Remapping
(Optional)		 Set whether to perform texture remapping on the data. By default, it is not checked. Texture remapping can resolve unreasonable texture stitching in some oblique photogrammetry 3D model data, thereby improving data selection performance. Boolean
Watermark Parameter Settings
(Optional)		 Set parameters for adding a watermark. The specific parameters are specified by the Watermark Parameter Settings tool. WatermarkParameters
Oblique Dodging and Color Equalization Parameters
(Optional)		 The oblique dodging and color equalization operation can perform color correction on the data. The specific parameters are specified by the Oblique Dodging and Color Equalization Parameters tool. ColorAdjustmentParameters
Cloud Storage Connection
(Optional)		 Set whether to upload the result S3M data to a cloud storage service (Huawei Cloud, Alibaba Cloud, SeaweedFS, MinIO, AWSS3). The specific parameters are specified by the Cloud Storage Connection tool. CloudStorageConnectionInfo
Target Coordinate System
(Optional)		 The target coordinate system for the tile data. iDesktopX can be set through operations such as setting coordinate system, copying coordinate system, and importing coordinate system. iServer can be set by entering the EPSG Code of the specified coordinate system.
Coordinate system files only support *.prj and *.xml files generated by iDesktopX functions such as Export Coordinate System.		 Integer
Scale Difference:
(Optional)		 Projection transformation parameter, indicating the scale scaling amount when converting from the original coordinate system to the new coordinate system. Double
Rotation Angle X:
(Optional)		 Projection transformation parameter, indicating the rotation angle around the X-axis, in seconds, with a default value of 0. Double
Rotation Angle Y:
(Optional)		 Projection transformation parameter, indicating the rotation angle around the Y-axis, in seconds, with a default value of 0. Double
Rotation Angle Z:
(Optional)		 Projection transformation parameter, indicating the rotation angle around the Z-axis, in seconds, with a default value of 0. Double
Offset X:
(Optional)		 Projection transformation parameter, indicating the offset along the X-axis, with a default value of 0. Double
Offset Y:
(Optional)		 Projection transformation parameter, indicating the offset along the Y-axis, with a default value of 0. Double
Offset Z:
(Optional)		 Projection transformation parameter, indicating the offset along the Z-axis, with a default value of 0. Double
Rotation Origin X:
(Optional)		 Projection transformation parameter, indicating the X coordinate value of the rotation origin, with a default value of 0. Double
Rotation Origin Y:
(Optional)		 Projection transformation parameter, indicating the Y coordinate value of the rotation origin, with a default value of 0. Double
Rotation Origin Z:
(Optional)		 Projection transformation parameter, indicating the Z coordinate value of the rotation origin, with a default value of 0. Double
Projection Transformation Method:
(Optional)		 Set the method for performing projection transformation on the data. For more information, see Dataset Coordinate System Transformation.
Currently, only conversions between geographic coordinate systems and projected coordinate systems based on a unified reference ellipsoid are supported.		 CoordSysTransMethod
Center Point Coordinate Unit:
(Optional)		 Set the unit of the center point coordinates, including Meter and Degree. DataUnit
Encryption Algorithm:
(Optional)		 Set the encryption algorithm for coordinate encryption. The specific algorithm is specified by the Coordinate Encryption tool. EncryptCoordinatesSetting
Parameter Settings
(Optional)		 No separate setup is required; it will be automatically set when linked with other GPA tools. obliqueBuilderParameters

Output Results

Parameter Name Parameter Description Parameter Type
ObliqueBuilder - Generate S3M The storage path of the result tile data. String