Oblique Import

Instructions for use

The Oblique Import "function supports Merge Root Nodes, Texture Compression, Model Discret and Modify Center Point operations to achieve batch, multi-threaded processing of Oblique Photography Model.

Function entrance

  • 3D Data tab-> Oblique Photography group-> Data Processing Drop -down Button- > Oblique Import Button
  • Toolbox -> 3D Data -> Oblique Data Processing->ObliqueBuilder - Texture Compression/Oblique Inbound - Rebuild Top Level/Oblique to S3M-Lightweight/ObliqueBuilder - Singulation/ObliqueBuilder - Generate Normals/ObliqueBuilder - Modify Center Point/ObliqueBuilder - Clipping/ObliqueBuilder - Generate S3M

Operation steps

  1. On the 3D Data tab, in the Oblique Photography group, in the Data Processing drop-down menu, click the Oblique Import button. The Oblique Import "dialog appears.
  2. Source Config File: Add, Batch Add, delete and Set Password operations of the source Config File can be performed in the toolbar.
    • Add: After clicking this button, in the pop-up Open dialog box, select the *.scp file as the source Config File.
    • Add all config files under Folders: After clicking this button, Select FolderBatch Add Source Config File in the pop-up Browse Folder "dialog box.
    • Delete: Removes the selected source Config File from the Current Data list.
    • Set Password: It is the password of Result Data Settings. The data after Set Password needs to enter the password when it is opened. Set Password is only supported for compact data. Click the Set Password "button, enter the same password in the Password and Confirm Password boxes, and then click Confirm.
  3. Basic Seting：
    • Output directory: Set the storage path of Result Data.
    • S3M Version: Supported version numbers include: S3M 1.0, S3M 2.0, S3M 3.0, S3M 3.01. If you need to use data files in iClient3D products prior to 10.2.1, S3M 1.0 is recommended.
    • Texture Compression Format: Currently supports 4 compression formats, the default is CRN _ DXT5 (PC). Different Texture Compression modes are used for different purposes of data, which can reduce the amount of video memory used by texture images.
      • WebP: a Texture Compression format that significantly reduces the amount of data and is supported on both PC and mobile devices.
      • DXT (PC device): Reduce video memory usage and improve rendering performance, but the total amount of data will increase.
      • CRN _ DXT5 (PC): Reduces video memory usage, reduces total amount of data, but requires longer processing time.
      • KT X2.0: Reduce the occupation of video memory and the total amount of data. It takes less time to process the same data than CRN _ DXT5.
    • Process Thread Count: Sets the number of threads for the Oblique Import operation. The default is 8.
    • Vertex optimization method: Currently, two Compression methods are provided: MeshOpt and Draco Cpmression. Meshopt compression is not supported when the S3M version is S3M1.0 or S3M2.0.
    • Storage Format: supports raw and compact. The original representation does not compress the data and retains the original information; the compact representation uses a certain compression and encryption mechanism to compress and encrypt the data when Generate Tiles.
      • If the result Tile Data is to be stored in MongoDB, the storage type must be original.
      • Currently, generating Tile Data in a compact format is supported only when the source data is OSGB.
    • Center Coordinates Unit: According to the Config File Center Coordinates Unit Settings of this parameter. For example, if the original Config File Center Coordinates unit is METER, meter is selected for this parameter.
    • Rebuild the top level: checked by default. This function aims at the Oblique Photography Model data with poor top-level visualization effect, and regenerates the root node through Rebuild the top level, which can not only reduce the amount of data, but also improve the overall visualization performance of data.
    • Lightweight: Not checked by default. This function supports further reduction of Tile Data through geometry and texture lightweight.
  4. Advance Settings：
    • Coordinate System Transformation: Checked by default, supporting the setting of Target Coordinate System and Projection Transformation parameters.
      • Target Coordinate System: currently provides 3 methods.
        • Reset the coordinate system: Click the Reset Coordinate System button at the top of the Projection Settings "to pop up the Coordinate System Settings" dialog box. Select a projection as the coordinate system of the Target File. Please refer to "Projection Settings" Window "for the specific operation of setting target projection.
        • Import Coordinate System: Click the Import Coordinate System "button at the top of the Projection Settings", In the pop-up "Import Coordinate System File" "window, select the Projection Info File and import it. The coordinate system Details of the selected projection file are also displayed in the text box below.
        • Copy Coordinate System: Click the Copy Coordinate System "button at the top of the Projection Settings", and in the pop-up Copy Coordinate System "window, Coordinate system for Select Dataset. The coordinate system Details of the selected Dataset are also displayed in the text box below.
      • Reference Transformation Settings：
        • Conversion method: Click the Drop-down Button on the right side of the "Conversion Method" tab, and the pop-up drop-down menu list displays more than ten reference system conversion methods provided by the system. The user can select an appropriate reference system conversion method. For a description of the conversion method, refer to the Reference Frame Conversion Method Description .
        • Projection Transformation Parameters: Select different transformation methods, and customize different parameters in the Parameter Settings "dialog box. For Detail Description of Parameter Settings, see Dataset Transform Projection .
    • Modify Center Point: optional. When Modify Center Point "is checked, Model Center PointX, Y and Z coordinate values can be set.
    • Generate Normal: optional. After "Normal" is checked, parameters of algorithm type and included angle threshold can be set.
      • Algorithm Type: Sets the algorithm for RecalculateOblique Photography Model normals. Including Angle weight algorithm, Average algorithm and NelsonMax algorithm. Select by clicking the drop-down arrow to the right of the algorithm type.
      • Angle threshold: The angle threshold parameter is involved in the reconstruction Compute Normals algorithm. The threshold range is 0-180, and the default value is 80. The angle threshold can be customized. Setting this parameter is not supported when the algorithm type is Average algorithm.
  5. Optional : Unite Layers, Texture Remapping, and Save to MongoDB check boxes are available below the dialog box.
    • Unite Layers: When the center points of multiple Config Files are consistent, it supports merging the Oblique Photography Model of multiple layers into one layer after Oblique Import; When the center points of multiple Config Files are inconsistent, the Modify Center Point function shall be selected, and the center point of one of the Config Files shall prevail, Modify Center Point, and then Oblique Import shall be performed. Combines OSGB Data from multiple layers into one layer.
    • Texture Remapping: It is used to solve the unreasonable situation of Splice Texture in some oblique photography model and improve the loading performance.
    • Save to MongoDB: The data is directly stored in MongoDB. S3MB File will not be generated locally, but a Config File will be generated under the output directory. Check the Save to MongoDB and the system will pop up a "Save to MongoDB" "dialog box. The "Connection Info" area in the

      dialog box can be used to set the relevant information of the MongoDB server and database. Before using this function, you need to start the MongoDB service first. See the MongDB Instructions for use " for MongoDB. The relevant Parameter Description is as follows:

      If the data requires Save to MongoDB, the MongoDB library must be enabled.
      • Server Name: Enter the IP address of the server.
      • Database Name: Only an existing Database Name can be entered in the text box.
      • Username: Enter the Username of the MongoDB database.
      • Password: Enter the password
        • to access the MongoDB database.
      • Data Name: The name to save to MongoDB.
  6. After setting the above parameters, click OK to execute the Oblique Import operation.

