3D-Dateien importieren (3D Analyst Tools)

Zusammenfassung

Hiermit wird mindestens ein 3D-Modell in eine Multipatch-Feature-Class importiert.

Verwendung

Behalten Sie die Textur in den 3D-Modellen bei, indem Sie das Ausgabe-Multipatch in einer Geodatabase speichern. Shapefiles unterstützen die Beibehaltung von Texturen nicht.
Falls die obere Seite der entstehenden Multipatch-Features seitwärts ausgerichtet ist, können Sie die Ausrichtung anpassen, indem Sie dieses Werkzeug mit aktiviertem Parameter Y oben erneut verwenden.
GeoVRML ist das einzige Format mit einem definierten Koordinatensystem. Viele 3D-Modelle werden mit lokalen Koordinatensystemen generiert, deren XYZ-Achse um 0, 0, 0 zentriert ist. Solche Features können mit einer der folgenden Methoden mit realen Koordinaten georeferenziert werden:
- Müssen die 3D-Modelle gedreht und verschoben werden, sollten Sie die Verfahren der räumlichen Anpassung anwenden, um die Features ordnungsgemäß zu positionieren.
- Wenn die 3D-Modelle für ein bestimmtes Koordinatensystem ordnungsgemäß ausgerichtet sind und nur in die richtige Position verschoben werden müssen, passen Sie die Koordinatensystem-Eigenschaften so an, dass die notwendige Verschiebung erfolgt. Wenn Punkt-Features, die die Position des Schwerpunktes der einzelnen Modelle in realen Koordinaten definieren, verfügbar sind, verwenden Sie die Punkte als Eingaben für das Werkzeug, um die Modelle zu georeferenzieren.
Punkt- und Liniengeometrien, die in einer 3D-Datei vorhanden sein können, bleiben in der Ausgabe-Multipatch-Feature-Class nicht erhalten, da sie von Multipatches nicht unterstützt werden.

Hinweis:

Nicht unterstützte Geometrietypen für VRML-Dateien sind: Box, Kegel, Zylinder, Extrusion, PointSet, Kugel und Text.

Beschriftung	Erläuterung	Datentyp
Eingabedateien	Ein oder mehrere 3D-Modelle oder Ordner mit solchen Dateien in den unterstützten Formaten 3D Studio Max (`.3ds`), VRML und GeoVRML (`.wrl`), OpenFlight (`.flt`), COLLADA (`.dae`) und Wavefront OBJ-Modelle (*.obj).	File; Folder
Ausgabe-Multipatch-Feature-Class	Das Multipatch, das aus den Eingabedateien erstellt wird.	Feature Class
Ein Stammknoten pro Feature (Optional)	Gibt an, ob pro Datei ein Feature oder für jeden Stammknoten in der Datei ein Feature erzeugt werden soll. Diese Option gilt nur für VRML-Modelle. Aktiviert—Die generierte Ausgabe enthält eine Datei für jedes Feature. Dies ist die Standardeinstellung. Deaktiviert—Die generierte Ausgabe enthält für jeden Stammknoten in der Datei ein Feature.	Boolean
Koordinatensystem (Optional)	Das Koordinatensystem der Eingabedaten. Für die meisten Formate ist dies unbekannt. Nur beim GeoVRML-Format wird das Koordinatensystem gespeichert. Der Standardwert wird aus der ersten Datei in der Liste abgerufen, wenn hier kein Raumbezug angegeben ist.	Spatial Reference
Y oben (Optional)	Gibt die Achse an, welche die vertikale Ausrichtung der Eingabedateien definiert. Aktiviert—Gibt an, dass der Y-Wert oben ist. Deaktiviert—Gibt an, dass der Z-Wert oben ist. Dies ist die Standardeinstellung.	Boolean
Dateisuffix	Die Dateierweiterung der Dateien, die aus einem Eingabeordner importiert werden sollen. Dieser Parameter ist erforderlich, wenn als Eingabe mindestens ein Ordner angegeben wird. Alle unterstützten Dateien—Alle unterstützten Dateien. Dies ist die Standardeinstellung. *3D Studio Max (.3ds)—3D Studio Max VRML oder GeoVRML (.wrl)—VRML oder GeoVRML OpenFlight (.flt)—OpenFlight Collada (.dae)—Collada Wavefront OBJ-Format (.obj)**—Wavefront OBJ-Modell	String
Platzierungspunkte (Optional)	Die Punkt-Features, deren Koordinaten die reale Position der Eingabedateien definieren. Jede Eingabedatei wird auf Basis der Dateinamen, die im Symbolfeld gespeichert sind, mit dem entsprechenden Punkt abgeglichen. Der Parameter Koordinatensystem muss so definiert werden, dass es mit dem Raumbezug der Punkte übereinstimmt.	Feature Layer
Symbolfeld (Optional)	Das Feld in den Punkt-Features, das für jeden Punkt den Namen der zugeordneten 3D-Datei enthält.	Field

