Kapittel 10 — Nybegynnermodus

HVOR

I linjen langs øverste vinduskant, til venstre for modus-bryteren. Kun synlig i enkel-modus.

TEKNISK

Viser de seks stadiene i rørledningen som en kjede av sammenkoblede knapper, hver med symbol og navn, adskilt av et pil-tegn: Import → Frame Quality → Cameras → Training → Preview → Export. Det gjeldende stadiet er fullt fargelagt, allerede gjennomførte stadier er halvtransparente, ennå ikke nådde stadier er grå. Allerede fullførte stadier kan klikkes og hopper tilbake; det gjeldende stadiet og alle ennå ikke nådde er deaktivert, det samme gjelder hele kjeden mens en behandling pågår. Det finnes ikke lenger en gjennomgående prosent-fremdriftslinje for hele rørledningen — fremdriften til det pågående stadiet vises av den store sirkelen på behandlingsskjermen (C-19).

HVOR

Venstre side av importtrinnet, stort stiplet rektangel med symbol. Vises i enkel-modus med etiketten «Drop photos or a video here».

TEKNISK

Slippområde som får symbolet til å hoppe kort og fargelegger bakgrunnen så snart drag-elementer svever over feltet. Godtar JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, .radiancescene-pakker og mapper. Slipp-ruting etter type: bilder samles og overføres sortert, videoer utløser frame-sampling-stien, splat-filer åpner forhåndsvisningen direkte, scene-pakker leses inn. Mapper enumereres og alle bilder de inneholder importeres. Security-scoped bokmerker for sandbox-konform tilgang tas riktig opp og frigis. Ikke-støttede filendelser vises som varselbanner i 5 sekunder.

HVOR

Inne i slippsonen, fremtredende knapp.

TEKNISK

Knapp som åpner macOS' fildialog med flervalg og filtypene JPG, PNG, TIFF, MP4, MOV, mapper samt appens eget scene-format. Resultat-URL-er er security-scoped og videresendes gjennom de samme importstiene som dra-og-slipp. Hvis brukeren velger en mappe, enumereres den rekursivt for bilder.

HVOR

Inne i slippsonen, kun synlig når app-pakken inneholder eksempel-scenen og ingen bilder/splats er importert ennå.

TEKNISK

Vises kun når (a) en sample-scene.splat, .spz eller .ply finnes i app-pakken OG (b) ingen bilder/videoer er importert og ingen punktsky finnes ennå. Ved klikk lastes den ferdige punktskyen (foretrekker det minste formatet — .splat ~3 MB, .spz ~1.4 MB, reserveløsning .ply) og setter etter 400 ms hardkodede kamera-verdier fra originalmetadataene til blomster-scenen for et estetisk fornuftig utgangsperspektiv.

HVOR

Inne i slippsonen, ved siden av «Try Sample Scene»; samme synlighetsbetingelser.

TEKNISK

Laster ned et eksempelsett levert av RadianceKit fra internett: ca. 427 MB med 960 fullopplivningsbilder («frames»), som deretter pakkes ut og overføres direkte til appen. Så lenge en annen behandling pågår, er knappen deaktivert og nedlastingen starter ikke. Nedlastingsfremdriften vises ikke i grensesnittet som en prosentandel; at nedlastingen er ferdig, merker du ved at bildelisten til høyre fylles med de 960 bildene.

HVOR

Flytende nedre verktøylinje i import-overlayen, til venstre for start-knappen.

TEKNISK

Meny-velger med etiketten «Quality», som grupperer de medfølgende forhåndsinnstillingene etter kategori i fire seksjoner: «Classic», «MCMC (fewer Gaussians, slower)», «Hybrid (sharp detail, compact)» og «Capture — curated real-world (Drone / 360° / Photo)». En femte seksjon «Custom» kommer til så snart fullversjonen er låst opp og minst én egen forhåndsinnstilling er lagret. Låst tilstand: Alle forhåndsinnstillinger unntatt Quick og Preview får en «🔒»-tilføyelse til navnet hvis brukeren ikke eier fullversjonen; ved valg hopper velgeren tilbake til Preview og åpner automatisk kjøpsvinduet. Ved valg anvendes forhåndsinnstillingen, som erstatter hele treningskonfigurasjonen.

