Szenen-Layer-Inhalt mit integrierten Meshes erstellen (Datenmanagement)

Zusammenfassung

Erstellt Szenen-Layer-Inhalte (.slpk oder .i3sREST) aus binären OpenSceneGraph-Daten (OSGB).

Verwendung

  • Ähnlich wie andere 3D-Grafikformate unterstützt das OSGB-Datenformat nativ nicht die Angabe oder Erfassung des Koordinatensystems des Modells. Normalerweise werden Dateien im OSGB-Format in einem kartesischen Koordinatensystem ausgegeben, das Daten bei festen Koordinaten verortet. Die X-, Y- und Z-Koordinaten des Modells sind nicht grundsätzlich geographische Positionen, sondern Positionen relativ zu einem beliebigen geometrischen Ursprung (0, 0, 0). Ein typisches Koordinatensystem, das für solche Modelle verwendet wird, ist die ENU-Konvention (Easting-Northing-UP, Ostwert-Nordwert-oben). Dabei verläuft die X-Achse in Richtung Osten, die Y-Achse in Richtung Norden und die Z-Achse nach oben. Um das Modell ordnungsgemäß zu georeferenzieren, wird eine zusätzliche Metadaten-Datei (.xml, .3mx) oder World-File (.wld3) benötigt, die auf derselben Ebene wie der Ordner mit den Dateien im OSGB-Format gespeichert oder über den Parameter Ankerpunkt angegeben werden kann.

  • Wenn keine Datei zur Georeferenzierung des Modells verfügbar ist, können Sie ein .wld3-File erstellen, um den Ursprung anzugeben. Diese durch Leerzeichen oder Komma getrennte Datei kann in Dezimalgraden als <From x,y,z> <space> <To x,y,z> formatiert werden.

    Ein Beispiel-World-File zur Georeferenzierung des Modells. Es muss nur ein Koordinatenpaar die Ankerpunkt-Koordinaten enthalten.

    0, 0, 0 -117.17222, 34.0392512, 0
  • Wenn die Dateien im OSGB-Format mit einem bekannten Koordinatensystem erstellt wurden, speichern Sie die Projektionsdatei (.prj) auf derselben Ebene wie der Ordner mit den Dateien im OSGB-Format, um das Modell ordnungsgemäß zu georeferenzieren. Lautet der Eingabe-Pfad beispielsweise C:\temp\data und befinden sich die Dateien im OSGB-Format in den Unterordnern C:\temp\data\Tile_001 und C:\temp\data\Tile_002, speichern Sie die Projektions- oder Metadaten-Datei im Ordner C:\temp\data.

  • Der folgenden Tabelle können Sie entnehmen, welche Georeferenzierungsdatei für die einzelnen Eingabe-Koordinatensysteme des OSGB-Modells zu verwenden sind:

    Eingabe-KoordinatensystemGeoreferenzierungsdatei

    Lokales Koordinatensystem (ENU)

    .xml-, .wld3- oder .3mx-Datei oder Point-Feature-Class

    Projiziertes Koordinatensystem

    Projektionsdatei (.prj)

    Geographisches Koordinatensystem

    Projektionsdatei (.prj)

  • Verwenden Sie den Parameter Maximale Texturgröße, um die Texturgröße pro Knoten im Ausgabe-Szenen-Layer-Paket festzulegen. Texturgrößen über 4096 werden möglicherweise nicht auf allen Plattformen unterstützt. Scene Viewer unterstützt eine maximale Texturgröße von 8192.

  • Dateien im OSGB-Format werden von Drone2Map und Drittanbietern erstellt. Eine vollständige Liste der Anbieter finden Sie unter Szenen-Layer mit integrierten Meshes.

  • Verwenden Sie den Parameter Ziel-Cloud-Verbindung, um den Inhalt des Szenen-Layers in einen Objektspeicher in der Cloud auszugeben (z. B. Amazon S3, Azure Blob-Speicher, Alibaba OSS oder Google Cloud. Dieser Inhalt kann als Szenen-Service veröffentlicht werden, und der von Ihnen ausgewählte Speicherort muss als ein benutzerverwalteter Data Store in ArcGIS Enterprise registriert sein.

  • Sie können eine Verbindungsdatei erstellen (.acs), indem Sie das Werkzeug Verbindungsdatei für Cloud-Speicher erstellen verwenden.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Dataset

Die Dateien im OSGB-Format oder Ordner mit Dateien im OSGB-Format, die in das Szenen-Layer-Paket mit integrierten Meshes importiert werden. Dieser Parameter ermöglicht die Auswahl mehrerer Dateien im OSGB-Format oder die Auswahl mehrerer Ordner mit Dateien im OSGB-Format.

File; Folder
Ausgabe-Szenen-Layer-Paket
(optional)

Das Szenen-Layer-Paket mit integrierten Meshes, das erstellt wird. Dieser Parameter ist erforderlich, wenn für den Parameter Ziel-Cloud-Verbindung kein Wert angegeben ist.

File
Ankerpunkt
(optional)

Das Punkt-Feature bzw. die .3mx-, .xml- oder .wld3-Datei, mit dem/der der Mittelpunkt des OSGB-Modells positioniert wird. Wenn die Feature-Class mehrere Punkte enthält, wird nur der erste Punkt für die Georeferenzierung der Daten verwendet.

Feature Layer; File
Dateisuffix
(optional)

Gibt die Dateien an, die für das Eingabe-Dataset verarbeitet werden.

  • Alle unterstützten DateienAlle Binärdateien werden unabhängig von ihrer Erweiterung verarbeitet, um zu ermitteln, ob sie das OSGB-Format aufweisen.
  • Dateien mit der Erweiterung *.osgbNur Dateien mit der .osgb-Erweiterung werden verarbeitet.
String
Ausgabe-Koordinatensystem
(optional)

Das Koordinatensystem des Ausgabe-Szenen-Layer-Pakets. Dies kann ein beliebiges projiziertes oder benutzerdefiniertes Koordinatensystem sein. Die unterstützten geographischen Koordinatensysteme sind u. a. "WGS84" und "China Geodetic Coordinate System 2000". Die horizontalen und vertikalen Standardkoordinatensysteme sind WGS84 und EGM96 Geoid. Das Koordinatensystem kann mit einer der folgenden Methoden angegeben werden:

  • Legen Sie den Pfad zu einer .prj-Datei fest.
  • Referenzieren Sie ein Dataset mit dem richtigen Koordinatensystem.
  • Verwenden Sie ein arcpy.SpatialReference-Objekt.

Spatial Reference
Maximale Texturgröße
(optional)

Die maximale Texturgröße der einzelnen Szenen-Layer-Knoten in Pixeln.

Long
Texturoptimierung
(optional)

Gibt die optimierten Texturen gemäß der Zielplattform, auf der das Szenen-Layer-Paket verwendet wird, an.

Vorsicht:

Die Verarbeitung von Optimierungen mit KTX2 kann viel Zeit beanspruchen. Die schnellsten Ergebnisse werden mit den Optionen Desktop oder Keine erzielt.

  • AlleAlle Texturformate werden zur Verwendung auf Desktop-, Web- und mobilen Plattformen optimiert, einschließlich JPEG, DXT und KTX2.
  • DesktopVon Windows, Linux und Mac unterstützte Texturen werden optimiert. Dazu gehören auch JPEG- und DXT-Texturen zur Verwendung in AllSource-Clients unter Windows und ArcGIS Runtime-Desktop-Clients unter Windows, Linux und Mac. Dies ist die Standardeinstellung.
  • MobilVon Android und iOS unterstützte Texturen wie JPEG und KTX2 werden zur Verwendung in mobilen ArcGIS Runtime-Anwendungen optimiert.
  • KeineJPEG-Texturen werden zur Verwendung auf Desktop- und Web-Plattformen optimiert.
String
Ziel-Cloud-Verbindung
(optional)

Die Ziel-Cloud-Verbindungsdatei (.acs), in der der Inhalt der Szenen-Layer (.i3sREST) ausgegeben wird.

Folder
Ausgabename
(optional)

Der Ausgabename der Szenen-Layer-Inhalte bei Ausgabe in einen Cloud-Speicher. Dieser Parameter ist nur verfügbar, wenn für den Parameter Ziel-Cloud-Verbindung ein Wert angegeben ist.

String

arcpy.management.CreateIntegratedMeshSceneLayerPackage(in_dataset, {out_slpk}, {anchor_point}, {file_suffix}, {out_coor_system}, {max_texture_size}, {texture_optimization}, {target_cloud_connection}, {out_name})
NameErläuterungDatentyp
in_dataset
[in_dataset,...]

Die Dateien im OSGB-Format oder Ordner mit Dateien im OSGB-Format, die in das Szenen-Layer-Paket mit integrierten Meshes importiert werden. Dieser Parameter ermöglicht die Auswahl mehrerer Dateien im OSGB-Format oder die Auswahl mehrerer Ordner mit Dateien im OSGB-Format.

File; Folder
out_slpk
(optional)

Das Szenen-Layer-Paket mit integrierten Meshes, das erstellt wird. Dieser Parameter ist erforderlich, wenn für den Parameter Ziel-Cloud-Verbindung kein Wert angegeben ist.

File
anchor_point
(optional)

Das Punkt-Feature bzw. die .3mx-, .xml- oder .wld3-Datei, mit dem/der der Mittelpunkt des OSGB-Modells positioniert wird. Wenn die Feature-Class mehrere Punkte enthält, wird nur der erste Punkt für die Georeferenzierung der Daten verwendet.

Feature Layer; File
file_suffix
(optional)

Gibt die Dateien an, die für das Eingabe-Dataset verarbeitet werden.

  • *Alle Binärdateien werden unabhängig von ihrer Erweiterung verarbeitet, um zu ermitteln, ob sie das OSGB-Format aufweisen.
  • osgbNur Dateien mit der .osgb-Erweiterung werden verarbeitet.
String
out_coor_system
(optional)

Das Koordinatensystem des Ausgabe-Szenen-Layer-Pakets. Dies kann ein beliebiges projiziertes oder benutzerdefiniertes Koordinatensystem sein. Die unterstützten geographischen Koordinatensysteme sind u. a. "WGS84" und "China Geodetic Coordinate System 2000". Die horizontalen und vertikalen Standardkoordinatensysteme sind WGS84 und EGM96 Geoid. Das Koordinatensystem kann mit einer der folgenden Methoden angegeben werden:

  • Legen Sie den Pfad zu einer .prj-Datei fest.
  • Referenzieren Sie ein Dataset mit dem richtigen Koordinatensystem.
  • Verwenden Sie ein arcpy.SpatialReference-Objekt.

Spatial Reference
max_texture_size
(optional)

Die maximale Texturgröße der einzelnen Szenen-Layer-Knoten in Pixeln.

Long
texture_optimization
(optional)

Gibt die optimierten Texturen gemäß der Zielplattform, auf der das Szenen-Layer-Paket verwendet wird, an.

Vorsicht:

Die Verarbeitung von Optimierungen mit KTX2 kann viel Zeit beanspruchen. Die schnellsten Ergebnisse werden mit den Optionen Desktop oder None erzielt.

  • AllAlle Texturformate werden zur Verwendung auf Desktop-, Web- und mobilen Plattformen optimiert, einschließlich JPEG, DXT und KTX2.
  • DesktopVon Windows, Linux und Mac unterstützte Texturen werden optimiert. Dazu gehören auch JPEG- und DXT-Texturen zur Verwendung in AllSource-Clients unter Windows und ArcGIS Runtime-Desktop-Clients unter Windows, Linux und Mac. Dies ist die Standardeinstellung.
  • MobileVon Android und iOS unterstützte Texturen wie JPEG und KTX2 werden zur Verwendung in mobilen ArcGIS Runtime-Anwendungen optimiert.
  • NoneJPEG-Texturen werden zur Verwendung auf Desktop- und Web-Plattformen optimiert.
String
target_cloud_connection
(optional)

Die Ziel-Cloud-Verbindungsdatei (.acs), in der der Inhalt der Szenen-Layer (.i3sREST) ausgegeben wird.

Folder
out_name
(optional)

Der Ausgabename der Szenen-Layer-Inhalte bei Ausgabe in einen Cloud-Speicher. Dieser Parameter ist nur verfügbar, wenn ein Wert für den Parameter target_cloud_connection angegeben wurde.

String

Codebeispiel

CreateIntegratedMeshSceneLayerPackage – Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.CreateIntegratedMeshSceneLayerPackage_management(
    "terrain_osgb", "mesh.slpk", "anchor.wld3", "OSGB", arcpy.SpatialReference(4326))
CreateIntegratedMeshSceneLayerPackage – Beispiel 2 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster mit mehreren Ordnern als Eingabe veranschaulicht.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.CreateIntegratedMeshSceneLayerPackage_management(
    ["Tile_+001_+001", "Tile_+001_+002", "Tile_+002_+001"], "mesh.slpk", 
    "anchor.shp", "OSGB", arcpy.SpatialReference(4326), 2048, "DESKTOP")
CreateIntegratedMeshSceneLayerPackage – Beispiel 3 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster mit Ausgabe in einen Cloud-Speicher veranschaulicht.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.CreateIntegratedMeshSceneLayerPackage_management(
    ["Tile_+001_+001", "Tile_+001_+002", "Tile_+002_+001"], "mesh.slpk", 
    "anchor.shp", "OSGB", arcpy.SpatialReference(4326), 2048, "DESKTOP",
    'AWS.acs', 'mySceneLayer.i3srest')