3D-Dateien importieren (3D Analyst)
Zusammenfassung
Hiermit wird mindestens ein 3D-Modell in eine Multipatch-Feature-Class importiert.
Verwendung
-
Es werden die Formate 3D Studio Max (*.3ds), VRML und GeoVRML 2.0 (*.wrl), SketchUp 6.0 (*.skp), OpenFlight 15.8 (*.flt) sowie Billboards (PNG, JPEG, BMP, TIFF, GIF usw.) unterstützt.
-
GeoVRML ist das einzige Format mit einem definierten Koordinatensystem. Die anderen Formate verwenden in der Regel lokale Koordinatensysteme (d. h. zentriert um 0,0,0). Im letzteren Fall müssen die Ausgabe-Shapes georeferenziert werden.
-
Wenn mehrere Dateien eingegeben werden, wird das Koordinatensystem der ersten Datei für alle Dateien verwendet. Für alle anderen Formate als GeoVRML lautet dieses "Unbekannt".
-
Fügen Sie die Ausgabe-Feature-Class in eine Geodatabase ein, um Texturen (Geometrieflächen zugeordnete Bilder) beizubehalten.
-
Falls die obere Seite der Ausgabe-Multipatches seitwärts ausgerichtet ist, können Sie dieses Werkzeug erneut verwenden und dabei den Parameter Y_Is_Up auf "True" festlegen (aktivieren), um die Ausrichtung ordnungsgemäß anzupassen.
-
Nicht unterstützte Geometrietypen für VRML-Dateien sind: Box, Kegel, Zylinder, Extrusion, PointSet, Kugel und Text.
-
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.
Syntax
| Parameter | Erläuterung | Datentyp |
in_files |
Ein oder mehrere Eingabedateien bzw. ein oder mehrere Ordner mit Daten in unterstützten Formaten. Zu den unterstützten Formaten gehören 3D Studio Max (*.3ds), SketchUp (*.skp), VRML und GeoVRML (*.wrl) sowie OpenFlight (*.flt). | File; Folder |
out_feature_class |
Die zu erstellende Ausgabe-Multipatch-Feature-Class. | Feature Class |
root_per_feature (optional) |
Gibt an, ob ein Feature pro Datei oder ein Feature für jeden Stammknoten in einer Datei generiert werden soll.
| Boolean |
spatial_reference (optional) |
Das Koordinatensystem der Eingabedaten. Die Standardeinstellung wird der ersten Datei in der Liste entnommen. Für die meisten Formate lautet das Koordinatensystem "Unbekannt". GeoVRML ist das einzige Format mit einem bekannten Koordinatensystem. | Spatial Reference |
y_is_up (optional) |
Die vertikale Ausrichtung des Eingabe-Koordinatensystems.
| Boolean |
file_suffix (optional) |
The suffix of the files to import from an input folder. This parameter is required when a folder is specified as input. | String |
Codebeispiel
The following sample demonstrates the use of this tool in the Python window:
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.Import3DFiles_3d("AddisSheraton.skp", "Test.gdb/AddisSheraton", False, "", False)
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''****************************************************************************
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
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
try:
# 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:
# Execute Import3DFiles
arcpy.Import3DFiles_3d(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."
except:
# Returns any other error messages
print arcpy.GetMessages(2)
del arcpy, OpenFlightList, CS, outputFC