HVOR

Flytende nedre verktøylinje i import-overlayen, til høyre for forhåndsinnstillings-velgeren.

TEKNISK

Knapp som forblir grå så lenge verken bilder eller en video er importert. Ved klikk starter rørledningen og skifter stadie-maskinen til rekkefølgen Frame-Quality → SfM → Training. Selve knappen har ingen ytterligere status; en pågående behandling vises i stedet som en separat behandlingsskjerm.

HVOR

Bildeliste til høyre, synlig kun når en video (i stedet for bilder) er importert.

TEKNISK

Skyveregulator 0.5 fps – 30 fps i trinn på 0.5. Ved endring oppdateres bildetettheten, og i tillegg beregnes antallet mål-bilder (minst 10) ut fra tetthet og videolengde. Skyve- regulatoren ligger utenfor bildelisten, fordi liste-elementer ville blokkere museklikk fra skyveregulatorer. Under skyveregulatoren vises de beregnede mål-bildene («247 frames») og videolengden («1m23s video»). Verktøytips advarer: «Doubling the density doubles the number of frames and increases SfM time by ~100%.»

HVOR

Bildeliste til høyre, nederst til høyre; synlig kun når bilder er importert.

TEKNISK

Rød knapp. Klikk åpner en bekreftelsesdialog med tittelen «Clear all imported files?» og meldingen «N images will be removed.». Bekreftelse tømmer alle importerte bilder/videoer, staging-mapper, punktskyen, treningsstatusen, SfM-resultatet og alle mellomlagre; stadiet hopper tilbake til Import. Ved Cancel forblir alt intakt. Dialogen er konfigurert som en ikke-destruktiv standard-sti (den destruktive knappen er merket rødt).

HVOR

Bildeliste til høyre, hver oppføring.

TEKNISK

Liste over de importerte bildene med sveip-for-å-slette. Per bilde en rad med ikon, filnavn, oppløsning («1920 × 1080») og filstørrelse (formatert KB/MB). Oppløsning kommer fra en metadata-mellomlager som fylles asynkront fra bilde-headerne, slik at grensesnittet ikke blokkeres. Fjerning skjer via det macOS-typiske sveip-slett (trackpad-sveip mot venstre på en rad); listen kjenner ikke til radvalg, det finnes derfor ingen tastatur-slett her. Merk: Den utvidede bilde-slett-stien med eksplisitt minus-knapp, Backspace og Cmd-Z for angring ble kun lagt til i ekspert-modus i Project Navigator — i enkel-modus forblir det sveip-slett.

HVOR

Under bildelisten, over Clear-All-knappen.

TEKNISK

Tre påfølgende terskler basert på antall importerte bilder (kun aktiv når bilder finnes og ingen video): - < 3 bilder: rødt banner (rød åttekant), 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: oransje banner (varseltriangel), tekst «Workable, but quality usually improves with 20+ images and good coverage around the scene.»

Fra 20 bilder og oppover forsvinner banneret. Terskelverdiene er hardkodet og basert på empiriske 560+-treningseksperimenter.

HVOR

Ved slipp av en mappe — ingen synlig knapp, men gjenkjennings-logikk.

TEKNISK

Ved slipp av en mappe sjekkes det om den inneholder en av de tre kanoniske workspace-oppsettene: sparse/0/cameras.bin, sparse/cameras.bin eller direkte cameras.bin i roten. Hvis det stemmer, avbrytes standard bilde-enumerering og i stedet åpnes en modal varsling som spør brukeren om den eksisterende rekonstruksjonen skal brukes, eller om bildene skal sendes på nytt gjennom Apple Photogrammetry. Samme sti gjelder også for tekst-format-workspacer (cameras.txt) og ETH3D-eksporter. Se kapittel 9 Backend Q6 for detaljer. Virker på samme måte i enkel-modus som i ekspert-modus.

