Kapitel 10 — Einsteiger-Modus

WO

Oben über dem Workflow, immer sichtbar.

TECHNISCH

Zeigt eine horizontale Fortschrittsleiste über die gesamte Pipeline (Frame-Quality → SfM → Training) mit Stage-Allocation: Frame-Quality belegt 0–5 % (Phase 3.11, sehr kurz), SfM belegt 0–30 % der Bar, Training 30–100 %. Daneben Status-Text und phasen-benannte Prozent-Anzeige („SfM 41 %", „Training 12 500/20 000"), damit Anwender nicht den scheinbaren Rückschritt „41 % SfM → 25 % Training" als Fehler lesen — die Bar zeigt den gesamten Pipeline-Fortschritt, nicht die Sub-Stage. ETA-Berechnung beginnt, sobald genug Trainings-Tempo gemessen ist (typischerweise nach den ersten 100 Iterationen). Dieselbe Anzeige wird auch im Expert-Modus oberhalb des Inspectors verwendet.

WO

Linke Seite des Import-Schritts, großes gestricheltes Rechteck mit Symbol. Wird im Einsteiger-Modus mit dem Label „Drop photos or a video here" angezeigt.

TECHNISCH

Drop-Bereich, der das Symbol kurz hüpfen lässt und den Hintergrund einfärbt, sobald Drag-Items über dem Feld schweben. Akzeptiert JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, .radiancescene-Bundles und Verzeichnisse. Drop-Routing nach Typ: Bilder werden gesammelt und sortiert übergeben, Videos triggern den Frame-Sampling-Pfad, Splat-Dateien öffnen direkt die Vorschau, Scene-Bundles werden eingelesen. Verzeichnisse werden enumeriert und alle enthaltenen Bilder importiert. Security-scoped Bookmarks für sandbox-konformen Zugriff werden korrekt aufgenommen und freigegeben. Nicht-unterstützte Endungen werden als Warnbanner für 5 Sekunden angezeigt.

WO

Innerhalb der Drop-Zone, prominenter Button.

TECHNISCH

Button, der den macOS-Datei-Dialog mit Mehrfach-Auswahl und den Dateitypen JPG, PNG, TIFF, MP4, MOV, Ordner sowie dem App-eigenen Scene-Format öffnet. Ergebnis-URLs sind security-scoped und werden über dieselben Import-Pfade weitergeleitet wie Drag-and-Drop. Wenn der Benutzer einen Ordner auswählt, wird er rekursiv nach Bildern enumeriert.

WO

Innerhalb der Drop-Zone, nur sichtbar wenn das App-Bundle die Sample-Scene enthält und noch keine Bilder/Splats importiert sind.

TECHNISCH

Erscheint nur, wenn (a) eine sample-scene.splat, .spz oder .ply im App-Bundle vorhanden ist UND (b) noch keine Bilder/Videos importiert und noch keine Punktwolke vorhanden ist. Bei Klick lädt die fertige Punktwolke (bevorzugt das kleinste Format — .splat ~3 MB, .spz ~1.4 MB, Fallback .ply) und setzt nach 400 ms hartkodierte Kamera-Werte aus dem Original-Metadaten der Blumen-Szene für eine ästhetisch sinnvolle Eingangs-Perspektive.

WO

Innerhalb der Drop-Zone, neben „Try Sample Scene"; gleiche Sichtbarkeits-Bedingungen.

TECHNISCH

Triggert einen Download (Repo github.com/bkindler/radiancekit-sample-photos), der ca. 427 MB an 960 Vollauflösungs-Frames lädt und in die App speist. Während des Downloads wird der Button deaktiviert. Der Fortschritt erscheint in der oberen Progress-Bar als „Downloading X %" in einer eigenen Stage, weil diese Stage ihre eigene 0–100 %-Skala behält und der spätere SfM-Stage nicht überlappt.

WO

Schwebende untere Werkzeugleiste des Import-Overlays, links neben dem Start-Button.

TECHNISCH

