Allgemein
Theta-Rundgang-CLI.exe --help Theta-Rundgang-CLI.exe --version
-h und --help zeigen die Hilfe. --version meldet die installierte Version. Ohne Unterbefehl zeigt die separate CLI ihre Hilfe; die GUI-EXE startet ohne Parameter die Oberfläche.
scan
Prüft den Bilderordner, ohne eine Website zu schreiben.
Theta-Rundgang-CLI.exe scan --images "U:\Ricoh-Theta\20240121" --profile "profiles\haus-des-gastes.json" --json
--images <Ordner> ist erforderlich. --profile <JSON> wendet optional eine exakte Projektzuordnung an. --recursive/--no-recursive durchsucht Unterordner standardmäßig mit. --include-dark übernimmt auch nahezu schwarze Bilder. --include-non-panoramas erlaubt Bilder außerhalb des ungefähren 2:1-Formats. --include-derived-images übernimmt bewusst auch erkannte Vorschau-, Thumbnail-, IrfanView- und Exportordner; standardmäßig bleiben sie aus. --no-deduplicate behält Dateikopien und mehrfach belegte Aufnahmezeitpunkte. --json gibt das Ergebnis maschinenlesbar aus.
analyze
Ordnet Bilder anhand von Aufnahmezeiten, GPS-Koordinaten und Blickwinkeln, trennt Aufnahmeabschnitte und erzeugt lokale Vorschläge der Typen Aufnahmeort und Zeitraffer.
Theta-Rundgang-CLI.exe analyze --images "U:\Ricoh-Theta\20240121" --output "E:\Rundgang" --station-gap-seconds 300 --station-radius-m 12 --session-gap-seconds 300 --timelapse-min-images 10 --timelapse-interval-tolerance-percent 50 --open
--output <Ordner> ist erforderlich. --station-gap-seconds begrenzt den Abstand aufeinanderfolgender Bilder eines Aufnahmeorts standardmäßig auf 300 Sekunden, --station-radius-m den GPS-Abstand auf 12 Meter und --session-gap-seconds die Abschnittstrennung auf 300 Sekunden. Ein Aufnahmeort benötigt mindestens zwei unterschiedliche Blickwinkel. --detect-timelapses/--no-detect-timelapses schaltet die GIF-Erkennung. --timelapse-min-images fordert standardmäßig mindestens 10 Bilder desselben Blickwinkels; --timelapse-interval-tolerance-percent erlaubt höchstens 50 Prozent Unterschied zwischen kleinstem und größtem Intervall. Das GIF läuft fest mit 10 Bildern je Sekunde. --floorplan und --floorplan-page ab 1 ergänzen optional einen Plan. --title setzt den sichtbaren Titel, --open öffnet den lokalen Bericht und --json gibt eine Zusammenfassung aus. Zusätzlich gelten alle Scan-Filter.
build
Erzeugt die vollständige Rundgang-Website. --floorplan ist optional; --floorplan-page beginnt mit 1.
Theta-Rundgang-CLI.exe build --images "U:\Ricoh-Theta\20240121" --floorplan "E:\Grundriss.pdf" --floorplan-page 1 --output "E:\Rundgang" --route-strategy recommended --open
--images und --output sind erforderlich. --floorplan ist optional; --floorplan-page beginnt mit 1. --profile lädt optional ein exaktes JSON-Profil. --title setzt den Seitentitel. --floor-labels erwartet kommagetrennte Ebenen. --route-strategy wählt die globale Reihenfolge aus recommended (Standard), chronological, spatial, segments oder short. Zeit-, GPS-, Zeitraffer- und Scan-Optionen entsprechen analyze. --open öffnet die fertige Website. Der Ausgabeordner darf aus Sicherheitsgründen nicht im Bilderordner liegen.
serve
--site <Ordner> ist erforderlich. --port <Zahl> verwendet standardmäßig 8765; 0 sucht automatisch einen freien Port. --open öffnet den Browser. Der Server bindet nur an 127.0.0.1 und speichert die Auswahl der Ortsvorschläge lokal im Ausgabeordner.
Theta-Rundgang-CLI.exe serve --site "E:\Rundgang" --port 0 --open
verify
--site <Ordner> ist erforderlich. Der Befehl prüft Zuordnungen, Grundrissdateien, Panorama-Assets und den Schutz privater Szenen. --json liefert das Ergebnis maschinenlesbar.
Theta-Rundgang-CLI.exe verify --site "E:\Rundgang" --json
web-assets
Prüft in der installierten EXE die eingebetteten Webassets. Beim Aufruf aus dem Quellprojekt werden die React/Vite-Webassets neu gebaut; nur dafür sind Node.js und npm erforderlich.
Theta-Rundgang-CLI.exe web-assets
Update-Prüfung und Rückgabecode 3
Vor fachlichen CLI-Befehlen gilt die tägliche Update-Prüfung aus dem Handbuch. Während der 90-Tage-Frist wird die Downloadseite genannt. Nach Ablauf beendet die CLI fachliche Befehle mit Rückgabecode 3, bis die notwendige Version installiert ist. --help und --version bleiben erreichbar.