HVOR

Fullskjerms bakgrunn bak fremdriftssirkelen, skjules ved avbrudd eller feil.

TEKNISK

Dekorativ animasjon som, avhengig av pipeline-fremdrift (0…1), rendrer et økende antall små animerte splat-partikler. Kilden er en beregnet fremdriftsverdi som mapper SfM-fasene til 0–0.2 og trening til 0.2–1.0 (frame-kvalitet til 0–0.05). Dermed «bygger» splattene seg synlig opp mens treningen kjører. Utelukkende dekorativ — visningen viser ingen ekte mellomresultater fra den aktuelle treningen (det ville vært Live-Preview i ekspertmodus). Ved Cancel eller Failure skjules den, og bare statussirkelen forblir synlig.

HVOR

Midt på prosesseringsskjermen, 220 × 220 piksler.

TEKNISK

To ringer rendret oppå hverandre: ytterst en dempet spor-ring, innerst en fylt fremdriftsring med aksent- eller rød strek (rød ved feil). Ringen følger den faktiske fremdriften til det pågående trinnet direkte (mykt via en kort inn-/utblendingsanimasjon), slik at visningen samsvarer med fremdriftslinjen i ekspertmodus. Inne i sirkelen finnes et trinn-symbol (hjerne for trening, kamera for SfM, film for videobilde-uttrekk, sparkles for bildekvalitetssjekk, globus ved avvikling av 360°-materiale), trinn-tittel og fremdriftstallet. Dette tallet er under treningen iterasjonstelleren («12 500/20 000»), i alle andre trinn en prosentandel. Symbolet pulserer mykt så lenge prosesseringen er aktiv. Ved feil bytter tittelen til det mislykkede trinnet («Structure from Motion Failed», «Training Failed»), ring og tall blir røde. Etter et avbrudd viser sirkelen i stedet et oransje kryss med «Cancelled!».

HVOR

Øverst til venstre på prosesseringsskjermen, 32 × 32 piksler.

TEKNISK

Enkel knapp med material-bakgrunn. Slår infopanelet av eller på. Ikonet bytter mellom info-sirkel-omriss og info-sirkel-fylt når aktiv. Myk innblendingsanimasjon. I verktøytips «Show detailed processing metrics».

HVOR

Nederst til venstre på prosesseringsskjermen, synlig kun når prosesseringsdetaljene er innblendet.

TEKNISK

Panel med to kolonner og ultra-thin-material-bakgrunn. Venstre kolonne: trinn-spesifikke infolinjer — for SfM statustekst og prosent; for trening iterasjon, kombinert loss, L1-loss, D-SSIM-loss, Gaussian-antall (farget oransje), hastighet (it/s), forløpt tid, beregnet ETA, SH-grad og læringsrate. Høyre kolonne: statustekst, tidsinfo-streng, innebygd loss-diagram (se C-28) og et discoverability-hint (se C-32). Alle verdier leses fra treningsstatusen, som oppdateres ved hvert treningstikk.

HVOR

Nedre navigasjonslinje, synlig kun under treningstrinnet (IKKE under SfM) og så lenge prosesseringen pågår.

TEKNISK

Bordered Button. Kaller opp Pause eller Resume avhengig av status. Etiketten bytter mellom «Pause» (med pause-ikon) og «Resume» (play-ikon). Under SfM-trinnet vises ikke knappen, fordi Apple Photogrammetry ikke har pause-semantikk. Pause-tilstanden bevarer iterasjon, Gaussian-status og optimizer-momentum fullstendig — Resume fortsetter der det tidligere ble stanset.

HVOR

Nedre navigasjonslinje, synlig mens prosesseringen pågår (SfM eller trening).