Bedienelement mit Label „Quality" gruppiert die verfügbaren Presets nach Kategorie (Classic / MCMC / Custom). Built-in Presets werden nach Kategorie gruppiert; die Abschnitts-Header sind hartkodiert. Custom-Presets nur sichtbar wenn welche existieren. Locked-State: Presets, die nicht in der Free-Liste (Quick + Preview) liegen, bekommen ein „🔒"-Suffix am Namen, wenn der User nicht gekauft hat; bei Auswahl springt der Picker auf Preview zurück und öffnet automatisch das Purchase-Sheet. Bei Wahl wird das Preset angewendet, was die gesamte Trainings-Konfiguration ersetzt.

WO

Schwebende untere Werkzeugleiste des Import-Overlays, rechts neben dem Preset-Picker.

TECHNISCH

Button, der grau bleibt, solange weder Bilder noch ein Video importiert sind. Bei Klick startet die Pipeline und schaltet die Stage-Maschine in die Reihenfolge Frame-Quality → SfM → Training um. Der Button selbst hat keinen weiteren Status; eine laufende Verarbeitung erscheint stattdessen als separater Verarbeitungsbildschirm.

WO

Rechte Bilderliste, sichtbar nur wenn ein Video (statt Bildern) importiert wurde.

TECHNISCH

Schieberegler 0.5 fps – 30 fps in 0.5er-Schritten. Bei Änderung wird die Frame-Dichte aktualisiert und zusätzlich die Anzahl der Zielframes (mindestens 10) aus Dichte und Videolänge berechnet. Der Schieberegler liegt außerhalb der Bilderliste, weil Listen-Elemente Maus-Events von Schiebereglern blockieren würden. Unter dem Schieberegler stehen die berechneten Zielframes („247 frames") und die Videolänge („1m23s video"). Tooltip warnt: „Doubling the density doubles the number of frames and increases SfM time by ~100%."

WO

Rechte Bilderliste, unten rechts; sichtbar nur wenn Bilder importiert wurden.

TECHNISCH

Roter Button. Klick öffnet einen Bestätigungs-Dialog mit Titel „Clear all imported files?" und Message „N images will be removed.". Bestätigung leert alle importierten Bilder/Videos, Staging-Verzeichnisse, die Punktwolke, den Trainings-Status, das SfM-Ergebnis und alle Caches; die Stage springt zurück auf Import. Auf Cancel bleibt alles erhalten. Der Dialog ist als zerstörungsfreier Default-Pfad konfiguriert (zerstörender Button rot markiert).

WO

Rechte Bilderliste, jeder Eintrag.

TECHNISCH

Liste über die importierten Bilder mit Swipe-zum-Löschen. Pro Bild eine Zeile mit Icon, Dateiname, Auflösung („1920 × 1080") und Dateigröße (formatiert KB/MB). Auflösung kommt aus einem Metadaten-Cache, der asynchron aus den Bild-Headern befüllt wird, damit die Oberfläche nicht blockiert. Die Löschen-Aktion bietet macOS-typisches Swipe-Delete (Trackpad-Swipe links auf einer Zeile) sowie Tastatur-Delete bei selektierter Zeile. Hinweis: Der erweiterte Image-Delete-Pfad mit explizitem Minus-Button, Backspace und Cmd-Z zum Rückgängigmachen wurde nur im Expert-Modus im Project Navigator ergänzt — im Einsteiger-Modus bleibt es bei Swipe-Delete.

WO

Unter der Bilderliste, oberhalb des Clear-All-Buttons.

TECHNISCH

Drei aufeinander folgende Schwellen basierend auf der Anzahl importierter Bilder (nur aktiv wenn Bilder vorhanden und kein Video): - < 3 Bilder: rotes Banner (red octagon), Text „At least 3 images are required. Camera alignment cannot be computed from fewer images." - 3–9 Bilder: rotes Banner, Text „With fewer than 10 images, SfM often fails and the trained scene tends to overfit […]. 15–20 images minimum recommended; 30+ for object captures." - 10–19 Bilder: orangefarbenes Banner (warning triangle), Text „Workable, but quality usually improves with 20+ images and good coverage around the scene."

Ab 20 Bildern verschwindet das Banner. Schwellenwerte sind hartkodiert und basieren auf empirischen 560+-Trainings-Experimenten.

WO

Beim Drop eines Ordners — keine sichtbare Schaltfläche, sondern Erkennungs-Logik.

TECHNISCH

Beim Drop eines Verzeichnisses wird geprüft, ob darin eine der drei kanonischen Workspace-Layouts vorliegt: sparse/0/cameras.bin, sparse/cameras.bin oder direkt cameras.bin im Root. Trifft das zu, wird die Standard-Bild-Enumeration abgebrochen und stattdessen ein modaler Alert geöffnet, der den User fragt, ob die bestehende Rekonstruktion verwendet oder die Bilder neu durch Apple Photogrammetry geschickt werden sollen. Gleicher Pfad auch für Text-Format-Workspaces (cameras.txt) und ETH3D-Exporte. Siehe Kapitel 9 Backend Q6 für Details. Wirkt im Einsteiger-Modus genauso wie im Expert-Modus.

WO

Vollflächiger Hintergrund hinter dem Progress-Kreis, ausgeblendet bei Abbruch oder Fehler.

TECHNISCH

Dekorative Animation, die je nach Pipeline-Fortschritt (0…1) eine zunehmende Anzahl kleiner animierter Splat-Partikel rendert. Die Quelle ist ein berechneter Fortschrittswert, der SfM-Phasen auf 0–0.2 abbildet und Training auf 0.2–1.0 (Frame-Quality auf 0–0.05). Damit „bauen" sich die Splats sichtbar auf, während das Training läuft. Ausschließlich dekorativ — die Anzeige zeigt keine echten Zwischenergebnisse des aktuellen Trainings (das wäre Live-Preview im Expert-Modus). Bei Cancel oder Failure wird sie ausgeblendet und nur der Status-Kreis bleibt sichtbar.

WO

Mittig auf dem Verarbeitungsbildschirm, 220 × 220 Pixel.

TECHNISCH

Zwei übereinander gerenderte Ringe: außen ein gedämpfter Track-Ring, innen ein gefüllter Fortschritts-Ring mit Akzent- oder Rot-Stroke (rot bei Fehler). Innerhalb des Kreises ein Stage-Icon (Gehirn für Training, Kamera für SfM, Film für Video-Frame-Extraktion, Sparkles für Frame-Quality), Stage-Titel und die live animierte Prozent-Zahl in 32-Punkt-Rounded-Font. Das Icon pulsiert sanft, solange die Verarbeitung aktiv ist. Die Anzeige interpoliert auf einem 30-Hz-Timer sanft in Richtung des aktuellen echten Fortschritts — mit Constant-Creep (0.0003/Frame) plus Proportional-Anteil (4 % des Gaps) und einem Soft-Ceiling, das auf 80 % des nächsten erwarteten Milestone setzt (für SfM aus einer hartkodierten Milestone-Tabelle). So wirkt der Fortschritt flüssig, selbst wenn die echten SfM-Updates nur alle paar Sekunden eintreffen.

WO

Oben links auf dem Verarbeitungsbildschirm, 32 × 32 Pixel.

TECHNISCH

Schlichter Button mit Material-Hintergrund. Schaltet das Info-Panel ein oder aus. Icon wechselt zwischen Info-Kreis-Outline und Info-Kreis-Gefüllt, wenn aktiv. Sanfte Einblend-Animation. Im Tooltip „Show detailed processing metrics".

WO

Unten links auf dem Verarbeitungsbildschirm, sichtbar nur wenn showProcessingInfo == true.

TECHNISCH

Zwei-spaltiges Panel mit Ultra-Thin-Material-Background. Linke Spalte: stage-spezifische Info-Zeilen — für SfM Status-Text und Prozent; für Training Iteration, kombinierter Loss, L1-Loss, D-SSIM-Loss, Gaussian-Count (orange gefärbt), Speed (it/s), Elapsed-Time, berechnete ETA, SH-Degree und Learning-Rate. Rechte Spalte: Status-Text, Time-Info-String, inline Loss-Chart (siehe C-28) und ein Discoverability-Nudge (siehe C-32). Alle Werte werden aus dem Trainings-Status gelesen, der bei jedem Trainings-Tick aktualisiert wird.

WO

Untere Navigationsleiste, sichtbar nur während der Trainings-Stage (NICHT während SfM) und solange die Verarbeitung läuft.

TECHNISCH

Bordered Button. Ruft je nach Status Pause oder Resume auf. Label wechselt zwischen „Pause" (mit Pause-Icon) und „Resume" (Play-Icon). Während des SfM-Schritts wird der Button nicht gezeigt, weil Apple Photogrammetry keine Pause-Semantik kennt. Der Pause-Zustand erhält Iteration, Gaussian-Status und Optimizer-Momentum komplett — Resume macht da weiter, wo zuvor angehalten wurde.

WO

Untere Navigationsleiste, sichtbar während die Verarbeitung läuft (SfM oder Training).

TECHNISCH

Roter Bordered-Button. Öffnet einen Bestätigungs-Dialog mit Titel „Stop and discard progress?", Buttons „Discard Progress" (zerstörend) und „Keep Running" (Cancel). Auf Bestätigung wird das Cancel-Flag gesetzt, der Trainings-Task beendet, der SfM-Subprozess wenn nötig beendet und eine Summary-Zeile mit Abbruch-Status in das JSONL-Log geschrieben. Im Gegensatz zu Pause werden Trainings-Buffer und Status verworfen.

WO

Untere Navigationsleiste, sichtbar wenn die Pipeline fehlgeschlagen ist (SfM-Status startet mit „SfM failed" oder Training ist im Fehler-Zustand).

TECHNISCH

Akzent-Button. Startet die gesamte Pipeline neu. Vor dem Start wird geprüft, ob noch importierte Bilder/Videos vorhanden sind. Vorherige Fehler-Logs bleiben im JSONL-Verzeichnis erhalten; ein neuer Run schreibt eine neue Logdatei mit aktuellem Timestamp.

WO

Im Info-Panel, rechte Spalte, sichtbar nur während Training mit nicht-leerer Verlaufs-Historie.

TECHNISCH

Kompakter Zeichen-Bereich (40 Pixel hoch), zeichnet die Loss-History als 1-Pixel-Linie in Akzent-Farbe. Daten werden auf finite Werte gefiltert (NaN-Schutz für unstabile Trainings). Min/Max werden über die gesamte History berechnet — der Chart auto-zoomt also auf den Wertebereich. Der letzte Loss-Wert steht rechts oben über dem Chart. Die History selbst wird im App-Zustand bei jedem Trainings-Tick aufgebaut (typisch alle 100 Iterationen).

WO

Im Info-Panel, rechte Spalte unten, sichtbar nur während Training UND im Einsteiger-Modus.

TECHNISCH

Kleine Zeile mit Augen-Icon und Caption-Text „Switch to Expert Mode (⌘2) for live splat preview", in zurückhaltender Tönung und 10-Punkt-Schrift. Kein interaktives Element, nur Hinweis. Reagiert nicht auf Klick — der User muss tatsächlich Cmd+2 drücken oder das Menü Mode → Expert Mode anklicken.

WO

Fullscreen-Hintergrund des Vorschau-Schritts.

TECHNISCH

Metal-basierter 3D-Viewport, der die fertige Punktwolke rendert. Der Renderer ist der vendored MetalSplatter-Fork mit RadianceKit-Fixes für Popping/Flickering. Tile-basierte Rendering-Pipeline mit Order-Independent Transparency. Wenn der Renderer nicht initialisiert werden kann (z. B. weil Metal auf dem System nicht verfügbar ist), erscheint stattdessen ein schwarzer Hintergrund mit „Metal not available"-Text. Die Ansicht ignoriert die Safe-Area, sodass das Modell bis an die Fensterkante reicht.

WO

Über dem Viewport, schwebend.

TECHNISCH

Kompaktes UI-Overlay mit Buttons für Auto-Rotation (Turntable), Reset-Camera, Hintergrund-Auswahl (Gray/Black/White), Save-Screenshot, Toggle-Info-Panel. Bindet an die Kamera-Parameter (Distanz, Azimut, Elevation, Target, FOV) und steuert das Auto-Turntable. Während des Trainings (wenn der User im Expert-Modus den Viewport mit-laufen sehen will) zeigt das Overlay zusätzlich eine kompakte Trainings-Status-Zeile.

WO

Untere Navigationsleiste in Z3.

TECHNISCH

Akzent-Button mit Label „Export" und Share-Icon. Klick triggert den Wechsel zu Z4. Vorher prüft die übergeordnete Ansicht, ob die Vollversion freigeschaltet ist — wenn nicht, wird statt der Export-Bühne die Sperr-Ansicht gezeigt (siehe U-06).

WO

Linke Hauptseite des Export-Schritts.

TECHNISCH

Karten-Raster mit zwei flexiblen Spalten und 12 Punkt Abstand. Iteriert über die im Einsteiger-Modus angebotenen Formate — eine gefilterte Teilmenge der vollen Formatliste, die nur die 6 wichtigsten Formate enthält: PLY, SPZ, glTF, .splat, Orbit-Video, Web-Viewer. Compressed-PLY und SOG werden NUR im Expert-Modus angeboten.

WO

Jede Karte im Grid.

TECHNISCH

Schlichter Button mit Karten-Layout: Icon (z. B. Dokument-Zipper für PLY, Archivbox für SPZ, Video-Icon für Orbit-Video) oben, Format-Name als Headline, Beschreibungs-Caption (2-zeilig gekürzt), darunter die geschätzte Dateigröße (live aus Format, Gaussian-Count und SH-Degree berechnet und als KB/MB formatiert). Bei Klick wird das Format ausgewählt. Selektierte Karte bekommt Akzent-Hintergrund, Akzent-Border und ein Häkchen-Icon rechts oben. Tooltip ist die Format-Beschreibung.

WO

Unter dem Format-Grid, sichtbar nur wenn ein Video-Format gewählt ist (Orbit-Video oder Social-Video).

TECHNISCH

Schieberegler 3–30 Sekunden in 1-Sekunden-Schritten, bindet an die Video-Länge im App-Zustand. Maximal-Breite 300 Pixel. Wird nur eingeblendet, wenn ein Video-Format ausgewählt ist. Bei nicht-Video-Formaten wird der Schieberegler komplett aus der Ansicht entfernt — kein toter Platz.

WO

Unter dem Format-Grid (und unter dem Duration-Slider, falls Video gewählt).

TECHNISCH

Großer Akzent-Button. Label: „Export {Format-Name}", Share-Icon. Bei Klick wird der macOS-Speichern-Dialog mit Format-passender Endung und Default-Filename „scene.{ext}" geöffnet; bei Bestätigung wird der Export an die gewählte URL geschrieben. Deaktiviert, wenn kein Trainings-Ergebnis vorhanden ist oder ein Export bereits läuft.

WO

Unter dem Export-Button, sichtbar nur während ein Export läuft.

TECHNISCH

Fortschrittsanzeige mit Max-Breite 300 Pixel, darunter Caption „Exporting… N %". Der Wert läuft von 0 bis 1 und wird während des Schreibens aktualisiert — bei PLY in Chunks von 10 000 Gaussians, bei SPZ einmalig nach Quantisierung, bei Orbit-Video in Frame-Intervallen.

WO

Unter der Progress-Bar, sichtbar nur wenn beim letzten Export ein Fehler aufgetreten ist.

TECHNISCH

Rote Zeile mit Warning-Icon und Fehlertext. Rote 8 %-Hintergrund-Opacity, abgerundete Ecken. Max-Breite 400 Pixel. Häufige Fehlerursachen: SOG erwartet cwebp im System-PATH (nicht App-Store-konform); Schreibfehler bei vollem Plattenspeicher; Sandbox-Fehler bei Speicherzielen außerhalb des erlaubten Bereichs.

WO

Rechte Seite des Export-Schritts.

TECHNISCH

Liste über die Export-Historie (persistent als JSON in den UserDefaults gespeichert, nach jedem erfolgreichen Export gepflegt). Jede Zeile zeigt Format-Badge (klein, akzentfarbig), Timestamp (HH:mm), Dateiname (1 Zeile gekürzt) und formatierte Dateigröße. Klick auf eine Zeile öffnet Finder mit selektierter Datei. Empty-State: „No exports yet".

WO

Rechtsklick auf eine History-Zeile.

TECHNISCH

Kontextmenü auf jedem Listen-Eintrag mit zwei Aktionen: „Reveal in Finder" (öffnet Finder mit selektierter Datei, wie der Einfach-Klick) und „Copy Path" (legt den vollen Dateipfad als Text in die Zwischenablage). Letzteres ist nützlich für Drag-and-Drop in andere Apps oder zur Übergabe an die Kommandozeile.