Mettre à niveau la couche de scènes (Outils de gestion des données)

Résumé

Met à niveau une couche de scène vers la version I3S actuelle au format SLPK ou la génère en sortie au format i3sREST en vue de son utilisation dans ArcGIS Enterprise.

Utilisation

Il est possible de convertir les paquetages de couches de scènes de version 1.4 et ultérieure dans la dernière version I3S. La version I3S d’une couche de scène se trouve dans l’onglet Source des propriétés de la couche. Voir la spécification I3S pour connaître la version actuelle de chaque type de couche de scène. Si la couche de scène est de version 1.6 ou antérieure, il est recommandé de procéder à une mise à niveau afin d’améliorer les performances.
Les couches de scènes de nuages de points ne sont pour l’instant pas prises en charge.
Utilisez le paramètre Texture Optimization (Optimisation de texture) pour ajouter des textures au paquetage de couche de scène en sortie ou en supprimer.
Les avertissements émis au cours du processus de mise à niveau peuvent apparaître dans les messages de l’outil ou le fichier journal en sortie. Les avertissements n’ont pas d’incidence sur le paquetage de couche de scène, mais signalent une non-conformité à la spécification I3S.
Utilisez le paramètre Target Cloud Connection (Connexion Cloud cible) pour produire en sortie le contenu de couche de scène vers un object store situé dans le Cloud tel que 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 que vous choisissez doit être inscrit en tant que data store géré par l’utilisateur dans ArcGIS Enterprise.
Cet outil ne corrige pas les paquetages de couche de scène dont les propriétés requises de la spécification I3S sont manquantes ou incorrectes. Les erreurs sont écrites dans la valeur de paramètre Output Log File (Fichier journal en sortie).
Utilisez l’environnement Time Zone (Fuseau horaire) avec le paramètre Date Format (Format de date) pour encoder correctement les champs de date dans le paquetage de couche de scène en sortie. Pour plus d’informations sur l’activation des propriétés temporelles dans les couches de scène, reportez-vous à la rubrique Couches de scène temporelles.

Etiqueter	Explication	Type de données
Jeu de données en entrée	Couche de scène en entrée ou paquetage de couche de scène	File; Scene Layer
Dossier en sortie	Emplacement dans lequel le paquetage de couche de scène en sortie est créé ou fichier de connexion Cloud (.acs) dans lequel le fichier est généré au format i3sREST.	Folder
Nom en sortie	Nom de la couche de scène en sortie.	String
Fichier journal en sortie (Facultatif)	Fichier journal en sortie qui synthétise les résultats de l’évaluation.	File
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 des résultats plus rapidement, utilisez les options Desktop (Bureau) ou None (Aucun). Tous—Tous les formats de texture et notamment JPEG, DXT et KTX2 sont optimisés pour être utilisés sur les plateformes bureautiques, Web et mobiles. Bureautique—Les textures prises en charge par Windows, Linux et Mac, dont JPEG et DXT, sont optimisées pour être utilisées sur des clients ArcGIS Pro sous Windows et sur des clients de bureau ArcGIS Maps SDKs sous Windows, Linux et Mac. Il s’agit de l’option par défaut. Mobile—Les textures prises en charge par Android et iOS, dont JPEG et KTX2, sont optimisées pour être utilisées dans les applications mobiles ArcGIS Maps SDKs. Aucun—Les textures JPEG sont optimisées pour être utilisées sur les plateformes bureautiques et Web.	String
Format de date (Facultatif)	Format des valeurs de date dans les champs de date des couches de scène. Ce paramètre est masqué si aucun champ de date n’est trouvé.	String

arcpy.management.UpgradeSceneLayer(in_dataset, out_folder_path, out_name, {out_log}, {texture_optimization}, {date_format})

Nom	Explication	Type de données
in_dataset	Couche de scène en entrée ou paquetage de couche de scène	File; Scene Layer
out_folder_path	Emplacement dans lequel le paquetage de couche de scène en sortie est créé ou fichier de connexion Cloud (.acs) dans lequel le fichier est généré au format i3sREST.	Folder
out_name	Nom de la couche de scène en sortie.	String
out_log (Facultatif)	Fichier journal en sortie qui synthétise les résultats de l’évaluation.	File
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 des résultats plus rapidement, utilisez l’option `DESKTOP` ou `NONE`. `ALL`—Tous les formats de texture et notamment JPEG, DXT et KTX2 sont optimisés pour être utilisés sur les plateformes bureautiques, Web et mobiles. `DESKTOP`—Les textures prises en charge par Windows, Linux et Mac, dont JPEG et DXT, sont optimisées pour être utilisées sur des clients ArcGIS Pro sous Windows et sur des clients de bureau ArcGIS Maps SDKs sous Windows, Linux et Mac. Il s’agit de l’option par défaut. `MOBILE`—Les textures prises en charge par Android et iOS, dont JPEG et KTX2, sont optimisées pour être utilisées dans les applications mobiles ArcGIS Maps SDKs. `NONE`—Les textures JPEG sont optimisées pour être utilisées sur les plateformes bureautiques et Web.	String
date_format (Facultatif)	Format des valeurs de date dans les champs de date des couches de scène. Ce paramètre est masqué si aucun champ de date n’est trouvé.	String

Exemple de code

Exemple 1 d’utilisation de la fonction UpgradeSceneLayer (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction UpgradeSceneLayer pour mettre à niveau des paquetages de couche de scène dans un object store qui peut être utilisé dans les processus de publication d’ArcGIS Enterprise.

import arcpy
arcpy.management.UpgradeSceneLayer(r"C:\temp\buildings.slpk",
                                   r"C:\CloudConnections\AWS.acs",
                                   "buildings_upgraded",
                                   r"C:\temp\extracted\out.json", "DESKTOP")

Exemple 2 d’utilisation de la fonction UpgradeSceneLayer (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction UpgradeSceneLayer pour mettre à niveau des paquetages de couches de scènes.

import arcpy
arcpy.management.UpgradeSceneLayer(r"C:\temp\buildings.slpk", r"C:\packages",
                                   "buildings_upgraded",
                                   r"C:\temp\extracted\out.json", "NONE")

Environnements

Fuseau horaire

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui