Kapittel 10 — Begynnermodus

HVOR

Øverst over arbeidsflyten, alltid synlig.

TEKNISK

Viser en horisontal fremgangsbjelke over hele pipelinen (frame-quality → SfM → trening) med stage-allokering: frame-quality opptar 0–5 % (fase 3.11, veldig kort), SfM opptar 0–30 % av bjelken, trening 30–100 %. Ved siden status-tekst og fase-navngitt prosent-visning („SfM 41 %", „Training 12 500/20 000"), slik at brukere ikke leser det tilsynelatende tilbakeskrittet „41 % SfM → 25 % trening" som feil — bjelken viser hele pipeline-fremgangen, ikke sub-stage. ETA-beregning starter så snart det er målt nok treningstempo (typisk etter de første 100 iterasjonene). Samme visning brukes også i Expert Mode over Inspector.

HVOR

Venstre side av import-trinnet, stort stiplet rektangel med symbol. Vises i begynnermodus med labelet „Drop photos or a video here".

TEKNISK

Drop-område som lar symbolet kort hoppe og farger bakgrunnen så snart drag-items svever over feltet. Aksepterer JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, .radiancescene-bundles og mapper. Drop-routing etter type: bilder samles og overgis sortert, videoer utløser frame-sampling-stien, splat-filer åpner direkte forhåndsvisningen, scene-bundles lastes inn. Mapper enumereres, og alle inneholdte bilder importeres. Security-scoped bookmarks for sandbox-konform tilgang opptas og frigis korrekt. Ustøttede endelser vises som advarselsbanner i 5 sekunder.

HVOR

Inne i drop-zonen, prominent knapp.

TEKNISK

Knapp som åpner macOS-fildialogen med multivalg og filtypene JPG, PNG, TIFF, MP4, MOV, mapper samt appens eget scene-format. Resultat-URL-er er security-scoped og videreføres gjennom samme import-stier som dra-og-slipp. Hvis brukeren velger en mappe, enumereres den rekursivt for bilder.

HVOR

Inne i drop-zonen, bare synlig hvis app-bundlen inneholder sample-scenen, og det ennå ikke er importert bilder/splats.

TEKNISK

Dukker bare opp hvis (a) en sample-scene.splat, .spz eller .ply finnes i app-bundlen OG (b) ennå ingen bilder/videoer er importert, og ennå ingen punktsky finnes. Ved klikk lastes den ferdige punktskyen (foretrukket det minste formatet — .splat ~3 MB, .spz ~1.4 MB, fallback .ply) og setter etter 400 ms hardkodede kamera-verdier fra de originale metadata av blomster-scenen til et estetisk meningsfullt inngangsperspektiv.

HVOR

Inne i drop-zonen, ved siden av „Try Sample Scene"; samme synlighetsbetingelser.

TEKNISK

Utløser en nedlasting (repo github.com/bkindler/radiancekit-sample-photos) som laster inn ca. 427 MB med 960 fullopløsnings-frames og mater appen. Under nedlastingen er knappen deaktivert. Fremgangen vises i den øvre progress-baren som „Downloading X %" i en egen stage, fordi denne stagen beholder sin egen 0–100 %-skala og ikke overlapper det senere SfM-stage.

HVOR

Svevende nedre verktøylinje av import-overlayet, til venstre for start-knappen.

TEKNISK

Betjeningselement med label „Quality" grupperer de tilgjengelige presetene etter kategori (Classic / MCMC / Custom). Innebygde presets grupperes etter kategori; seksjonshodene er hardkodede. Custom-presets bare synlige hvis noen finnes. Locked-state: presets som ikke er i free-listen (Quick + Preview), får et „🔒"-suffiks på navnet hvis brukeren ikke har kjøpt; ved valg springer velgeren tilbake på Preview og åpner automatisk purchase-sheetet. Ved valg anvendes presetet, noe som erstatter hele treningskonfigurasjonen.

HVOR

Svevende nedre verktøylinje av import-overlayet, til høyre for preset-velgeren.

TEKNISK

Knapp som forblir grå så lenge hverken bilder eller en video er importert. Ved klikk startes pipelinen, og stage-maskinen bytter til rekkefølgen frame-quality → SfM → trening. Knappen selv har ingen ytterligere status; en kjørende behandling dukker opp i stedet som separat behandlingsskjerm.

HVOR

Høyre bildeliste, bare synlig hvis en video (i stedet for bilder) er importert.

TEKNISK

Glidebryter 0.5 fps – 30 fps i 0.5-skritt. Ved endring oppdateres frame-tettheten, og dessuten beregnes antallet målframes (minst 10) ut fra tetthet og videolengde. Glidebryteren ligger utenfor bildelisten fordi liste-elementer ville blokkere muse-events fra glidebrytere. Under glidebryteren står de beregnede målframene („247 frames") og videolengden („1m23s video"). Tooltip advarer: „Doubling the density doubles the number of frames and increases SfM time by ~100 %."

HVOR

Høyre bildeliste, nederst til høyre; bare synlig hvis bilder er importert.

TEKNISK

Rød knapp. Klikk åpner en bekreftelsesdialog med tittel „Clear all imported files?" og melding „N images will be removed.". Bekreftelse tømmer alle importerte bilder/videoer, staging-mapper, punktskyen, treningsstatus, SfM-resultatet og alle caches; stagen hopper tilbake til import. Ved Cancel bevares alt. Dialogen er konfigurert som ikke-destruktiv default-sti (destruktiv knapp markert rød).

HVOR

Høyre bildeliste, hver oppføring.

TEKNISK

Liste over de importerte bildene med swipe-to-delete. Per bilde en linje med ikon, filnavn, oppløsning („1920 × 1080") og filstørrelse (formatert KB/MB). Oppløsningen kommer fra en metadata-cache som asynkront fylles fra bilde-headerne, slik at brukergrensesnittet ikke blokkeres. Slett- handlingen tilbyr macOS-typisk swipe-delete (trackpad-swipe til venstre på en linje) samt tastatur-delete ved markert linje. Merk: den utvidede image-delete-stien med eksplisitt minus-knapp, backspace og Cmd-Z for å angre ble bare i Expert Mode lagt til i Project Navigator — i begynnermodus blir det ved swipe-delete.

HVOR

Under bildelisten, over Clear-All-knappen.

TEKNISK

Tre etter hverandre følgende terskler basert på antallet importerte bilder (bare aktiv hvis bilder finnes, 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 scene tends to overfit […]. 15–20 images minimum recommended; 30+ for object captures." - 10–19 bilder: oransjefarget banner (warning triangle), tekst „Workable, but quality usually improves with 20+ images and good coverage around the scene."

Fra 20 bilder forsvinner banneret. Terskelverdier er hardkodede og basert på empiriske 560+-treningseksperimenter.

HVOR

Ved drop av en mappe — ingen synlig knapp, men deteksjonslogikk.

TEKNISK

Ved drop av en mappe sjekkes det om den inneholder et av de tre kanoniske workspace-layoutene: sparse/0/cameras.bin, sparse/cameras.bin eller direkte cameras.bin i roten. Hvis det er tilfellet, avbrytes standard-bilde-enumerasjonen, og i stedet åpnes en modal alert som spør brukeren om den eksisterende rekonstruksjonen skal brukes, eller bildene skal sendes gjennom Apple Photogrammetry på nytt. Samme sti også for tekst-format-workspaces (cameras.txt) og ETH3D-eksporter. Se kapittel 9 backend Q6 for detaljer. Virker i begynnermodus akkurat som i Expert Mode.

HVOR

Fullskjerms bakgrunn bak progress-sirkelen, fader ut ved avbrytelse eller feil.

TEKNISK

Dekorativ animasjon som avhengig av pipeline- fremgangen (0…1) rendrer et stigende antall små animerte splat-partikler. Kilden er en beregnet fremgangsverdi som mapper SfM-faser til 0–0.2 og trening til 0.2–1.0 (frame-quality til 0–0.05). Slik „bygger" splats seg synlig opp mens treningen kjører. Utelukkende dekorativt — visningen viser ingen ekte mellomresultater av den aktuelle treningen (det ville være live-preview i Expert Mode). Ved avbrytelse eller feil fader den ut, og bare statussirkelen forblir synlig.

HVOR

I midten av behandlingsskjermen, 220 × 220 piksel.

TEKNISK

To over hverandre rendrede ringer: utvendig en dempet track-ring, innvendig en utfylt fremgangsring med accent- eller rød-stroke (rød ved feil). Inne i sirkelen et stage-ikon (hjerne for trening, kamera for SfM, film for video-frame-ekstraksjon, sparkles for frame-quality), stage-tittel og det live-animerte prosent-tallet i 32-punkts-rounded-font. Ikonet pulserer mykt så lenge behandlingen er aktiv. Visningen interpolerer på en 30-Hz-timer mykt mot den aktuelle ekte fremgangen — med konstant kryp (0.0003/frame) pluss proporsjonal andel (4 % av gapet) og et soft-ceiling som settes til 80 % av neste forventede milestone (for SfM fra en hardkodet milestone- tabell). Slik virker fremgangen flytende selv om de ekte SfM-updates bare ankommer hvert par sekunder.

HVOR

Øverst til venstre på behandlingsskjermen, 32 × 32 piksel.

TEKNISK

Enkel knapp med material-bakgrunn. Slår info-panelet på eller av. Ikonet skifter mellom info-sirkel- outline og info-sirkel-fylt når aktiv. Myk fade-in-animasjon. Tooltip „Show detailed processing metrics".

HVOR

Nederst til venstre på behandlingsskjermen, bare synlig hvis showProcessingInfo == true.

TEKNISK

Tospaltet panel med ultra-thin-material-bakgrunn. Venstre kolonne: stage-spesifikke info-linjer — for SfM statustekst og prosent; for trening iterasjon, kombinert loss, L1-loss, D-SSIM-loss, gaussian-count (oransje farget), speed (it/s), elapsed-time, beregnet ETA, SH-degree og learning-rate. Høyre kolonne: statustekst, time-info-string, inline loss- chart (se C-28) og et discoverability-nudge (se C-32). Alle verdier leses fra treningsstatus som oppdateres ved hver treningstick.

HVOR

Nedre navigasjonslinje, bare synlig under treningsstagen (IKKE under SfM), og så lenge behandlingen kjører.

TEKNISK

Bordered knapp. Kaller avhengig av status pause eller resume. Label skifter mellom „Pause" (med pause-ikon) og „Resume" (play-ikon). Under SfM-trinnet vises knappen ikke fordi Apple Photogrammetry ikke kjenner pause-semantikk. Pause-tilstanden bevarer iterasjon, gaussian-status og optimizer-momentum fullstendig — resume fortsetter der det ble paused.

HVOR

Nedre navigasjonslinje, synlig mens behandlingen kjører (SfM eller trening).

TEKNISK

Rød bordered-knapp. Åpner en bekreftelsesdialog med tittel „Stop and discard progress?", knapper „Discard Progress" (destruktiv) og „Keep Running" (Cancel). Ved bekreftelse settes cancel-flagget, treningstasken avsluttes, SfM-underprosessen om nødvendig avsluttes, og en summary-linje med avbryt-status skrives i JSONL-loggen. I motsetning til pause kastes treningsbuffer og status.

HVOR

Nedre navigasjonslinje, synlig hvis pipelinen har feilet (SfM-status starter med „SfM failed", eller treningen er i feiltilstand).

TEKNISK

Accent-knapp. Starter hele pipelinen på nytt. Før start sjekkes om det fortsatt finnes importerte bilder/videoer. Tidligere feil-logger bevares i JSONL-mappen; en ny run skriver en ny log-fil med aktuell timestamp.

HVOR

I info-panelet, høyre kolonne, bare synlig under trening med ikke-tom forløpshistorikk.

TEKNISK

Kompakt tegne-område (40 piksel høyt), tegner loss-history som 1-piksel-linje i accent-farge. Data filtreres til finite-verdier (NaN-beskyttelse for ustabile treninger). Min/max beregnes over hele historikken — charten auto-zoomer altså på verdiområdet. Den siste loss-verdien står øverst til høyre over charten. Selve historikken bygges opp i app-tilstanden ved hvert treningstick (typisk hver 100 iterasjoner).

HVOR

I info-panelet, høyre kolonne nederst, bare synlig under trening OG i begynnermodus.

TEKNISK

Liten linje med øyne-ikon og caption-tekst „Switch to Expert Mode (⌘2) for live splat preview", i tilbakeholden tone og 10-punkts-skrift. Intet interaktivt element, bare hint. Reagerer ikke på klikk — brukeren må faktisk trykke Cmd+2 eller klikke menyen Mode → Expert Mode.

HVOR

Fullskjermsbakgrunn av forhåndsvisnings-trinnet.

TEKNISK

Metal-basert 3D-viewport som rendrer den ferdige punktskyen. Rendereren er den vendored MetalSplatter-fork med RadianceKit-fixes for popping/flickering. Tile-basert rendering-pipeline med order-independent transparency. Hvis rendereren ikke kan initialiseres (f.eks. fordi Metal ikke er tilgjengelig på systemet), dukker det i stedet opp en sort bakgrunn med „Metal not available"-tekst. Visningen ignorerer safe-area slik at modellen rekker til vinduets kant.

HVOR

Over viewporten, svevende.

TEKNISK

Kompakt UI-overlay med knapper for auto-rotasjon (turntable), reset-camera, bakgrunnsvalg (Gray/Black/White), save-screenshot, toggle-info-panel. Binder til kamera- parametrene (distanse, azimut, elevasjon, target, FOV) og styrer auto-turntable. Under treningen (når brukeren i Expert Mode vil se viewporten kjøre med) viser overlayet dessuten en kompakt treningsstatuslinje.

HVOR

Nedre navigasjonslinje i Z3.

TEKNISK

Accent-knapp med label „Export" og share-ikon. Klikk utløser bytte til Z4. Først sjekker den overordnede visningen om fullversjonen er låst opp — hvis ikke, vises i stedet for eksport-stagen låsevisningen (se U-06).

HVOR

Venstre hovedside av eksport-trinnet.

TEKNISK

Kort-raster med to fleksible kolonner og 12 punkt avstand. Itererer over formatene som tilbys i begynnermodus — en filtrert delmengde av den fulle formatlisten som bare inneholder de 6 viktigste formatene: PLY, SPZ, glTF, .splat, orbit-video, web-viewer. Compressed-PLY og SOG tilbys KUN i Expert Mode.

HVOR

Hvert kort i griddet.

TEKNISK

Enkel knapp 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 avkortet), under den estimerte filstørrelsen (live beregnet ut fra format, gaussian-count og SH-degree og formatert som KB/MB). Ved klikk velges formatet. Det valgte kortet får accent-bakgrunn, accent-border og et hake-ikon øverst til høyre. Tooltip er format-beskrivelsen.

HVOR

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

TEKNISK

Glidebryter 3–30 sekunder i 1-sekunds-skritt, binder til videolengden i app-tilstanden. Maks-bredde 300 piksel. Vises bare hvis et video-format er valgt. Ved ikke- video-formater fjernes glidebryteren helt fra visningen — ingen død plass.

HVOR

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

TEKNISK

Stor accent-knapp. Label: „Export {format-navn}", share-ikon. Ved klikk åpnes macOS-lagre-dialogen med format- passende endelse og default-filnavn „scene.{ext}"; ved bekreftelse skrives eksporten til den valgte URL-en. Deaktivert hvis intet treningsresultat finnes, eller en eksport allerede kjører.

HVOR

Under export-knappen, bare synlig mens en eksport kjører.

TEKNISK

Fremgangsvisning med maks-bredde 300 piksel, herunder caption „Exporting… N %". Verdien går fra 0 til 1 og oppdateres under skrivingen — ved PLY i chunks på 10 000 gaussians, ved SPZ engang etter kvantisering, ved orbit-video i frame-intervaller.

HVOR

Under progress-baren, bare synlig hvis det oppsto en feil ved siste eksport.

TEKNISK

Rød linje med warning-ikon og feiltekst. Rød 8 %-bakgrunns-opacity, avrundede hjørner. Maks-bredde 400 piksel. Hyppige feilårsaker: SOG forventer cwebp i system-PATH (ikke App Store-konform); skrivefeil ved full diskplass; sandbox- feil ved lagringsmål utenfor det tillatte området.

HVOR

Høyre side av eksport-trinnet.

TEKNISK

Liste over eksport-historikken (lagret persistent som JSON i UserDefaults, pleid etter hver vellykket eksport). Hver linje viser format-badge (lite, accent-farget), timestamp (HH:mm), filnavn (1 linje avkortet) og formatert filstørrelse. Klikk på en linje åpner Finder med valgt fil. Empty-state: „No exports yet".

HVOR

Høyreklikk på en history-linje.

TEKNISK

Kontekstmeny på hver liste-oppføring med to handlinger: „Reveal in Finder" (åpner Finder med valgt fil som et vanlig klikk) og „Copy Path" (legger den fulle filstien som tekst i utklippstavlen). Sistnevnte er nyttig for dra-og-slipp i andre apper eller overlevering til kommandolinjen.