TEKNISK

Rød Bordered-knapp. Åpner en bekreftelsesdialog med tittelen «Stop and discard progress?», knappene «Discard Progress» (destruktiv) og «Keep Running» (Cancel). Ved bekreftelse settes cancel-flagget, treningsoppgaven avsluttes, SfM-underprosessen avsluttes om nødvendig, og en oppsummeringslinje med avbruddsstatus skrives til JSONL-loggen. I motsetning til Pause forkastes treningsbuffer og status.

HVOR

Nedre navigasjonslinje, synlig når pipelinen har feilet (SfM-status starter med «SfM failed» eller treningen er i feiltilstand).

TEKNISK

Aksent-knapp. Starter hele pipelinen på nytt. Før start sjekkes det om det fortsatt finnes importerte bilder/videoer. Tidligere feillogger blir liggende i JSONL-katalogen; en ny kjøring skriver en ny loggfil med gjeldende tidsstempel.

HVOR

I infopanelet, høyre kolonne, synlig kun under trening med ikke-tom forløpshistorikk.

TEKNISK

Kompakt tegneområde (40 piksler høyt), tegner loss-historikken som en 1-piksel-linje i aksentfarge. Data filtreres til endelige verdier (NaN-beskyttelse for ustabile treninger). Min/maks beregnes over hele historikken — diagrammet auto-zoomer altså på verdiområdet. Den siste loss-verdien vises øverst til høyre over diagrammet. Selve historikken bygges opp i appstatusen ved hvert treningstikk (typisk hver 100. iterasjon).

HVOR

I infopanelet, høyre kolonne nederst, synlig kun under trening OG i nybegynnermodus.

TEKNISK

Liten linje med øye-ikon og bildetekst «Switch to Expert Mode (⌘2) for live splat preview», i tilbakeholden tone og 10-punkts skrift. Ikke et interaktivt element, kun en henvisning. Reagerer ikke på klikk — brukeren må faktisk trykke Cmd+2 eller klikke menyen Mode → Expert Mode.

HVOR

Fullskjerms bakgrunn i forhåndsvisnings-steget.

TEKNISK

Metal-basert 3D-viewport som rendrer den ferdige punktskyen. Rendereren er RadianceKits EGEN ForwardPass-rasterizer — den samme som allerede rendrer splattene under treningen — altså ekte WYSIWYG (det som trenes, vises og eksporteres nøyaktig slik). Tile-basert render-pipeline med Order-Independent Transparency. Hvis rendereren ikke kan initialiseres (f.eks. fordi Metal ikke er tilgjengelig på systemet), vises i stedet en svart bakgrunn med teksten «Metal not available». Visningen ignorerer safe-area, slik at modellen strekker seg helt ut til vinduskanten.

HVOR

Over viewporten, flytende: to symbolknapper øverst til venstre, under dem nederst til venstre info-panelet.

TEKNISK

Overlayen består av nøyaktig to knapper: «Scene Info» slår info-panelet nederst til venstre av og på, den andre bytter kameramodus mellom «Orbit» (sirkling rundt et målpunkt) og «Fly-Through» (fri flyging). Info-panelet viser bildefrekvens, Gaussian-antall, kameramodus, synsvinkel, render-oppløsning og sampling; under en pågående trening kommer en trenings-statuslinje i tillegg, og etter at den er ferdig en avslutningslinje. Mislykkede eller pågående scene-innlastinger vises uavhengig av info-bryteren som en egen statuslinje. Auto-rotasjon, tilbakestill kamera, bakgrunnsfarge og skjermbilde er ikke overlay-knapper, men oppføringer i menyen «Viewport».

HVOR

Nedre navigasjonslinje i Z3.

TEKNISK

Aksent-knapp med etiketten «Export» og del-ikon. Klikk utløser overgang til Z4. Før det sjekker den overordnede visningen om fullversjonen er låst opp — hvis ikke, vises sperre-visningen i stedet for eksport-scenen (se U-06).