Precautions

  1. The output directory cannot be modified without Unite Layers.
  2. When the sum of All Layers nodes is greater than 10 in Unite Layers, the Rebuild the top level can be used, and the parameters of S3m version, Texture Compression format and vertex optimization mode cannot be modified. When the sum of All Layers nodes is less than 10 in Unite Layers, the Rebuild the top cannot be used, and the parameters of S3m version, Texture Compression format, and vertex optimization mode cannot be modified.
  3. Oblique Import source data supports *.scp files in OSGB and S3MB formats, but does not support simultaneous storage of *.scp files in both formats.
  4. The Oblique Import function currently supports ENU and Projected Coordinate System data, and does not support plane data without Projected Coordinate System.
  5. The Oblique Import function only supports the Coordinate Transformation of the unified Reference Spheroid, and does not support other coordinate system transformations.
  6. When the encrypted Oblique Photography Model data is Add to Scene, a password is required.
  7. If the data in ENU coordinate system is to be loaded on the sphere after Oblique Import, EPSGCode: 4326 shall be selected for Target Coordinate System.
  8. The Oblique Import function can merge multiple Oblique Photography Model data in S3MB format into one layer. Pay attention to the following points when merging:
    • S3M version, storage type, geometric Compression method, Texture Compression method and Target Coordinate System shall be consistent with the original Oblique Import.
    • If the S3MB format oblique photography model to be merged is Geographic Coordinate System, the Center Coordinates unit needs to be selected. Otherwise, the Center Coordinates unit must be selected in meters.
      • The Merge Root Nodes checkbox
    • needs to be unchecked.
      • The Unite Layers checkbox
    • needs to be checked.
  9. If the data in Projected Coordinate System is to be used in Spherical Scene after Oblique Import, the corresponding Geographic Coordinate System should be selected during warehousing. If the original osgb data coordinate system is EPSGCode: 4546, the Target Coordinate SystemEPSGCode must be set to 4490 during Oblique Import.
  10. If the number of root nodes of the data is less than 10, the data will not be processed because the performance of the source data has basically met the requirements.