Mettre à niveau la couche de scène (Gestion des données)

Synthèse

Met à niveau un paquetage de couche de scène dans la version I3S actuelle au format SLPK ou le produit au format i3sREST pour l’utiliser 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. Vous pouvez trouver la version I3S d’une couche de scènes dans l’onglet Source des propriétés de la couche.

  • Les couches de scènes de nuages de points ne sont pour l’instant pas prises en charge.

  • Utilisez le paramètre 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 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.

  • 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 Fuseau horaire avec le paramètre Format de date pour encoder correctement les champs de date dans le paquetage de couche de scène. 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.

Paramètres

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

Paquetage de couche de scène en entrée.

File
Dossier en sortie

Emplacement dans lequel le paquetage de couche de scène 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 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 bureautiques 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
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})
NomExplicationType de données
in_dataset

Paquetage de couche de scène en entrée.

File
out_folder_path

Emplacement dans lequel le paquetage de couche de scène 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 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 bureautiques 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
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 de fenêtre Python ci-dessous montre comment utiliser la fonction UpgradeSceneLayer pour mettre à niveau les paquetages de couches de scènes vers un répertoire d’objets pouvant être utilisé dans les processus de publication 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)

La fenêtre du script Python ci-dessous indique comment utiliser la fonction UpgradeSceneLayer pour mettre à niveau les 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