Label | Explanation | Data Type |
Input 3D Files and Folders
| The 3D files or folders containing 3D files that will be imported. When a folder is provided, all supported 3D models contained in it and its subdirectories will be imported. The following models are supported:
| File; Folder |
Output 3D Object Feature Class
| The 3D object feature layer that will be created or updated. | Feature Layer |
Update Strategy
(Optional) | Specifies how an existing 3D object feature class will be handled.
| String |
XY Offset
(Optional) | The x- and y-coordinate offset that will be applied to the imported models. | Point |
Elevation Offset
(Optional) | The height offset that will be applied to the imported models. | Double |
Scale Factor
(Optional) | The scale factor that will be used to resize the 3D models being imported. | Double |
Rotation Angle
(Optional) | The degree rotation angle that will be applied to the imported models. Rotation is applied with the assumption of 0° representing north and angular values incrementing in the clockwise direction. | Double |
Summary
Imports 3D models from one or more 3D file formats and creates or updates a 3D object feature layer.
Usage
The 3D object feature class provides a way to store, georeference, and visualize 3D models in ArcGIS Pro using their native rendering capabilities, such as light effects, reflectance, and materials. .
The geometry of a 3D object feature class can be used in any geoprocessing tool that supports multipatch features. For example, a 3D object feature layer can be used to analyze sight lines in Line Of Sight and Intervisibility, or determine the impact of shadows in Sun Shadow Frequency and Sun Shadow Volume.
Using this tool, you can create 3D object feature layers directly without having to import the 3D models into a multipatch or modify the multipatch to be enhanced with 3D object feature layer capabilities. This tool also supports more 3D model formats than the Import 3D Files tool. The following 3D formats can be imported:
- COLLADA (.dae)
- Drawing (.dwg)
- Autodesk Filmbox (.fbx)
- Graphics Library Transmission (.glb)
- JSON Graphics Library Transmission (.gltf)
- Industry Foundation Class (.ifc)
- Wavefront Object (.obj)
- Universal Scene Description (.usdc)
- Compressed Universal Scene Description (.usdz)
When a new 3D object feature class is created and the models being imported have a spatial reference, the 3D object feature class will inherit the coordinate system of the models. If the models you are importing do not have a coordinate system, the output's coordinate system will be WGS 1984 Web Mercator (WKID 3857), which uses a linear unit of meters. If the 3D models have a linear unit, its coordinates will be automatically converted to match the output projection. When the 3D models do not have linear units defined, the Scale Factor (scale in python) parameter can be used to apply the appropriate conversion.
Parameters
arcpy.management.Import3DObjects(files_and_folders, updated_features, {update}, {translate}, {elevation}, {scale}, {rotate})
Name | Explanation | Data Type |
files_and_folders [files_and_folders,...] | The 3D files or folders containing 3D files that will be imported. When a folder is provided, all supported 3D models contained in it and its subdirectories will be imported. The following models are supported:
| File; Folder |
updated_features | The 3D object feature layer that will be created or updated. | Feature Layer |
update (Optional) | Specifies how an existing 3D object feature class will be handled.
| String |
translate (Optional) | The x- and y-coordinate offset that will be applied to the imported models. | Point |
elevation (Optional) | The height offset that will be applied to the imported models. | Double |
scale (Optional) | The scale factor that will be used to resize the 3D models being imported. | Double |
rotate (Optional) | The degree rotation angle that will be applied to the imported models. Rotation is applied with the assumption of 0° representing north and angular values incrementing in the clockwise direction. | Double |
Code sample
The following Python window script demonstrates how to use the Export3DObjects function.
import arcpy
arcpy.env.workspace = 'C:/data'
arcpy.management.Import3DObjects("city_models", "Buildings.gdb/imported_models",
scale = 3.28)
Environments
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes