Kapitel 10 — Begyndertilstand

VAR

Øverst over arbejdsgangen, altid synlig.

TEKNISKT

Visar 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 % av bjælken, träning 30–100 %. Vid siden status-tekst og fase-navngivet procent-visning („SfM 41 %", „Training 12 500/20 000"), så brugere inte læser det tilsyneladende tilbageskridt „41 % SfM → 25 % träning" som fejl — bjælken visar hele pipeline-fremskridtet, inte sub-stage. ETA-beregning starter, så snart der er målt nok trænings-tempo (typiskt efter de første 100 iterationer). Samme visning bruges också i Expert Mode over Inspectoren.

VAR

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

TEKNISKT

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: bilder samles og overgives sorteret, videoer udløser frame-sampling-stien, splat-filer åbner direkte forhåndsvisningen, scen-bundles indlæses. Mapper enumereres, og alle indeholdte bilder importeres. Security-scoped bookmarks til sandbox-konform adgang optages og frigives korrekt. Inte-understøttede endelser visas som advarselsbanner i 5 sekunder.

VAR

Inden i drop-zonen, prominent knap.

TEKNISKT

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

VAR

Inden i drop-zonen, kun synlig om app-bundlen innehåller sample-scenen, og der endnu inte er importeret bilder/splats.

TEKNISKT

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

VAR

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

TEKNISKT

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 visas i den øvre progress-bar som „Downloading X %" i en egen stage, fordi denna stage beholder sin egen 0–100 %-skala og inte overlapper det senere SfM-stage.

VAR

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

TEKNISKT

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, om någon finns. Locked-state: presets, der inte er i free-listen (Quick + Preview), får et „🔒"-suffiks på navnet, om brugeren inte har købt; vid valg springer vælgeren tilbage på Preview og åbner automatisk purchase-sheetet. Vid valg anvendes presetet, vilket erstatter hele trænings-konfigurationen.

VAR

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

TEKNISKT

Knap, der förblir grå, så længe hverken bilder eller en video er importeret. Vid 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.

VAR

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

TEKNISKT

Skydeknap 0.5 fps – 30 fps i 0.5-skridt. Vid ændring opdateres frame-densiteten, og dessutom beregnes antallet av 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 %."

VAR

Højre billedliste, nederst til højre; kun synlig om bilder er importeret.

TEKNISKT

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 bilder/videoer, staging-mapper, punktskyen, trænings-status, SfM-resultatet og alle caches; stagen springer tilbage til import. Vid Cancel bevares alt. Dialogen er konfigureret som inte-destruktiv default-sti (destruktiv knap markeret rød).

VAR

Højre billedliste, hver post.

TEKNISKT

Liste over de importerede bilder med swipe-to-delete. Pr. bild en linje med ikon, filnavn, upplösning („1920 × 1080") og filstørrelse (formateret KB/MB). Opløsningen kommer fra en metadata-cache, der asynkront fyldes fra bild-headerne, så brugerfladen inte blokeres. Slet- handlingen tilbyder macOS-typiskt swipe-delete (trackpad-swipe til venstre på en linje) samt tastatur-delete vid markeret linje. Obs: 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 blir det vid swipe-delete.

VAR

Under billedlisten, over Clear-All-knappen.

TEKNISKT

Tre efter hinanden følgende tærskler baserat på antallet av importerede bilder (kun aktiv, om bilder finns, og ingen video): - < 3 bilder: rødt banner (red octagon), tekst „At least 3 images are required. Camera alignment cannot be computed from fewer images." - 3–9 bilder: rødt banner, tekst „With fewer than 10 images, SfM often fails and the trained scen tends to overfit […]. 15–20 images minimum recommended; 30+ for object captures." - 10–19 bilder: orangefarvet banner (warning triangle), tekst „Workable, but quality usually improves with 20+ images and good coverage around the scen."

Fra 20 bilder försvinner banneret. Tærskelværdier er hardkodede og baserat på empiriske 560+-trænings-experiment.

VAR

Vid drop av en mappe — ingen synlig knap, men detektions-logik.

TEKNISKT

Vid drop av en mappe tjekkes det, om den innehåller et av de tre kanoniske workspace-layouts: sparse/0/cameras.bin, sparse/cameras.bin eller direkte cameras.bin i roden. Om det er tilfældet, afbrydes standard-bild-enumerationen, og i stedet åbnes en modal alert, der spørger brugeren, om den eksisterende rekonstruktion ska bruges, eller bilderna ska sendes genom Apple Photogrammetry på ny. Samme sti också 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.

VAR

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

TEKNISKT

Dekorativ animation, der afhængigt av pipeline- fremskridtet (0…1) rendrer et stigende antal små animerede splat-partikler. Kilden är 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 visar ingen ægte mellemresultater av den aktuelle träning (det ville være live-preview i Expert Mode). Vid afbrydelse eller fejl fader den ud, og kun status-cirklen förblir synlig.

VAR

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

TEKNISKT

To over hinanden rendrede ringe: udvendigt en dæmpet track-ring, indvendigt en udfyldt fremskridtsring med accent- eller rød-stroke (rød vid 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 % av gappet) og et soft-ceiling, der sættes til 80 % av nästa forventede milestone (for SfM fra en hardkodet milestone- tabel). Sådan virker fremskridtet flydende, selv om de ægte SfM-updates kun ankommer hvert par sekunder.

VAR

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

TEKNISKT

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

VAR

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

TEKNISKT

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ärden læses fra trænings-status, der opdateres vid hver trænings-tick.

VAR

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

TEKNISKT

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

VAR

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

TEKNISKT

Rød bordered-knap. Åbner en bekræftelsesdialog med titel „Stop and discard progress?", knapper „Discard Progress" (destruktiv) og „Keep Running" (Cancel). Vid 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.

VAR

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

TEKNISKT

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

VAR

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

TEKNISKT

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

VAR

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

TEKNISKT

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 inte på klik — brugeren ska faktisk trykke Cmd+2 eller klikke menuen Mode → Expert Mode.

VAR

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

TEKNISKT

Metal-baserat 3D-viewport, der rendrer den færdige punktmoln. Rendereren är den vendored MetalSplatter-fork med RadianceKit-fixes til popping/flickering. Tile-baserat rendering-pipeline med order-independent transparency. Om rendereren inte kan initialiseres (f.eks. fordi Metal inte 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.

VAR

Over viewporten, svævende.

TEKNISKT

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) visar overlayet dessutom en kompakt trænings-status-linje.

VAR

Nedre navigationslinje i Z3.

TEKNISKT

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 — om inte, visas i stedet for eksport-stagen låsevisningen (se U-06).

VAR

Venstre hovedside av eksport-trinet.

TEKNISKT

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

VAR

Hvert kort i griddet.

TEKNISKT

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). Vid 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.

VAR

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

TEKNISKT

Skydeknap 3–30 sekunder i 1-sekund-skridt, binder til video-længden i app-tilstanden. Maks-bredde 300 pixel. Visas kun, om et video-format er valgt. Vid inte- video-formater fjernes skydeknappen helt fra visningen — ingen død plats.

VAR

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

TEKNISKT

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

VAR

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

TEKNISKT

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

VAR

Under progress-baren, kun synlig om der opstod en fejl vid sista eksport.

TEKNISKT

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 (inte App Store-konform); skrivefejl vid fuldt diskplads; sandbox- fejl vid lagringsmål uden for det tilladte område.

VAR

Højre side av eksport-trinet.

TEKNISKT

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

VAR

Højreklik på en history-linje.

TEKNISKT

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