Importer des fichiers 3D (Outils 3D Analyst)

Résumé

Importe un ou plusieurs modèles 3D dans une classe d’entités multipatch.

Utilisation

Préservez la texture des modèles 3D en stockant le multipatch de sortie dans une géodatabase de données. Les fichiers de formes ne prennent pas en charge la conservation des textures.
Si le côté supérieur des caractéristiques multipatch résultantes est orienté latéralement, essayez d’ajuster l’orientation en utilisant à nouveau cet outil avec le paramètre Y Is Up (Axe des Y vers le haut) activé.
GeoVRML est le seul format à disposer d’un système de coordonnées défini. De nombreux modèles 3D sont générés à l’aide de systèmes de coordonnées locaux qui centrent l’axe XYZ sur 0, 0, 0. De telles caractéristiques peuvent être géoréférencées à des coordonnées réelles en utilisant l’une des méthodes suivantes :
- Si les modèles 3D doivent pivoter et être décalés, envisagez d’utiliser des techniques d’ajustement spatial pour positionner correctement les caractéristiques.
- Si les modèles 3D sont correctement orientés pour un système de coordonnées donné et n’ont besoin que d’être déplacés à la bonne position, envisagez de personnaliser les propriétés Coordinate System (Système de coordonnées) pour produire le décalage nécessaire. Si des entités ponctuelles qui définissent la position du centroïde de chaque modèle dans des coordonnées réelles sont disponibles, envisagez d’utiliser ces points comme entrées pour que l’outil géoréférence les modèles.
Les géométries de point et de ligne qui peuvent exister dans un fichier 3D ne sont pas maintenues dans la classe d’entités multipatch de sortie, car les multipatchs ne les supportent pas.

Remarque :

Les types de géométrie non pris en charge pour les fichiers VRML incluent Box, Cone, Cylinder, Extrusion, PointSet, Sphere et Text.

Etiqueter	Explication	Type de données
Fichiers en entrée	Un ou plusieurs modèles 3D ou dossiers contenant ces fichiers dans les formats pris en charge, à savoir 3D Studio Max (), VRML et GeoVRML (), OpenFlight (), COLLADA () et les modèles Wavefront OBJ (*.obj).	File; Folder
Classe d’entités multipatch en sortie	Entités multipatch qui seront créées à partir des fichiers en entrée.	Feature Class
Une racine par entité (Facultatif)	Indique s’il faut produire une entité par fichier ou une entité pour chaque nœud racine du fichier. Cette option s’applique uniquement aux modèles VRML. Activé—La sortie générée contient un fichier pour chaque entité. Il s’agit de l’option par défaut. Décoché—La sortie générée contient une entité pour chaque nœud racine du fichier.	Boolean
Système de coordonnées (Facultatif)	Système de coordonnées des données en entrée. Pour la plupart des formats, il est inconnu. Seul le format GeoVRML stocke son système de coordonnées et sa valeur par défaut est obtenue à partir du premier fichier de la liste, à moins qu’une référence spatiale ne soit spécifiée à cet endroit.	Spatial Reference
Y Is Up (Axe des Y vers le haut) (Facultatif)	Identifie l’axe qui définit l’orientation verticale des fichiers en entrée. Activé—Indique que l’axe y est en haut. Décoché—Indique que l’axe z est haut. Il s’agit de l’option par défaut.	Boolean
Suffixe de fichier	Extension des fichiers à importer à partir d’un dossier en entrée. Ce paramètre est requis lorsqu’au moins un dossier est spécifié en entrée. Tous les fichiers pris en charge—Tous les fichiers pris en charge. Il s’agit de l’option par défaut. *3D Studio Max (.3ds)—3D Studio Max VRML ou GeoVRML (.wrl)—VRML ou GeoVRML OpenFlight (.flt)—OpenFlight Collada (.dae)—Collada Format Wavefront OBJ (.obj)**—Modèle Wavefront OBJ	String
Points de placement (Facultatif)	Entités ponctuelles dont les coordonnées définissent la position des fichiers en entrée dans le monde réel. Chaque fichier en entrée est associé à son point correspondant en fonction des noms de fichier stockés dans le champ de symbole. Le paramètre Coordinate System (Système de coordonnées) doit être défini de façon à correspondre à la référence spatiale des points.	Feature Layer
Champ de symbole (Facultatif)	Champ dans les entités ponctuelles contenant le nom du fichier 3D associé à chaque point.	Field

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

Nom	Explication	Type de données
in_files [in_files,...]	Un ou plusieurs modèles 3D ou dossiers contenant ces fichiers dans les formats pris en charge, à savoir 3D Studio Max (), VRML et GeoVRML (), OpenFlight (), COLLADA () et les modèles Wavefront OBJ (*.obj).	File; Folder
out_featureClass	Entités multipatch qui seront créées à partir des fichiers en entrée.	Feature Class
root_per_feature (Facultatif)	Indique s’il faut produire une entité par fichier ou une entité pour chaque nœud racine du fichier. Cette option s’applique uniquement aux modèles VRML. `ONE_FILE_ONE_FEATURE`—La sortie générée contient un fichier pour chaque entité. Il s’agit de l’option par défaut. `ONE_ROOT_ONE_FEATURE`—La sortie générée contient une entité pour chaque nœud racine du fichier.	Boolean
spatial_reference (Facultatif)	Système de coordonnées des données en entrée. Pour la plupart des formats, il est inconnu. Seul le format GeoVRML stocke son système de coordonnées et sa valeur par défaut est obtenue à partir du premier fichier de la liste, à moins qu’une référence spatiale ne soit spécifiée à cet endroit.	Spatial Reference
y_is_up (Facultatif)	Identifie l’axe qui définit l’orientation verticale des fichiers en entrée. `Y_IS_UP`—Indique que l’axe y est en haut. `Z_IS_UP`—Indique que l’axe z est haut. Il s’agit de l’option par défaut.	Boolean
file_suffix	Extension des fichiers à importer à partir d’un dossier en entrée. Ce paramètre est requis lorsqu’au moins un dossier est spécifié en entrée. `*`—Tous les fichiers pris en charge. Il s’agit de l’option par défaut. `3DS`—3D Studio Max `WRL`—VRML ou GeoVRML `FLT`—OpenFlight `DAE`—Collada `OBJ`—Modèle Wavefront OBJ	String
in_featureClass (Facultatif)	Entités ponctuelles dont les coordonnées définissent la position des fichiers en entrée dans le monde réel. Chaque fichier en entrée est associé à son point correspondant en fonction des noms de fichier stockés dans le champ de symbole. Le paramètre Coordinate System (Système de coordonnées) doit être défini de façon à correspondre à la référence spatiale des points.	Feature Layer
symbol_field (Facultatif)	Champ dans les entités ponctuelles contenant le nom du fichier 3D associé à chaque point.	Field

Exemple de code

Import3DFiles exemple 1 (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :

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

Import3DFiles exemple 2 (script autonome)

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :

'''****************************************************************************
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.")

Environnements

Espace de travail courant, Système de coordonnées en sortie, Domaine XY en sortie, Domaine Z en sortie, Validation automatique, Mot-clé CONFIG en sortie

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui