Kapitel 10 — Begyndertilstand

HVOR

I linjen øverst i vinduet, til venstre for tilstands-skifteren. Kun synlig i begynder-tilstand.

TEKNISK

Viser de seks trin i pipelinen som en kæde af sammenkædede knapper, hver med ikon og navn, adskilt af et pile-tegn: Import → Frame Quality → Cameras → Training → Preview → Export. Det aktuelle trin er fuldt farvelagt, allerede gennemførte trin er halvgennemsigtige, endnu ikke nåede trin er grå. Allerede afsluttede trin kan klikkes og springer tilbage; det aktuelle trin og alle endnu ikke nåede er deaktiveret, ligesom hele kæden, så længe en behandling kører. En gennemgående procent-fremskridtslinje over hele pipelinen findes ikke længere — fremskridtet for det kørende trin viser den store cirkel på behandlingsskærmen (C-19).

HVOR

Venstre side af import-trinnet, stort stiplet rektangel med ikon. Vises i begynder-tilstand med labelen „Drop photos or a video here".

TEKNISK

Drop-område, der lader ikonet hoppe kort og farver baggrunden, så snart drag-items svæver over feltet. Accepterer JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, .radiancescene-bundler og mapper. Drop-routing efter type: Billeder samles og sorteres og overføres, videoer udløser frame-sampling-stien, splat-filer åbner preview direkte, scene-bundler indlæses. Mapper gennemgås, og alle indeholdte billeder importeres. Security-scoped bookmarks til sandbox-konform adgang optages og frigives korrekt. Filendelser, der ikke understøttes, vises som advarselsbanner i 5 sekunder.

HVOR

Inde i drop-zonen, fremtrædende knap.

TEKNISK

Knap, der åbner macOS-fildialogen med flervalg og filtyperne JPG, PNG, TIFF, MP4, MOV, mapper samt appens eget scene-format. Resultat-URL'er er security-scoped og videreledes gennem de samme import-stier som drag-and-drop. Hvis brugeren vælger en mappe, gennemgås den rekursivt efter billeder.

HVOR

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

TEKNISK

Vises kun, hvis (a) en sample-scene.splat, .spz eller .ply findes i app-bundlen OG (b) endnu ingen billeder/videoer er importeret, og der endnu ikke findes en punktsky. Ved klik indlæses den færdige punktsky (foretrukket det mindste format — .splat ~3 MB, .spz ~1.4 MB, fallback .ply) og efter 400 ms sættes hårdkodede kameraværdier fra de originale metadata i blomster-scenen for et æstetisk fornuftigt indgangsperspektiv.

HVOR

Inde i drop-zonen, ved siden af „Try Sample Scene"; samme synlighedsbetingelser.

TEKNISK

Downloader et eksempelsæt leveret af RadianceKit fra internettet: ca. 427 MB med 960 fuldopløsnings-frames, som efterfølgende udpakkes og overføres direkte til appen. Så længe en anden behandling kører, er knappen deaktiveret, og downloaden starter ikke. Fremskridtet i downloaden vises ikke i brugerfladen som en procentsats; at downloaden er færdig, kan du se på, at billedlisten til højre fyldes med de 960 frames.

HVOR

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

TEKNISK

Menu-picker med labelen „Quality", der grupperer de medfølgende presets efter kategori i fire afsnit: „Classic", „MCMC (fewer Gaussians, slower)", „Hybrid (sharp detail, compact)" og „Capture — curated real-world (Drone / 360° / Photo)". Et femte afsnit „Custom" tilføjes, så snart fuldversionen er frigivet, og mindst ét eget preset er gemt. Locked-tilstand: Alle presets undtagen Quick og Preview får et „🔒"-suffiks på navnet, hvis brugeren ikke ejer fuldversionen; ved valg springer pickeren tilbage til Preview og åbner automatisk købsvinduet. Ved valg anvendes presettet, hvilket erstatter hele trænings-konfigurationen.

HVOR

Svævende nedre værktøjslinje i 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 starter pipelinen og skifter stage-maskinen til rækkefølgen Frame-Quality → SfM → Training. Knappen selv har ingen yderligere status; en kørende behandling vises i stedet som en separat behandlingsskærm.

HVOR

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

TEKNISK

Skyder 0.5 fps – 30 fps i trin på 0.5. Ved ændring opdateres frame-tætheden, og desuden beregnes antallet af mål-frames (mindst 10) ud fra tæthed og videolængde. Skyderen ligger uden for billedlisten, fordi liste-elementer ville blokere mus-events fra skydere. Under skyderen 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; synlig kun hvis billeder er importeret.

TEKNISK

Rød knap. Klik åbner en bekræftelsesdialog med titlen „Clear all imported files?" og beskeden „N images will be removed.". Bekræftelse rydder alle importerede billeder/videoer, staging-mapper, punktskyen, trænings-status, SfM-resultatet og alle caches; stage springer tilbage til Import. Ved Cancel forbliver alt intakt. Dialogen er konfigureret som ikke-destruktiv standard-sti (destruktiv knap markeret rød).

HVOR

Højre billedliste, hver post.

TEKNISK

Liste over de importerede billeder med swipe-for-at-slette. Pr. billede en linje med ikon, filnavn, opløsning („1920 × 1080") og filstørrelse (formateret KB/MB). Opløsning kommer fra en metadata-cache, der udfyldes asynkront fra billed-headerne, så brugerfladen ikke blokerer. Fjernelse sker via macOS-typisk swipe-delete (trackpad-swipe mod venstre på en linje); listen kender ikke linjevalg, der findes altså ikke tastatur-delete her. Bemærk: Den udvidede image-delete-sti med eksplicit minus-knap, backspace og Cmd-Z til fortrydelse blev tilføjet kun i expert-tilstand i Project Navigator — i begynder-tilstand forbliver 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 der ikke er en video): - < 3 billeder: rødt banner (rødt ottekant-ikon), 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: orange banner (advarselstrekant), tekst „Workable, but quality usually improves with 20+ images and good coverage around the scene."

Fra 20 billeder forsvinder banneret. Tærskelværdierne er hårdkodede og baseret på empiriske eksperimenter med 560+ træninger.

HVOR

Ved drop af en mappe — ingen synlig knap, men detekteringslogik.

TEKNISK

Ved drop af en mappe tjekkes, om der findes et af de tre kanoniske workspace-layouts: sparse/0/cameras.bin, sparse/cameras.bin eller direkte cameras.bin i roden. Er det tilfældet, afbrydes den almindelige billed-gennemgang, og der åbnes i stedet en modal alert, der spørger brugeren, om den eksisterende rekonstruktion skal bruges, eller om billederne skal sendes igennem Apple Photogrammetry på ny. Samme sti gælder også for tekst-format-workspaces (cameras.txt) og ETH3D-eksporter. Se kapitel 9 Backend Q6 for detaljer. Virker i begynder-tilstand ligesom i expert-tilstand.

HVOR

Fuldskærms baggrund bag fremskridtscirklen, skjules ved afbrydelse eller fejl.

TEKNISK

Dekorativ animation, der alt efter pipelinens fremskridt (0…1) renderer et stigende antal små animerede splat-partikler. Kilden er en beregnet fremskridtsværdi, der afbilder SfM-faserne til 0–0,2 og træningen til 0,2–1,0 (frame-kvalitet til 0–0,05). Dermed „bygges" splats synligt op, mens træningen kører. Udelukkende dekorativ — visningen viser ikke rigtige mellemresultater af den aktuelle træning (det ville være live-preview i Expert-tilstand). Ved Cancel eller Failure skjules den, og kun statuscirklen forbliver synlig.

HVOR

Midt på behandlingsskærmen, 220 × 220 pixel.

TEKNISK

To ringe renderet oven på hinanden: udenfor en dæmpet track-ring, indeni en fyldt fremskridtsring med accent- eller rød stroke (rød ved fejl). Ringen følger direkte det faktiske fremskridt for det aktuelle trin (blødt via en kort ind-/udtonings-animation), så visningen stemmer overens med fremskridtslinjen i Expert-tilstand. Inde i cirklen et trin-symbol (hjerne for træning, kamera for SfM, film for video-frame-udtræk, sparkles for frame-kvalitetstjek, globus ved udpakning af 360°-materiale), trin-titel og fremskridtstallet. Dette tal er under træningen iterationstælleren („12.500/20.000"), i alle andre trin et procenttal. Symbolet pulserer blødt, så længe behandlingen er aktiv. Ved fejl skifter titlen til det mislykkede trin („Structure from Motion Failed", „Training Failed"), ring og tal bliver røde. Efter en afbrydelse viser cirklen i stedet et orange kryds med „Cancelled!".

HVOR

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

TEKNISK

Enkel knap med materiale-baggrund. Slår info-panelet til eller fra. Ikonet skifter mellem info-cirkel-outline og info-cirkel-udfyldt, når aktivt. Blød indtonings-animation. I tooltip'en „Show detailed processing metrics".

HVOR

Nederst til venstre på behandlingsskærmen, synligt kun når behandlingsdetaljerne er slået til.

TEKNISK

To-spaltet panel med ultra-tyndt materiale-baggrund. Venstre spalte: trin-specifikke info-linjer — for SfM statustekst og procent; for træning iteration, kombineret loss, L1-loss, D-SSIM-loss, Gaussian-antal (farvet orange), speed (it/s), forløbet tid, beregnet ETA, SH-degree og learning-rate. Højre spalte: statustekst, tid-info-streng, inline loss-chart (se C-28) og et discoverability-nudge (se C-32). Alle værdier læses fra trænings-statussen, der opdateres ved hvert trænings-tick.

HVOR

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

TEKNISK

Bordered button. Kalder alt efter status Pause eller Resume. Label skifter mellem „Pause" (med pause-ikon) og „Resume" (play-ikon). Under SfM-trinnet vises knappen ikke, fordi Apple Photogrammetry ikke har pause-semantik. Pause-tilstanden bevarer iteration, Gaussian-status og optimizer-momentum fuldstændigt — Resume fortsætter, hvor der tidligere blev standset.

HVOR

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

TEKNISK

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

HVOR

Nederste navigationslinje, synlig når pipelinen er mislykkedes (SfM-status starter med „SfM failed" eller træningen er i fejltilstand).

TEKNISK

Accent-knap. Genstarter hele pipelinen. Før start tjekkes, om der stadig findes importerede billeder/videoer. Tidligere fejl-logs bevares i JSONL-mappen; et nyt run skriver en ny logfil med aktuelt timestamp.

HVOR

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

TEKNISK

Kompakt tegneområde (40 pixel højt), tegner loss-historikken som en 1-pixel-linje i accentfarve. Data filtreres til finite værdier (NaN-beskyttelse for ustabile træninger). Min/max beregnes over hele historikken — chartet auto-zoomer altså på værdiområdet. Den seneste loss-værdi står øverst til højre over chartet. Selve historikken opbygges i app-tilstanden ved hvert trænings-tick (typisk hver 100. iteration).

HVOR

I info-panelet, højre spalte nederst, synlig kun under træning OG i begynder-tilstand.

TEKNISK

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

HVOR

Fuldskærmsbaggrund for preview-trinnet.

TEKNISK

Metal-baseret 3D-viewport, der rendrer den færdige punktsky. Renderen er RadianceKits EGEN ForwardPass-rasterizer — den samme, som allerede rendrer splats under træningen — altså ægte WYSIWYG (det, der trænes, vises og eksporteres på nøjagtig samme måde). Tile-baseret render-pipeline med Order-Independent Transparency. Hvis renderen ikke kan initialiseres (f.eks. fordi Metal ikke er tilgængeligt på systemet), vises i stedet en sort baggrund med teksten „Metal not available". Visningen ignorerer safe-area, så modellen når helt ud til vindueskanten.

HVOR

Over viewporten, svævende: to symbolknapper øverst til venstre, derunder nederst til venstre info-panelet.

TEKNISK

Overlayet består af netop to knapper: „Scene Info" viser og skjuler info-panelet nederst til venstre, den anden skifter kameratilstand mellem „Orbit" (kredser om et målpunkt) og „Fly-Through" (frit flyv). Info-panelet viser billedrate, antal Gaussians, kameratilstand, synsvinkel, renderopløsning og sampling; under en igangværende træning tilføjes en trænings-status-linje, og efter afslutningen en afslutningslinje. Mislykkede eller igangværende scene-indlæsninger vises som egen statuslinje uafhængigt af info-knappen. Auto-rotation, nulstil kamera, baggrundsfarve og skærmbillede er ikke overlay-knapper, men punkter i menuen „Viewport".

HVOR

Nederste navigationslinje i Z3.

TEKNISK

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

HVOR

Venstre hovedside af eksport-trinnet.

TEKNISK

Kort-gitter med to fleksible kolonner og 12 punkts afstand. Itererer over de formater, der tilbydes i begynder-tilstand — en filtreret delmængde af den fulde formatliste, som kun indeholder de 6 vigtigste formater: PLY, SPZ, glTF, .splat, Orbit-video, Web-viewer. De øvrige formater tilbydes kun i Expert-tilstand.

HVOR

Hvert kort i gridet.

TEKNISK

Enkel knap med kort-layout: ikon (f.eks. dokument-lynlås til PLY, arkivkasse til SPZ, video-ikon til Orbit-video) øverst, formatnavn som overskrift, beskrivelses-caption (2 linjer afkortet), derunder den estimerede filstørrelse (beregnet live ud fra format, Gaussian-antal og SH-degree og formateret som KB/MB). Ved klik vælges formatet. Valgt kort får accent-baggrund, accent-kant og et hak-ikon øverst til højre. Tooltip er format-beskrivelsen.

HVOR

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

TEKNISK

Skyder 3–30 sekunder i trin på 1 sekund, bindes til video-længden i app-tilstanden. Maksimal bredde 300 pixel. Vises kun, når et video-format er valgt. Ved ikke-video-formater fjernes skyderen helt fra visningen — ingen død plads.

HVOR

Under format-gridet (og under varigheds-skyderen, hvis video er valgt).

TEKNISK

Stor accent-knap. Label: „Export {format-navn}", del-symbol. Ved klik åbnes macOS-gem-dialogen med den filendelse, der passer til formatet. Det foreslåede filnavn stammer fra navnet på den aktuelle scene; er der ikke sat noget (f.eks. fordi scenen aldrig er blevet gemt), lyder det „scene". Ved bekræftelse skrives eksporten til det valgte sted. Deaktiveret, hvis der ikke findes noget trænings-resultat, eller en eksport allerede kører. Under knappen står nøgletallet for resultatet („2.991 Gaussians • SH degree 3").

HVOR

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

TEKNISK

Fremskridtsindikator med maks-bredde 300 pixel, derunder caption „Exporting… N %". Værdien løber fra 0 til 1 og opdateres under skrivningen — ved PLY i bidder af 10.000 Gaussians, ved SPZ én gang efter kvantisering, ved Orbit-video i frame-intervaller.

HVOR

Under fremskridtslinjen, kun synlig hvis der er opstået en fejl ved sidste eksport.

TEKNISK

Rød linje med advarselstrekant og teksten „Export failed: …" samt fejlbeskrivelse. Rød baggrund med 8 % dækkraft, afrundede hjørner. Maks-bredde 400 pixel. Hyppige fejlårsager: skrivefejl ved fuld diskplads; sandbox-fejl ved gemmesteder uden for det tilladte område.

HVOR

Højre side af eksport-trinnet.

TEKNISK

Liste over eksport-historikken (gemmes permanent i app-indstillingerne, opdateres efter hver vellykket eksport). Hver linje viser format-badge (lille, accentfarvet), tidsstempel (HH:mm), filnavn (1 linje afkortet) og formateret filstørrelse. Klik på en linje åbner Finder med den valgte fil. Tom-tilstand: „No exports yet".

HVOR

Højreklik på en historik-linje.

TEKNISK

Kontekstmenu på hvert liste-element med to handlinger: „Reveal in Finder" (åbner Finder med den valgte fil, ligesom enkeltklik) og „Copy Path" (lægger den fulde filsti som tekst i udklipsholderen). Sidstnævnte er nyttigt til drag-and-drop i andre apps eller til brug i kommandolinjen.