Kapitel 10 — Begyndertilstand

HVOR

Øverst over arbejdsgangen, altid synlig.

TEKNISK

Viser en horisontal fremskridtsbjælke over hele pipelinen (frame-quality → SfM → træning) med stage-allokering: frame-quality optager 0–5 % (fase 3.11, meget kort), SfM optager 0–30 % af bjælken, træning 30–100 %. Ved siden status-tekst og fase-navngivet procent-visning („SfM 41 %", „Training 12 500/20 000"), så brugere ikke læser det tilsyneladende tilbageskridt „41 % SfM → 25 % træning" som fejl — bjælken viser hele pipeline-fremskridtet, ikke sub-stage. ETA-beregning starter, så snart der er målt nok trænings-tempo (typisk efter de første 100 iterationer). Samme visning bruges også i Expert Mode over Inspectoren.

HVOR

Venstre side af import-trinet, stort stiplet rektangel med symbol. Vises i begyndertilstand med labelet „Drop photos or a video here".

TEKNISK

Drop-område, der lader symbolet kort hoppe og farver baggrunden, så snart drag-items svæver over feltet. Accepterer JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, .radiancescene-bundles og mapper. Drop-routing efter type: billeder samles og overgives sorteret, videoer udløser frame-sampling-stien, splat-filer åbner direkte forhåndsvisningen, scene-bundles indlæses. Mapper enumereres, og alle indeholdte billeder importeres. Security-scoped bookmarks til sandbox-konform adgang optages og frigives korrekt. Ikke-understøttede endelser vises som advarselsbanner i 5 sekunder.

HVOR

Inden i drop-zonen, prominent knap.

TEKNISK

Knap, der åbner macOS-fildialogen med multivalg og filtyperne JPG, PNG, TIFF, MP4, MOV, mapper samt app'ens eget scene-format. Resultat-URL'er er security-scoped og videreføres gennem samme import-stier som træk-og-slip. Hvis brugeren vælger en mappe, enumeres den rekursivt for billeder.

HVOR

Inden i drop-zonen, kun synlig hvis app-bundlen indeholder sample-scenen, og der endnu ikke er importeret billeder/splats.

TEKNISK

Optræder kun, hvis (a) en sample-scene.splat, .spz eller .ply findes i app-bundlen OG (b) endnu ingen billeder/videoer er importeret, og endnu ingen punktsky findes. Ved klik indlæses den færdige punktsky (foretrukket det mindste format — .splat ~3 MB, .spz ~1.4 MB, fallback .ply) og sætter efter 400 ms hardkodede kamera-værdier fra den originale metadata af blomster-scenen til et æstetisk meningsfuldt indgangs-perspektiv.

HVOR

Inden i drop-zonen, ved siden af „Try Sample Scene"; samme synligheds-betingelser.

TEKNISK

Udløser et download (repo github.com/bkindler/radiancekit-sample-photos), der indlæser ca. 427 MB med 960 fuld-opløsnings-frames og fodrer appen. Under downloadet er knappen deaktiveret. Fremskridtet vises i den øvre progress-bar som „Downloading X %" i en egen stage, fordi denne stage beholder sin egen 0–100 %-skala og ikke overlapper det senere SfM-stage.

HVOR

Svævende nedre værktøjslinje af import-overlayet, til venstre for start-knappen.

TEKNISK

Betjeningselement med label „Quality" grupperer de tilgængelige presets efter kategori (Classic / MCMC / Custom). Indbyggede presets grupperes efter kategori; afsnits-headerne er hardkodede. Custom-presets kun synlige, hvis nogen findes. Locked-state: presets, der ikke er i free-listen (Quick + Preview), får et „🔒"-suffiks på navnet, hvis brugeren ikke har købt; ved valg springer vælgeren tilbage på Preview og åbner automatisk purchase-sheetet. Ved valg anvendes presetet, hvilket erstatter hele trænings-konfigurationen.

HVOR

Svævende nedre værktøjslinje af import-overlayet, til højre for preset-vælgeren.

TEKNISK

Knap, der forbliver grå, så længe hverken billeder eller en video er importeret. Ved klik startes pipelinen, og stage-maskinen skifter til rækkefølgen frame-quality → SfM → træning. Knappen selv har ingen yderligere status; en kørende behandling optræder i stedet som separat behandlingsskærm.

HVOR

Højre billedliste, kun synlig hvis en video (i stedet for billeder) er importeret.

TEKNISK

