Zum Hauptinhalt springen

LOD manuell erstellen (CLI)

Diese Anleitung erklärt, wie du LOD-Dateien für deinen Splat manuell mit dem splat-transform CLI-Tool erstellst und sie zu Arrival.Space hochlädst.

Wann diese Methode verwenden​

Während Arrival.Space eine komfortable Ein-Klick-LOD-Generierung direkt in der Plattform anbietet, gibt es Szenarien, in denen die manuelle LOD-Erstellung vorzuziehen ist:

  • Einzelne PLY-Dateien: Du hast mehrere vorreduzierte .ply-Dateien (z.B. aus externen Tools oder manueller Dezimierung), die du in eine LOD-Struktur kombinieren möchtest.
  • Feingranulare Kontrolle: Du benötigst mehr Kontrolle über die Reduzierungsverhältnisse, Chunk-Größen oder andere Parameter als die Ein-Klick-Funktion bietet.
  • Offline-Verarbeitung: Du möchtest LODs lokal verarbeiten, bevor du sie hochlädst, oder die LOD-Generierung in deine eigene Pipeline integrieren.
  • Sehr große Szenen: Für extrem große Scans kann die lokale Verarbeitung mit erhöhter Speicherzuweisung zuverlässiger sein.
Ein-Klick-Generierung bevorzugt?

Wenn du nur ein schnelles und einfaches LOD-Setup möchtest, schau dir die Ein-Klick LOD-Erstellungsanleitung an -- sie erledigt alles automatisch innerhalb von Arrival.Space.

Kurzfassung​

  1. Erstelle reduzierte Versionen deiner .ply-Datei (oder verwende eine .lcc-Datei mit integrierten LODs)
  2. Generiere die LOD-Struktur: splat-transform [dateien] -l [stufe] output/lod-meta.json
  3. Zippe und lade zu Arrival.Space hoch
  4. Passe die LOD-Einstellungen über die Schaltfläche "Bearbeiten" in der Voreinstellungsauswahl an

splat-transform installieren​

Die Installationsanleitung findest du im Abschnitt Splat Transform Anleitung.

1. Deine LOD-Dateien vorbereiten​

Option A: Eine .lcc-Datei verwenden​

Wenn du eine .lcc-Datei hast, enthält sie normalerweise bereits alle LOD-Stufen. Du kannst die manuellen Reduktionsschritte unten überspringen und direkt mit der Ausgabegenerierung fortfahren.

Option B: .ply-Dateien verwenden​

Beginne mit deiner höchstaufgelösten .ply-Datei. Erstelle dann reduzierte Versionen -- idealerweise jeweils etwa 50% kleiner als die vorherige.

Beispiel für eine 8 GB große Quelldatei:

my_splat_file.ply (8 GB) → LOD 0
my_splat_file_1.ply (4 GB) → LOD 1
my_splat_file_2.ply (2 GB) → LOD 2
my_splat_file_3.ply (1 GB) → LOD 3
my_splat_file_4.ply (512 MB) → LOD 4
my_splat_file_5.ply (256 MB) → LOD 5

2. LOD-Struktur mit splat-transform generieren​

Erstelle einen leeren Zielordner für die finale LOD-Ausgabe:

mkdir LOD_OUT

Für .lcc-Dateien:​

Wichtig: Referenziere die .lcc-Datei direkt (nicht das Zip-Archiv). Die .lcc-Datei befindet sich typischerweise in einem Ordner neben .bin-Dateien (z.B. data.bin, index.bin, attrs.lcp, collision.lci).

Befehlsstruktur:

splat-transform [pfad-zum-ordner]/file.lcc [ausgabe-ordner]/lod-meta.json

Beispiel:

splat-transform ./my_scan_folder/data.lcc LOD_OUT/lod-meta.json

Dies erstellt lod-meta.json und alle LOD-Chunks im LOD_OUT/-Ordner.

Für mehrere .ply-Dateien:​

Ersetze die Dateinamen durch deine tatsächlichen .ply-Dateipfade:

splat-transform \
  my_splat_file.ply    -l 0 \
  my_splat_file_1.ply  -l 1 \
  my_splat_file_2.ply  -l 2 \
  my_splat_file_3.ply  -l 3 \
  my_splat_file_4.ply  -l 4 \
  my_splat_file_5.ply  -l 5 \
  LOD_OUT/lod-meta.json

Dies schreibt eine lod-meta.json-Datei und die entsprechenden LOD-Chunks in das LOD_OUT/-Verzeichnis.

Für sehr große Szenen

Wenn der Befehl bei sehr großen Szenen auf Speicherfehler stößt, kannst du die Node.js-Speicherzuweisung erhöhen:

node --max-old-space-size=32000 node_modules/.bin/splat-transform \
  my_splat_file.ply    -l 0 \
  my_splat_file_1.ply  -l 1 \
  my_splat_file_2.ply  -l 2 \
  my_splat_file_3.ply  -l 3 \
  my_splat_file_4.ply  -l 4 \
  my_splat_file_5.ply  -l 5 \
  LOD_OUT/lod-meta.json

3. Zu Arrival.Space hochladen​

Zippe den LOD-Ordner:

zip -r LOD_OUT.zip LOD_OUT/
  • Lade LOD_OUT.zip als "+ Inhalt" in Arrival.Space hoch
  • (Empfohlen) Lade in einen neuen Space hoch, um alles übersichtlich und organisiert zu halten

4. LOD-Einstellungen anpassen​

Nachdem du dein LOD zu Arrival.Space hochgeladen hast, kannst du die LOD-Einstellungen (Bereiche, Voreinstellungen usw.) direkt in der Plattform feinabstimmen. Siehe die LOD-Erstellungsanleitung - Streaming-Einstellungen anpassen für detaillierte Anweisungen zur Konfiguration von Voreinstellungen für Desktop- und Mobilgeräte.

Weitere Ressourcen​