3D-Objekte importieren (Data Management Tools)

Zusammenfassung

Importiert 3D-Modelle aus einem oder mehreren 3D-Dateiformaten und erstellt oder aktualisiert einen 3D-Objekt-Feature-Layer.

Verwendung

Die 3D-Objekt-Feature-Class ermöglicht das Speichern, Georeferenzieren und Visualisieren von 3D-Modellen in ArcGIS Pro mithilfe ihrer nativen Rendering-Funktionen, z. B. Lichteffekte, Reflexion und Materialien

Weitere Informationen zum 3D-Objekt-Feature-Layer
Die Geometrie einer 3D-Objekt-Feature-Class kann in jedem Geoverarbeitungswerkzeug verwendet werden, das Multipatch-Features unterstützt. Mit einem 3D-Objekt-Feature-Layer können z. B. die Sichtlinien in Sichtbarkeitslinie und Sichtverbindung analysiert oder die Auswirkungen von Schatten in Sonnenschattenhäufigkeit und Sonnenschattenvolumen bestimmt werden.
Sie können mit diesem Werkzeug 3D-Objekt-Feature-Layer direkt erstellen, ohne die 3D-Modelle in ein Multipatch importieren oder das Multipatch mit Funktionen des 3D-Objekt-Feature-Layers verbessern zu müssen. Dieses Werkzeug unterstützt zudem mehr 3D-Modellformate als das Werkzeug 3D-Dateien importieren. Die folgenden 3D-Formate können importiert werden.
- 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)
- CityGML (.gml)
Wenn eine 3D-Objekt-Feature-Class erstellt wird und die importierten Modelle einen Raumbezug aufweisen, übernimmt die 3D-Objekt-Feature-Class das Koordinatensystem der Modelle. Wenn die importierten Modelle über kein Koordinatensystem verfügen, ist das Koordinatensystem der Ausgabe WGS84 Web Mercator (WKID 3857), mit der linearen Einheit Meter. Wenn die 3D-Modelle eine lineare Einheit aufweisen, werden ihre Koordinaten automatisch konvertiert, damit sie mit der Ausgabeprojektion übereinstimmen. Sind für die 3D-Modelle keine linearen Einheiten definiert, kann zum Anwenden der entsprechenden Konvertierung der Parameter Maßstabsfaktor verwendet werden.
Der Microsoft Windows-Ordner für 3D-Objekte (z. B. C:\Users\<username>\3D Objects) ist kein unterstütztes Verzeichnis für den Import von 3D-Dateien. Wenn sich die 3D-Eingabedatei im Ordner "3D-Objekte" befindet, kopieren Sie sie in einen anderen Ordner.