arcpy.3d.Import3DFiles(in_files, out_featureClass, {root_per_feature}, {spatial_reference}, {y_is_up}, file_suffix, {in_featureClass}, {symbol_field})

Name	Erläuterung	Datentyp
in_files [in_files,...]	Ein oder mehrere 3D-Modelle oder Ordner mit solchen Dateien in den unterstützten Formaten 3D Studio Max (`.3ds`), VRML und GeoVRML (`.wrl`), OpenFlight (`.flt`), COLLADA (`.dae`) und Wavefront OBJ-Modelle (*.obj).	File; Folder
out_featureClass	Das Multipatch, das aus den Eingabedateien erstellt wird.	Feature Class
root_per_feature (Optional)	Gibt an, ob pro Datei ein Feature oder für jeden Stammknoten in der Datei ein Feature erzeugt werden soll. Diese Option gilt nur für VRML-Modelle. `ONE_FILE_ONE_FEATURE`—Die generierte Ausgabe enthält eine Datei für jedes Feature. Dies ist die Standardeinstellung. `ONE_ROOT_ONE_FEATURE`—Die generierte Ausgabe enthält für jeden Stammknoten in der Datei ein Feature.	Boolean
spatial_reference (Optional)	Das Koordinatensystem der Eingabedaten. Für die meisten Formate ist dies unbekannt. Nur beim GeoVRML-Format wird das Koordinatensystem gespeichert. Der Standardwert wird aus der ersten Datei in der Liste abgerufen, wenn hier kein Raumbezug angegeben ist.	Spatial Reference
y_is_up (Optional)	Gibt die Achse an, welche die vertikale Ausrichtung der Eingabedateien definiert. `Y_IS_UP`—Gibt an, dass der Y-Wert oben ist. `Z_IS_UP`—Gibt an, dass der Z-Wert oben ist. Dies ist die Standardeinstellung.	Boolean
file_suffix	Die Dateierweiterung der Dateien, die aus einem Eingabeordner importiert werden sollen. Dieser Parameter ist erforderlich, wenn als Eingabe mindestens ein Ordner angegeben wird. `*`—Alle unterstützten Dateien. Dies ist die Standardeinstellung. `3DS`—3D Studio Max `WRL`—VRML oder GeoVRML `FLT`—OpenFlight `DAE`—Collada `OBJ`—Wavefront OBJ-Modell	String
in_featureClass (Optional)	Die Punkt-Features, deren Koordinaten die reale Position der Eingabedateien definieren. Jede Eingabedatei wird auf Basis der Dateinamen, die im Symbolfeld gespeichert sind, mit dem entsprechenden Punkt abgeglichen. Der Parameter Koordinatensystem muss so definiert werden, dass es mit dem Raumbezug der Punkte übereinstimmt.	Feature Layer
symbol_field (Optional)	Das Feld in den Punkt-Features, das für jeden Punkt den Namen der zugeordneten 3D-Datei enthält.	Field

Codebeispiel

Import3DFiles Beispiel 1 (Python-Fenster)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.Import3DFiles("AddisSheraton.skp", "Test.gdb/AddisSheraton", False, "", False)

Import3DFiles Beispiel 2 (eigenständiges Skript)

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

'''****************************************************************************
Name: Import3DFiles Example
Description: This script demonstrates how to use the
             ListFiles method to collect all OpenFlight (*.flt) models in a
             workspace as input for the Import3DFiles tool.
****************************************************************************'''

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set Local Variables
OpenFlightList = arcpy.ListFiles("*.flt")
CS = "Coordinate Systems/Geographic Coordinate Systems/World/WGS 1984.prj"
outputFC = "Test.gdb/OpenFlight_Models"

if len(OpenFlightList) > 0:
    # Run Import3DFiles
    arcpy.ddd.Import3DFiles(OpenFlightList, outputFC, False, CS, False)
else:
    # Returned if there are no flt files in the target workspace
    print("There are no OpenFlight files in the " + env.workspace + " directory.")

Umgebungen

Aktueller Workspace, Ausgabe-Koordinatensystem, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Auto-Commit, Ausgabe-CONFIG-Schlüsselwort

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja