Automatisierung
CLI-Parameter
Alle Funktionen verwenden denselben Kern wie die GUI. Die CLI liefert Rückgabecodes und verständliche Fehlermeldungen.
Hilfe und Version
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
--images <Ordner> ist erforderlich. --profile <JSON> lädt optional eine exakte Zuordnung. --recursive/--no-recursive durchsucht Unterordner standardmäßig mit. --include-dark übernimmt nahezu schwarze Bilder, --include-non-panoramas andere Seitenverhältnisse, --include-derived-images bewusst auch Vorschau-/Exportordner und --no-deduplicate Dateikopien sowie doppelte Aufnahmezeitpunkte. --json liefert maschinenlesbare Daten.
Theta-Rundgang-CLI.exe scan --images "U:\Ricoh-Theta\20240121" --profile "profil.json" --json
analyze
--images und --output sind erforderlich. --station-gap-seconds (Standard 300), --station-radius-m (12) und --session-gap-seconds (300) steuern Aufnahmeort-, GPS- und Abschnittsgrenzen. Ein Aufnahmeort braucht mindestens zwei verschiedene Blickwinkel. --detect-timelapses/--no-detect-timelapses schaltet GIFs; --timelapse-min-images fordert standardmäßig 10 Bilder desselben Blickwinkels und --timelapse-interval-tolerance-percent erlaubt höchstens 50 Prozent Unterschied zwischen kleinstem und größtem Intervall. GIFs laufen mit 10 Bildern je Sekunde. Optional ergänzen --floorplan, --floorplan-page ab 1 und --title den Bericht. --open öffnet ihn, --json liefert eine Zusammenfassung. Alle Scan-Filter gelten ebenfalls.
Theta-Rundgang-CLI.exe analyze --images "U:\Theta" --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
build
--images und --output sind erforderlich. Optional: --floorplan, --floorplan-page ab 1, --profile, --title, kommagetrennte --floor-labels, Zeit-/GPS-/Zeitrafferoptionen, --route-strategy mit recommended (Standard), chronological, spatial, segments oder short, alle Scan-Filter und --open. Der Ausgabeordner darf nicht im Bilderordner liegen. Gespeicherte Ausgrauungen werden berücksichtigt.
Theta-Rundgang-CLI.exe build --images "U:\Theta" --floorplan "E:\Grundriss.pdf" --floorplan-page 1 --output "E:\Rundgang" --route-strategy recommended --open
serve
--site ist erforderlich. --port verwendet standardmäßig 8765; --port 0 sucht einen freien lokalen Port. --open öffnet den Browser. Der Server bindet ausschließlich an 127.0.0.1 und speichert die Ortsauswahl im Ausgabeordner.
Theta-Rundgang-CLI.exe serve --site "E:\Rundgang" --port 0 --open
verify
Prüft Szenen, Stationen, Pläne und private Assets. --json erzeugt maschinenlesbare Ausgabe.
Theta-Rundgang-CLI.exe verify --site "E:\Rundgang" --json
web-assets
Prüft die eingebetteten Webassets. Im Quellprojekt werden sie mit npm neu gebaut.
Update-Prüfung bei CLI-Aufrufen
Vor fachlichen CLI-Befehlen gilt dieselbe tägliche Update-Prüfung wie in der GUI. Während der 90-Tage-Frist erscheint ein Hinweis auf die Downloadseite; nach Ablauf endet der Befehl mit Rückgabecode 3. --help und --version bleiben erreichbar.