Import Point-Attached External Models
Usage Instructions
This tool supports batch importing model data into a model dataset using the point-plus-model mode and saving it to a specified data source.
Point-plus-model refers to storing model data in the form of a 3D point data plus multiple model objects. Each point in the 3D point dataset records the external model object at the current location, as well as its spatial position, scaling, rotation, and other spatial pose information.
Currently, the compatibility of this tool is as follows:
- S3MB/S3M/OFF/STL/OSG/OSGB/OBJ/3DS/X/DAE compatibility: All format versions supported
- DXF compatibility: Supports AutoCAD 2024 and earlier versions
- FBX compatibility: Format versions support FBX 7.1-7.4
- GLTF compatibility: All format versions supported
Parameter Descriptions
| Parameter Name | Parameter Description | Parameter Type |
|---|---|---|
| Dataset | Input source point dataset. | DatasetVector |
| Association Field | Select an attribute field in the point dataset that records the external model path. | String |
| Model File Path (Optional) |
If there is no association field or the association field only records the model name, use the select button on the right to open the local model folder. | String |
| Matrix Field (Optional) |
Select a matrix field in the point dataset that stores the spatial pose transformation information of the model. | String |
| Delimiter (Optional) |
Set a special character to separate attribute values in the matrix field. For example, if set to #, then attribute values 1#2#3#4 can be understood as a combination of values 1, 2, 3, and 4. | String |
| Rotation Angle X (Optional) |
The angle by which the model rotates counterclockwise around the X-axis. It can be set by directly entering an angle value or selecting the corresponding field from the dropdown list. | String |
| Rotation Angle Y (Optional) |
The angle by which the model rotates counterclockwise around the Y-axis. It can be set by directly entering an angle value or selecting the corresponding field from the dropdown list. | String |
| Rotation Angle Z (Optional) |
The angle by which the model rotates counterclockwise around the Z-axis (true north direction). It can be set by directly entering an angle value or selecting the corresponding field from the dropdown list. | String |
| Scale X (Optional) |
The scale factor of the model along the X-axis. It can be set by directly entering a value or selecting the corresponding field from the dropdown list. | String |
| Scale Y (Optional) |
The scale factor of the model along the Y-axis. It can be set by directly entering a value or selecting the corresponding field from the dropdown list. | String |
| Scale Z (Optional) |
The scale factor of the model along the Z-axis. It can be set by directly entering a value or selecting the corresponding field from the dropdown list. | String |
| Ignore Material Color (Optional) |
Set whether to import the material color when both model texture and material color exist. | Boolean |
| Batch Remove Duplicate Points and Faces (Optional) |
Set whether to batch remove duplicate points and faces in the model data. | Boolean |
| Target Datasource | Select the datasource to store the result dataset. | Datasource |
| Result Dataset (Optional) |
Set the name of the result dataset. | String |
Output Results
| Parameter Name | Parameter Description | Parameter Type |
|---|---|---|
| Target Dataset | Result dataset | DatasetVector |