Skydeknap 0.5 fps – 30 fps i 0.5-skridt. Ved ændring opdateres frame-densiteten, og desuden beregnes antallet af mål-frames (mindst 10) ud fra densitet og videolængde. Skydeknappen ligger uden for billedlisten, fordi liste-elementer ville blokere muse-events fra skydeknapper. Under skydeknappen står de beregnede mål-frames („247 frames") og videolængden („1m23s video"). Tooltip advarer: „Doubling the density doubles the number of frames and increases SfM time by ~100 %."

HVOR

Højre billedliste, nederst til højre; kun synlig hvis billeder er importeret.

TEKNISK

Rød knap. Klik åbner en bekræftelsesdialog med titel „Clear all imported files?" og besked „N images will be removed.". Bekræftelse tømmer alle importerede billeder/videoer, staging-mapper, punktskyen, trænings-status, SfM-resultatet og alle caches; stagen springer tilbage til import. Ved Cancel bevares alt. Dialogen er konfigureret som ikke-destruktiv default-sti (destruktiv knap markeret rød).

HVOR

Højre billedliste, hver post.

TEKNISK

Liste over de importerede billeder med swipe-to-delete. Pr. billede en linje med ikon, filnavn, opløsning („1920 × 1080") og filstørrelse (formateret KB/MB). Opløsningen kommer fra en metadata-cache, der asynkront fyldes fra billed-headerne, så brugerfladen ikke blokeres. Slet- handlingen tilbyder macOS-typisk swipe-delete (trackpad-swipe til venstre på en linje) samt tastatur-delete ved markeret linje. Bemærk: den udvidede image-delete-sti med eksplicit minus-knap, backspace og Cmd-Z til at fortryde blev kun i Expert Mode tilføjet i Project Navigator — i begyndertilstand bliver det ved swipe-delete.

HVOR

Under billedlisten, over Clear-All-knappen.

TEKNISK

Tre efter hinanden følgende tærskler baseret på antallet af importerede billeder (kun aktiv, hvis billeder findes, og ingen video): - < 3 billeder: rødt banner (red octagon), tekst „At least 3 images are required. Camera alignment cannot be computed from fewer images." - 3–9 billeder: rødt banner, tekst „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 billeder: orangefarvet banner (warning triangle), tekst „Workable, but quality usually improves with 20+ images and good coverage around the scene."

Fra 20 billeder forsvinder banneret. Tærskelværdier er hardkodede og baseret på empiriske 560+-trænings-eksperimenter.

HVOR

Ved drop af en mappe — ingen synlig knap, men detektions-logik.

TEKNISK

Ved drop af en mappe tjekkes det, om den indeholder et af de tre kanoniske workspace-layouts: sparse/0/cameras.bin, sparse/cameras.bin eller direkte cameras.bin i roden. Hvis det er tilfældet, afbrydes standard-billed-enumerationen, og i stedet åbnes en modal alert, der spørger brugeren, om den eksisterende rekonstruktion skal bruges, eller billederne skal sendes igennem Apple Photogrammetry på ny. Samme sti også for tekst-format-workspaces (cameras.txt) og ETH3D-eksporter. Se kapitel 9 backend Q6 for detaljer. Virker i begyndertilstand præcis som i Expert Mode.

HVOR

Fuldskærms-baggrund bag progress-cirklen, fades ud ved afbrydelse eller fejl.

TEKNISK

Dekorativ animation, der afhængigt af pipeline- fremskridtet (0…1) rendrer et stigende antal små animerede splat-partikler. Kilden er en beregnet fremskridtsværdi, der mapper SfM-faser til 0–0.2 og træning til 0.2–1.0 (frame-quality til 0–0.05). Sådan „bygger" splats sig synligt op, mens træningen kører. Udelukkende dekorativt — visningen viser ingen ægte mellemresultater af den aktuelle træning (det ville være live-preview i Expert Mode). Ved afbrydelse eller fejl fader den ud, og kun status-cirklen forbliver synlig.

HVOR

I midten af behandlingsskærmen, 220 × 220 pixel.

TEKNISK

To over hinanden rendrede ringe: udvendigt en dæmpet track-ring, indvendigt en udfyldt fremskridtsring med accent- eller rød-stroke (rød ved fejl). Inden i cirklen et stage-ikon (hjerne for træning, kamera for SfM, film for video-frame-ekstraktion, sparkles for frame-quality), stage-titel og det live-animerede procent-tal i 32-punkts-rounded-font. Ikonet pulserer blødt, så længe behandlingen er aktiv. Visningen interpolerer på en 30-Hz-timer blødt mod det aktuelle ægte fremskridt — med konstant kryb (0.0003/frame) plus proportional andel (4 % af gappet) og et soft-ceiling, der sættes til 80 % af næste forventede milestone (for SfM fra en hardkodet milestone- tabel). Sådan virker fremskridtet flydende, selv hvis de ægte SfM-updates kun ankommer hvert par sekunder.

HVOR

Øverst til venstre på behandlingsskærmen, 32 × 32 pixel.

TEKNISK

Simpel knap med material-baggrund. Slår info-panelet til eller fra. Ikonet skifter mellem info-cirkel- outline og info-cirkel-fyldt, når aktiv. Blød fade-in-animation. Tooltip „Show detailed processing metrics".

HVOR

Nederst til venstre på behandlingsskærmen, kun synlig hvis showProcessingInfo == true.

TEKNISK

Tospaltet panel med ultra-thin-material-baggrund. Venstre kolonne: stage-specifikke info-linjer — for SfM status-tekst og procent; for træning iteration, kombineret loss, L1-loss, D-SSIM-loss, gaussian-count (orange farvet), speed (it/s), elapsed-time, beregnet ETA, SH-degree og learning-rate. Højre kolonne: status-tekst, time-info-string, inline loss- chart (se C-28) og et discoverability-nudge (se C-32). Alle værdier læses fra trænings-status, der opdateres ved hver trænings-tick.

HVOR

Nedre navigationslinje, kun synlig under trænings-stagen (IKKE under SfM), og så længe behandlingen kører.

TEKNISK

Bordered knap. Kalder afhængigt af status pause eller resume. Label skifter mellem „Pause" (med pause-ikon) og „Resume" (play-ikon). Under SfM-trinet vises knappen ikke, fordi Apple Photogrammetry ikke kender pause-semantik. Pause-tilstanden bevarer iteration, gaussian-status og optimizer-momentum fuldstændigt — resume fortsætter, hvor det blev pauset.

HVOR

Nedre navigationslinje, synlig mens behandlingen kører (SfM eller træning).

TEKNISK

Rød bordered-knap. Åbner en bekræftelsesdialog med titel „Stop and discard progress?", knapper „Discard Progress" (destruktiv) og „Keep Running" (Cancel). Ved bekræftelse sættes cancel-flaget, trænings-tasken afsluttes, SfM-underprocessen om nødvendigt afsluttes, og en summary-linje med afbryd-status skrives i JSONL-loggen. I modsætning til pause kasseres trænings-buffer og status.

HVOR

Nedre navigationslinje, synlig hvis pipelinen er fejlet (SfM-status starter med „SfM failed", eller træningen er i fejl-tilstand).

TEKNISK

Accent-knap. Starter hele pipelinen forfra. Før start tjekkes, om der stadig findes importerede billeder/videoer. Tidligere fejl-logs bevares i JSONL-mappen; en ny run skriver en ny log-fil med aktuel timestamp.

HVOR

I info-panelet, højre kolonne, kun synlig under træning med ikke-tom forløbs-historik.

TEKNISK

Kompakt tegne-område (40 pixel højt), tegner loss-history som 1-pixel-linje i accent-farve. Data filtreres til finite-værdier (NaN-beskyttelse for ustabile træninger). Min/max beregnes over hele historikken — charten auto-zoomer altså på værdiområdet. Den sidste loss-værdi står øverst til højre over charten. Selve historikken bygges op i app-tilstanden ved hvert trænings-tick (typisk hver 100 iterationer).

HVOR

I info-panelet, højre kolonne nederst, kun synlig under træning OG i begyndertilstand.

TEKNISK

Lille linje med øjne-ikon og caption-tekst „Switch to Expert Mode (⌘2) for live splat preview", i tilbageholdt tone og 10-punkts-skrift. Intet interaktivt element, kun hint. Reagerer ikke på klik — brugeren skal faktisk trykke Cmd+2 eller klikke menuen Mode → Expert Mode.

HVOR

Fuldskærms-baggrund af forhåndsvisnings-trinet.

TEKNISK

Metal-baseret 3D-viewport, der rendrer den færdige punktsky. Rendereren er den vendored MetalSplatter-fork med RadianceKit-fixes til popping/flickering. Tile-baseret rendering-pipeline med order-independent transparency. Hvis rendereren ikke kan initialiseres (f.eks. fordi Metal ikke er tilgængeligt på systemet), optræder i stedet en sort baggrund med „Metal not available"-tekst. Visningen ignorerer safe-area, så modellen rækker til vinduets kant.

HVOR

Over viewporten, svævende.

TEKNISK

Kompakt UI-overlay med knapper til auto-rotation (turntable), reset-camera, baggrunds-valg (Gray/Black/White), save-screenshot, toggle-info-panel. Binder til kamera- parametrene (distance, azimut, elevation, target, FOV) og styrer auto-turntable. Under træningen (når brugeren i Expert Mode vil se viewporten køre med) viser overlayet desuden en kompakt trænings-status-linje.

HVOR

Nedre navigationslinje i Z3.

TEKNISK

Accent-knap med label „Export" og share-ikon. Klik udløser skift til Z4. Først tjekker den overordnede visning, om fuldversionen er låst op — hvis ikke, vises i stedet for eksport-stagen låsevisningen (se U-06).

HVOR

Venstre hovedside af eksport-trinet.

TEKNISK

Kort-raster med to fleksible kolonner og 12 punkt afstand. Itererer over de formater, der tilbydes i begyndertilstand — en filtreret delmængde af den fulde formatliste, der kun indeholder de 6 vigtigste formater: PLY, SPZ, glTF, .splat, orbit-video, web-viewer. Compressed-PLY og SOG tilbydes KUN i Expert Mode.

HVOR

Hvert kort i griddet.

TEKNISK

Simpel knap med kort-layout: ikon (f.eks. dokument-zipper for PLY, arkivboks for SPZ, video-ikon for orbit-video) øverst, format-navn som headline, beskrivelses- caption (2-linjes afkortet), derunder den anslåede filstørrelse (live beregnet ud fra format, gaussian-count og SH-degree og formateret som KB/MB). Ved klik vælges formatet. Det valgte kort får accent-baggrund, accent-border og et flueben-ikon øverst til højre. Tooltip er format-beskrivelsen.

HVOR

Under format-griddet, kun synlig hvis et video- format er valgt (orbit-video eller social-video).

TEKNISK

Skydeknap 3–30 sekunder i 1-sekund-skridt, binder til video-længden i app-tilstanden. Maks-bredde 300 pixel. Vises kun, hvis et video-format er valgt. Ved ikke- video-formater fjernes skydeknappen helt fra visningen — ingen død plads.

HVOR

Under format-griddet (og under duration-slideren, hvis video valgt).

TEKNISK

Stor accent-knap. Label: „Export {format-navn}", share-ikon. Ved klik åbnes macOS-gem-dialogen med format- passende endelse og default-filnavn „scene.{ext}"; ved bekræftelse skrives eksporten til den valgte URL. Deaktiveret, hvis intet trænings-resultat findes, eller en eksport allerede kører.

HVOR

Under export-knappen, kun synlig mens en eksport kører.

TEKNISK

Fremskridtsvisning med maks-bredde 300 pixel, herunder caption „Exporting… N %". Værdien går fra 0 til 1 og opdateres under skrivningen — ved PLY i chunks på 10 000 gaussians, ved SPZ engang efter kvantisering, ved orbit-video i frame-intervaller.

HVOR

Under progress-baren, kun synlig hvis der opstod en fejl ved sidste eksport.

TEKNISK

Rød linje med warning-ikon og fejltekst. Rød 8 %-baggrunds-opacity, afrundede hjørner. Maks-bredde 400 pixel. Hyppige fejlårsager: SOG forventer cwebp i system-PATH (ikke App Store-konform); skrivefejl ved fuldt diskplads; sandbox- fejl ved lagringsmål uden for det tilladte område.

HVOR

Højre side af eksport-trinet.

TEKNISK

Liste over eksport-historikken (gemt persistent som JSON i UserDefaults, plejet efter hver vellykket eksport). Hver linje viser format-badge (lille, accent-farvet), timestamp (HH:mm), filnavn (1 linje afkortet) og formateret filstørrelse. Klik på en linje åbner Finder med valgt fil. Empty-state: „No exports yet".

HVOR

Højreklik på en history-linje.

TEKNISK

Kontekstmenu på hver liste-post med to handlinger: „Reveal in Finder" (åbner Finder med valgt fil, som et almindeligt klik) og „Copy Path" (lægger den fulde fil- sti som tekst i udklipsholderen). Sidstnævnte er nyttig til træk-og-slip i andre apps eller overdragelse til kommandolinjen.