HVOR

Venstre hovedside i eksportsteget.

TEKNISK

Kort-rutenett med to fleksible kolonner og 12 punkts avstand. Itererer over formatene som tilbys i nybegynner-modus — en filtrert delmengde av den fulle formatlisten som kun inneholder de 6 viktigste formatene: PLY, SPZ, glTF, .splat, Orbit-video, Web-viewer. De øvrige formatene tilbys kun i ekspert-modus.

HVOR

Hvert kort i rutenettet.

TEKNISK

Enkel knapp med kort-layout: ikon (f.eks. dokument-glidelås for PLY, arkivboks for SPZ, video-ikon for Orbit-video) øverst, formatnavn som overskrift, beskrivelses-tekst (forkortet til 2 linjer), under det den estimerte filstørrelsen (beregnet live ut fra format, Gaussian-antall og SH-grad, formatert som KB/MB). Ved klikk velges formatet. Valgt kort får aksentfarget bakgrunn, aksentfarget kant og et hake-ikon øverst til høyre. Tooltip er formatbeskrivelsen.

HVOR

Under format-rutenettet, synlig kun når et video-format er valgt (Orbit-video eller Social-video).

TEKNISK

Glidebryter 3–30 sekunder i 1-sekunds-trinn, bindes til video-lengden i app-tilstanden. Maksimal bredde 300 piksler. Vises kun når et video-format er valgt. For ikke-video-formater fjernes glidebryteren helt fra visningen — ingen død plass.

HVOR

Under format-rutenettet (og under varighet-glidebryteren, hvis video er valgt).

TEKNISK

Stor aksent-knapp. Etikett: «Export {formatnavn}», del-symbol. Ved klikk åpnes macOS-lagringsdialogen med filendelsen som passer formatet. Det foreslåtte filnavnet kommer fra navnet på gjeldende scene; hvis ingen er satt (f.eks. fordi scenen aldri har blitt lagret), er det «scene». Ved bekreftelse skrives eksporten til det valgte stedet. Deaktivert hvis det ikke finnes noe treningsresultat eller en eksport allerede pågår. Under knappen står nøkkeltallet for resultatet («2.991 Gaussians • SH degree 3»).

HVOR

Under eksport-knappen, synlig kun mens en eksport pågår.

TEKNISK

Fremdriftsindikator med maks bredde 300 piksler, under den tekst «Exporting… N %». Verdien går fra 0 til 1 og oppdateres under skrivingen — for PLY i biter på 10 000 Gaussians, for SPZ én gang etter kvantisering, for Orbit-video i frame-intervaller.

HVOR

Under fremdriftslinjen, synlig kun hvis en feil oppsto ved den siste eksporten.

TEKNISK

Rød linje med varseltrekant og teksten «Export failed: …» sammen med feilbeskrivelse. Rød bakgrunn med 8 % dekkevne, avrundede hjørner. Maks bredde 400 piksler. Vanlige feilårsaker: skrivefeil ved full diskplass; sandbox-feil ved lagringsmål utenfor tillatt område.

HVOR

Høyre side av eksportsteget.

TEKNISK

Liste over eksport-historikken (lagres permanent i app-innstillingene, oppdateres etter hver vellykket eksport). Hver rad viser format-merke (liten, aksentfarget), tidsstempel (HH:mm), filnavn (forkortet til 1 linje) og formatert filstørrelse. Klikk på en rad åpner Finder med valgt fil. Tom-tilstand: «No exports yet».

HVOR

Høyreklikk på en historikk-rad.

TEKNISK

Kontekstmeny på hvert liste-element med to handlinger: «Reveal in Finder» (åpner Finder med valgt fil, som ved enkeltklikk) og «Copy Path» (legger den fulle filstien som tekst i utklippstavlen). Sistnevnte er nyttig for dra-og-slipp til andre apper eller for overføring til kommandolinjen.