Créer le contenu d’une couche de scènes d’objets 3D (Gestion des données)

Synthèse

Crée un paquetage de couche de scènes (.slpk) ou un contenu de couche de scène (.i3sREST) à partir de l’entrée de couche d’entités multipatch ou d’objets 3D.

Utilisation

  • Pour utiliser une classe d’entités multipatch ou d’objets 3D en entrée, vous devez d’abord ajouter la classe d’entités à une scène globale ou locale active en tant que couche d’entités. La couche d’entités obtenue peut alors servir comme entrée pour l’outil. Un fichier de couche (.lyrx) peut également être utilisé comme entrée.

  • Associez le système de coordonnées en sortie à la référence spatiale de la scène web dans laquelle il sera affiché. Si l’environnement d’affichage prévu est une scène web globale, le système de coordonnées en sortie doit utiliser GCS WGS84 ou le système de coordonnées géodésiques 2000 de Chine.

  • Tenez compte des considérations suivantes lors de la définition des coordonnées z dans les données 3D à traiter :

    • Si le paquetage de couche de scène en sortie possède des coordonnées x,y dans le système de coordonnées géographiques WGS84, le système de coordonnées z peut être défini à l’aide d’un datum ellipsoïde, d’EGM96 ou d’EGM2008 via le paramètre Système de coordonnées en sortie. Si le système de coordonnées z n’est pas défini, les unités verticales sont exprimées en mètres.
    • Si le paquetage de couche de scène en sortie stocke les valeurs x,y en coordonnées projetées et que le système de coordonnées z n’est pas défini, les unités verticales sont identiques aux coordonnées x,y. Pour les entités 3D présentant des unités z non définies qui diffèrent des unités x,y, vous pouvez utiliser l’outil Ajuster les valeurs Z 3D pour convertir les valeurs z en une unité linéaire correspondante ou bien l’outil Définir une projection pour définir le datum z approprié.

  • L’altitude des couches multipatch ou d’entités d’objets 3D doit être définie avec des hauteurs absolues. Si un décalage est appliqué à la couche, il est appliqué aux valeurs z de la géométrie des entités. Le décalage ne peut pas être supprimé une fois la couche de scène créée.

  • Seuls les champs désignés comme visibles dans les propriétés de la couche seront conservés dans le paquetage de couches de scènes. Si certains champs ne sont pas nécessaires dans la couche de scène résultante, vous pouvez masquer les colonnes non désirées.

  • Utilisez l’environnement Fuseau horaire si la classe d’entités en entrée contient des champs de date. L’utilisation de cet environnement entraîne l’encodage de la valeur temporelle dans l’heure locale avec un décalage par rapport à UTC ou UTC, si cette option est choisie. Pour plus d’informations sur l’utilisation de propriétés temporelles avec des couches de scène, reportez-vous à la rubrique Couches de scène temporelles.

  • Utilisez le paramètre Connexion Cloud cible pour produire en sortie le contenu de couche de scène vers un object store situé dans le Cloud, comme Amazon S3, Azure Blob Storage, Alibaba OSS ou Google Cloud. Ce contenu peut être publié en tant que service de scène et l’emplacement choisi doit être inscrit en tant que data store géré par l’utilisateur dans ArcGIS Enterprise.

  • Vous pouvez créer un fichier de connexion (.acs) à l’aide de l’outil Créer un fichier de connexion au stockage Cloud.

Paramètres

ÉtiquetteExplicationType de données
Jeu de données en entrée

La couche d’entités multipatch ou couche d’entités d’objets 3D en entrée.

Layer File; Feature Layer
Paquetage de couche de scène en sortie

Paquetage de couche de scène en sortie (.slpk).

File
Système de coordonnées en sortie
(Facultatif)

Système de coordonnées du paquetage de couche de scène en sortie. Il peut s’agir de n’importe quel système de coordonnées projetées ou personnalisées. Les systèmes de coordonnées géographiques pris en charge incluent les systèmes WGS84 et China Geodetic Coordinate System 2000. Les systèmes WGS84 et EGM96 Geoid sont respectivement les systèmes de coordonnées horizontales et verticales par défaut. Le système de coordonnées peut être spécifié de l’une des manières suivantes :

  • Spécifiez le chemin d’accès à un fichier .prj.
  • Référencez un jeu de données avec le système de coordonnées approprié.
  • Utilisez un objet arcpy.SpatialReference.

Spatial Reference
Transformation géographique

La méthode de transformation de datum qui est utilisée lorsque le système de coordonnées de la couche en entrée utilise un datum différent du système de coordonnées en sortie. Toutes les transformations sont bidirectionnelles, quel que soit le sens que leur nom implique. Par exemple, NAD_1927_to_WGS84_3 fonctionne correctement même si la conversion de datum va de WGS84 vers NAD 1927.

Remarque :

Les données des systèmes de coordonnées ArcGIS sont requises pour les transformations de datums verticaux entre des datums ellipsoïdes et des datums liés à la gravité et deux datums liés à la gravité.

String
Optimisation de texture
(Facultatif)

Spécifie les textures qui sont optimisées en fonction de la plateforme cible sur laquelle le paquetage de couche de scène est utilisé.