Beschriftung	Erläuterung	Datentyp
Eingabe-3D-Dateien und -ordner	Die 3D-Dateien oder Ordner mit den 3D-Dateien, die importiert werden. Wenn ein Ordner bereitgestellt wird, werden alle unterstützten 3D-Modelle, die in ihm enthalten sind, sowie seine Unterverzeichnisse importiert. Die folgenden Modelle werden unterstützt: 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`) CityGML (`.gml`) Der Microsoft Windows-Ordner für 3D-Objekte (z. B. `C:\Users\<username>\3D Objects`) ist kein unterstütztes Verzeichnis für den Import von 3D-Dateien. Wenn sich die 3D-Eingabedatei im Ordner "3D-Objekte" befindet, kopieren Sie sie in einen anderen Ordner.	File; Folder
Ausgabe-3D-Objekt-Feature-Class	Der 3D-Objekt-Feature-Layer, der erstellt oder aktualisiert wird.	Feature Layer
Aktualisierungsstrategie (Optional)	Gibt an, wie eine vorhandene 3D-Objekt-Feature-Class aktualisiert werden soll. Alle vorhandenen Modelle ersetzen—Alle in der 3D-Objekt-Feature-Class vorhandenen Features werden entfernt, und nur die als Eingabe angegebenen 3D-Modelle werden hinzugefügt. Nur vorhandene Modelle aktualisieren—In der 3D-Objekt-Feature-Class vorhandene 3D-Modelle werden aktualisiert. Neue Modelle werden übersprungen. Vorhandene Modelle aktualisieren und neue hinzufügen—In der 3D-Objekt-Feature-Class vorhandene 3D-Modelle werden aktualisiert, und neue Modelle werden angehängt. Dies ist die Standardeinstellung. Alle Modelle hinzufügen—Alle 3D-Modelle werden hinzugefügt, ohne 3D-Modelle zu ersetzen, die derzeit in der 3D-Objekt-Feature-Class vorhanden sind.	String
XY-Versatz (Optional)	Der Versatz der X- und Y-Koordinaten, der auf die importierten Modelle angewendet wird.	Point
Höhenversatz (Optional)	Der Höhenversatz, der auf die importierten Modelle angewendet wird.	Double
Maßstabsfaktor (Optional)	Der Maßstabsfaktor, der zum Ändern der Größe der importierten 3D-Modelle verwendet wird.	Double
Drehwinkel (Optional)	Der Drehwinkel in Grad, der auf die importierten Modelle angewendet wird. Bei der Anwendung von Rotation stellt 0 Grad (0°) Norden dar, und die Winkelwerte erhöhen sich im Uhrzeigersinn.	Double
Der Y-Wert ist vertikal, wenn nicht durch Daten angegeben.	Gibt an, ob Y-Koordinaten vertikal als Höhe oder entlang der horizontalen Ebene interpretiert werden sollen. Dieser Parameter wird nur für Wavefront Object-Dateien (`.obj`) unterstützt. Aktiviert—Y-Koordinaten werden vertikal als Höhe interpretiert. Dies ist die Standardeinstellung. Deaktiviert—Z-Koordinaten werden vertikal als Höhe interpretiert.	Boolean

arcpy.management.Import3DObjects(files_and_folders, updated_features, {update}, {translate}, {elevation}, {scale}, {rotate}, y_is_up)

Name	Erläuterung	Datentyp
files_and_folders [files_and_folders,...]	Die 3D-Dateien oder Ordner mit den 3D-Dateien, die importiert werden. Wenn ein Ordner bereitgestellt wird, werden alle unterstützten 3D-Modelle, die in ihm enthalten sind, sowie seine Unterverzeichnisse importiert. Die folgenden Modelle werden unterstützt: 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`) CityGML (`.gml`) Der Microsoft Windows-Ordner für 3D-Objekte (z. B. `C:\Users\<username>\3D Objects`) ist kein unterstütztes Verzeichnis für den Import von 3D-Dateien. Wenn sich die 3D-Eingabedatei im Ordner "3D-Objekte" befindet, kopieren Sie sie in einen anderen Ordner.	File; Folder
updated_features	Der 3D-Objekt-Feature-Layer, der erstellt oder aktualisiert wird.	Feature Layer
update (Optional)	Gibt an, wie eine vorhandene 3D-Objekt-Feature-Class aktualisiert werden soll. `REPLACE_ALL`—Alle in der 3D-Objekt-Feature-Class vorhandenen Features werden entfernt, und nur die als Eingabe angegebenen 3D-Modelle werden hinzugefügt. `UPDATE_EXISTING`—In der 3D-Objekt-Feature-Class vorhandene 3D-Modelle werden aktualisiert. Neue Modelle werden übersprungen. `UPDATE_EXISTING_ADD_NEW`—In der 3D-Objekt-Feature-Class vorhandene 3D-Modelle werden aktualisiert, und neue Modelle werden angehängt. Dies ist die Standardeinstellung. `ADD_ALL`—Alle 3D-Modelle werden hinzugefügt, ohne 3D-Modelle zu ersetzen, die derzeit in der 3D-Objekt-Feature-Class vorhanden sind.	String
translate (Optional)	Der Versatz der X- und Y-Koordinaten, der auf die importierten Modelle angewendet wird.	Point
elevation (Optional)	Der Höhenversatz, der auf die importierten Modelle angewendet wird.	Double
scale (Optional)	Der Maßstabsfaktor, der zum Ändern der Größe der importierten 3D-Modelle verwendet wird.	Double
rotate (Optional)	Der Drehwinkel in Grad, der auf die importierten Modelle angewendet wird. Bei der Anwendung von Rotation stellt 0 Grad (0°) Norden dar, und die Winkelwerte erhöhen sich im Uhrzeigersinn.	Double
y_is_up	Gibt an, ob Y-Koordinaten vertikal als Höhe oder entlang der horizontalen Ebene interpretiert werden sollen. Dieser Parameter wird nur für Wavefront Object-Dateien (`.obj`) unterstützt. `Y_IS_UP`—Y-Koordinaten werden vertikal als Höhe interpretiert. Dies ist die Standardeinstellung. `Z_IS_UP`—Z-Koordinaten werden vertikal als Höhe interpretiert.	Boolean

Codebeispiel

Import3DObjects: Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:

import arcpy
arcpy.env.workspace = 'C:/project_directory'

arcpy.management.Import3DObjects("import_models",
                                 "city_models.gdb/Downtown_Buildings",
                                 update="ADD_ALL", translate="50 100.5",
                                 elevation=-52.73, scale=0.3048, rotate=15.25)

Import3DObjects: Beispiel 2 (Workflow)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht:

import arcpy
arcpy.env.workspace = 'C:/project_directory'
arcpy.env.overwriteOutput = True

# Export the feature class or layer to model files on disk
arcpy.management.Export3DObjects("city_models.gdb/Downtown_Buildings",
                                 "exported_models", ["FMT3D_IFC"])

# Optionally, edit the exported model files in other software, or replace the
# files with a new version.
# Keep the file names the same to update existing features. New file names are
# interpreted as new features.

# The input folder and feature class or layer in Import 3D Objects are the same
# values used in Export 3D Objects.
arcpy.management.Import3DObjects("exported_models",
                                 "city_models.gdb/Downtown_Buildings",
                                 update="UPDATE_EXISTING_ADD_NEW",
                                 translate="350 150",
                                 elevation=100, scale=2.54, rotate=-90)

Umgebungen

Aktueller Workspace, Scratch-Workspace

Lizenzierungsinformationen