Attention :

Le traitement des optimisations qui incluent KTX2 peut prendre un certain temps. Pour obtenir plus rapidement des résultats, utilisez les options Bureau ou Aucun.

  • ToutTous les formats de texture, dont JPEG, DXT et KTX2, sont optimisés pour être utilisés sur les plateformes bureautiques, Web et mobiles.
  • BureautiqueLes textures prises en charge par Windows, Linux et Mac, dont JPEG et DXT, sont optimisées pour être utilisées sur des clients AllSource sous Windows et sur des clients de bureau ArcGIS Runtime sous Windows, Linux et Mac. Il s’agit de l’option par défaut.
  • MobileLes textures prises en charge par Android et iOS, dont JPEG et KTX2, sont optimisées pour être utilisées dans les applications mobiles ArcGIS Runtime.
  • AucunLes textures JPEG sont optimisées pour être utilisées sur les plateformes bureautiques et Web.
String
Connexion Cloud cible
(Facultatif)

Fichier de connexion Cloud cible (.acs) dans lequel le contenu de la couche de scène (.i3sREST) est généré.

Folder

arcpy.management.Create3DObjectSceneLayerPackage(in_dataset, out_slpk, {out_coor_system}, transform_method, {texture_optimization}, {target_cloud_connection})
NomExplicationType de données
in_dataset

La couche d’entités multipatch ou couche d’entités d’objets 3D en entrée.

Layer File; Feature Layer
out_slpk

Paquetage de couche de scène en sortie (.slpk).

File
out_coor_system
(Facultatif)

Système de coordonnées du paquetage de couche de scène en sortie. Il peut s’agir de n’importe quel système de coordonnées projetées ou personnalisées. Les systèmes de coordonnées géographiques pris en charge incluent les systèmes WGS84 et China Geodetic Coordinate System 2000. Les systèmes WGS84 et EGM96 Geoid sont respectivement les systèmes de coordonnées horizontales et verticales par défaut. Le système de coordonnées peut être spécifié de l’une des manières suivantes :

  • Spécifiez le chemin d’accès à un fichier .prj.
  • Référencez un jeu de données avec le système de coordonnées approprié.
  • Utilisez un objet arcpy.SpatialReference.

Spatial Reference
transform_method
[transform_method,...]

La méthode de transformation de datum qui est utilisée lorsque le système de coordonnées de la couche en entrée utilise un datum différent du système de coordonnées en sortie. Toutes les transformations sont bidirectionnelles, quel que soit le sens que leur nom implique. Par exemple, NAD_1927_to_WGS84_3 fonctionne correctement même si la conversion de datum va de WGS84 vers NAD 1927.

Remarque :

Les données des systèmes de coordonnées ArcGIS sont requises pour les transformations de datums verticaux entre des datums ellipsoïdes et des datums liés à la gravité et deux datums liés à la gravité.

String
texture_optimization
(Facultatif)

Spécifie les textures qui sont optimisées en fonction de la plateforme cible sur laquelle le paquetage de couche de scène est utilisé.

Attention :

Le traitement des optimisations qui incluent KTX2 peut prendre un certain temps. Pour obtenir plus rapidement des résultats, utilisez les options DESKTOP ou NONE.

  • ALLTous les formats de texture, dont JPEG, DXT et KTX2, sont optimisés pour être utilisés sur les plateformes bureautiques, Web et mobiles.
  • DESKTOPLes textures prises en charge par Windows, Linux et Mac, dont JPEG et DXT, sont optimisées pour être utilisées sur des clients AllSource sous Windows et sur des clients de bureau ArcGIS Runtime sous Windows, Linux et Mac. Il s’agit de l’option par défaut.
  • MOBILELes textures prises en charge par Android et iOS, dont JPEG et KTX2, sont optimisées pour être utilisées dans les applications mobiles ArcGIS Runtime.
  • NONELes textures JPEG sont optimisées pour être utilisées sur les plateformes bureautiques et Web.
String
target_cloud_connection
(Facultatif)

Fichier de connexion Cloud cible (.acs) dans lequel le contenu de la couche de scène (.i3sREST) est généré.

Folder

Exemple de code

Exemple 1 d’utilisation de l’outil Create3DObjectSceneLayerPackage (fenêtre Python)

Le script ci-dessous montre comment utiliser la fonction Create3DObjectSceneLayerPackage dans la fenêtre Python.

import arcpy
arcpy.management.Create3DObjectSceneLayerPackage(
    r'c:\temp\buildings.lyrx', r'c:\temp\output.slpk', 
    arcpy.SpatialReference(4326), None, 'DESKTOP')
Exemple 2 d’utilisation de l’outil Create3DObjectSceneLayerPackage (fenêtre Python)

Le script ci-dessous illustre l’utilisation de la fonction Create3DObjectSceneLayerPackage dans la fenêtre Python à l’aide du paramètre target_cloud_connection.

import arcpy
arcpy.management.Create3DObjectSceneLayerPackage(
    r'c:\temp\buildings.lyrx', None, arcpy.SpatialReference(4326), None, 
    'DESKTOP', r'c:\cloudConnections\AWS.acs')

Environnements