Kapitel 10 — Nybörjarläge

VAR

I fältet längs fönstrets övre kant, till vänster om lägesomkopplaren. Syns endast i nybörjarläget.

TEKNISKT

Visar pipelinens sex steg som en kedja av sammanlänkade knappar, var och en med symbol och namn, åtskilda av en pil: Import → Frame Quality → Cameras → Training → Preview → Export. Det aktuella steget är helt färglagt, redan genomgångna steg halvtransparenta, ännu inte nådda steg gråa. Redan avslutade steg går att klicka på och hoppar tillbaka; det aktuella steget och alla ännu inte nådda steg är inaktiverade, liksom hela kedjan, så länge en bearbetning pågår. Ett genomgående procentuellt förloppsfält över hela pipelinen finns inte längre — förloppet för det pågående steget visas av den stora cirkeln på bearbetningsskärmen (C-19).

VAR

Vänster sida av importsteget, stor streckad rektangel med symbol. Visas i nybörjarläget med etiketten "Drop photos or a video here".

TEKNISKT

Släppområde som får symbolen att studsa till och bakgrunden att färgas när dragobjekt svävar över rutan. Accepterar JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, .radiancescene-buntar och kataloger. Släpp-routning per typ: bilder samlas in och skickas sorterade vidare, videor utlöser ramsamplingsvägen, splat-filer öppnar direkt förhandsgranskningen, scenbuntar läses in. Kataloger genomsöks och alla bilder som ingår importeras. Sandlådekompatibla säkerhetsomfattade bokmärken för åtkomst tas korrekt upp och släpps. Filändelser som inte stöds visas som varningsbanner i 5 sekunder.

VAR

Inuti drop-zonen, framträdande knapp.

TEKNISKT

Knapp som öppnar macOS filväljardialog med flerval och filtyperna JPG, PNG, TIFF, MP4, MOV, mappar samt appens eget scenformat. Resulterande URL:er är säkerhetsomfattade och skickas vidare via samma importvägar som dra-och-släpp. Om användaren väljer en mapp genomsöks den rekursivt efter bilder.

VAR

Inuti drop-zonen, syns endast om appbunten innehåller exempelscenen och inga bilder/splats ännu importerats.

TEKNISKT

Visas endast om (a) en sample-scene.splat, .spz eller .ply finns i appbunten OCH (b) inga bilder/videor ännu importerats och inget punktmoln finns. Vid klick laddas det färdiga punktmolnet (helst det minsta formatet — .splat ~3 MB, .spz ~1.4 MB, reserv .ply) och efter 400 ms sätts hårdkodade kameravärden från originalmetadata för blomscenen för ett estetiskt lämpligt utgångsperspektiv.

VAR

Inuti drop-zonen, bredvid "Try Sample Scene"; samma synlighetsvillkor.

TEKNISKT

Laddar ner ett exempeluppsättning som tillhandahålls av RadianceKit från internet: cirka 427 MB med 960 helupplösta bildrutor, som sedan packas upp och tas direkt in i appen. Så länge en annan bearbetning pågår är knappen inaktiverad och nedladdningen startar inte. Nedladdningsförloppet visas i gränssnittet inte som en procentsats; att nedladdningen är klar märker du genom att bildlistan till höger fylls med de 960 bildrutorna.

VAR

Svävande nedre verktygsfält i importöverlägget, till vänster om startknappen.

TEKNISKT

Menyväljare med etiketten "Quality", som grupperar de medföljande förinställningarna efter kategori i fyra avsnitt: "Classic", "MCMC (fewer Gaussians, slower)", "Hybrid (sharp detail, compact)" och "Capture — curated real-world (Drone / 360° / Photo)". Ett femte avsnitt "Custom" tillkommer så fort fullversionen låsts upp och minst en egen förinställning har sparats. Låst tillstånd: alla förinställningar utom Quick och Preview får suffixet "🔒" på namnet om användaren inte äger fullversionen; vid val hoppar väljaren tillbaka till Preview och öppnar automatiskt köpfönstret. Vid val tillämpas förinställningen, vilket ersätter hela träningskonfigurationen.

VAR

Svävande nedre verktygsfält i importöverlägget, till höger om förinställningsväljaren.

TEKNISKT

Knapp som förblir grå så länge varken bilder eller en video har importerats. Vid klick startas pipelinen och stegmaskinen ställs om i ordningen Frame-Quality → SfM → Training. Knappen i sig har inget ytterligare tillstånd; en pågående bearbetning visas istället som en separat bearbetningsskärm.

VAR

Höger bildlista, syns endast om en video (i stället för bilder) har importerats.

TEKNISKT

Skjutreglage 0.5 fps – 30 fps i steg om 0.5. Vid ändring uppdateras bildrutetätheten och dessutom beräknas antalet målbildrutor (minst 10) utifrån täthet och videolängd. Reglaget ligger utanför bildlistan, eftersom listelement skulle blockera musdrag från reglage. Under reglaget visas de beräknade målbildrutorna ("247 frames") och videolängden ("1m23s video"). Verktygstips varnar: "Doubling the density doubles the number of frames and increases SfM time by ~100%."

VAR

Höger bildlista, nere till höger; syns endast om bilder har importerats.

TEKNISKT

Röd knapp. Klick öppnar en bekräftelsedialog med titeln "Clear all imported files?" och meddelandet "N images will be removed.". Bekräftelse rensar alla importerade bilder/videor, mellanlagringskataloger, punktmolnet, träningsstatus, SfM-resultatet och alla cachar; steget hoppar tillbaka till Import. Vid Cancel bevaras allt. Dialogen är konfigurerad som en icke-destruktiv standardväg (den destruktiva knappen markerad i rött).

VAR

Höger bildlista, varje post.

TEKNISKT

Lista över de importerade bilderna med svep för att ta bort. En rad per bild med ikon, filnamn, upplösning ("1920 × 1080") och filstorlek (formaterad KB/MB). Upplösningen kommer från en metadatacache som fylls asynkront från bildhuvudena så att gränssnittet inte blockeras. Borttagning sker via macOS-typiskt svep-för-att-ta-bort (styrplatta-svep åt vänster på en rad); listan har ingen radmarkering, ett tangentbordsradering finns alltså inte här. Obs: den utökade bildborttagningsvägen med uttrycklig minus-knapp, Backspace och Cmd-Z för att ångra lades till endast i expertläget i Project Navigator — i nybörjarläget fortsätter det med svep-för-att-ta-bort.

VAR

Under bildlistan, ovanför Clear All-knappen.

TEKNISKT

Tre på varandra följande tröskelvärden baserat på antalet importerade bilder (endast aktiv om bilder finns och ingen video): - < 3 bilder: röd banner (röd åttakant), text "At least 3 images are required. Camera alignment cannot be computed from fewer images." - 3–9 bilder: röd banner, text "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: orange banner (varningstriangel), text "Workable, but quality usually improves with 20+ images and good coverage around the scene."

Från 20 bilder försvinner bannern. Tröskelvärdena är hårdkodade och baseras på empiriska experiment med 560+ träningskörningar.

VAR

Vid släpp av en mapp — ingen synlig knapp, utan detekteringslogik.

TEKNISKT

Vid släpp av en katalog kontrolleras om den innehåller en av de tre kanoniska arbetsyte-layouterna: sparse/0/cameras.bin, sparse/cameras.bin eller direkt cameras.bin i roten. Om så är fallet avbryts den vanliga bildgenomsökningen och en modal varning öppnas istället, som frågar användaren om den befintliga rekonstruktionen ska användas eller om bilderna på nytt ska skickas genom Apple Photogrammetry. Samma väg gäller även textformat-arbetsytor (cameras.txt) och ETH3D-exporter. Se kapitel 9 Backend F6 för detaljer. Fungerar likadant i nybörjarläget som i expertläget.

VAR

Helskärmsbakgrund bakom förloppscirkeln, döljs vid avbrott eller fel.

TEKNISKT

Dekorativ animation som beroende på pipelinens förlopp (0…1) renderar ett ökande antal små animerade splat-partiklar. Källan är ett beräknat förloppsvärde som mappar SfM-faser till 0–0.2 och träning till 0.2–1.0 (frame-quality till 0–0.05). Därmed "byggs" splattarna synligt upp medan träningen pågår. Rent dekorativt — visningen visar inga verkliga mellanresultat från den aktuella träningen (det vore live-förhandsvisning i expertläge). Vid Cancel eller Failure döljs den och bara statuscirkeln förblir synlig.

VAR

I mitten av bearbetningsskärmen, 220 × 220 pixlar.

TEKNISKT

Två ringar renderade ovanpå varandra: yttre en dämpad spårring, inre en fylld förloppsring med accent- eller röd stroke (röd vid fel). Ringen följer det verkliga förloppet av det pågående steget direkt (mjukt via en kort in-/uttoningsanimation), så att visningen stämmer överens med förloppsraden i expertläget. Inuti cirkeln finns en scensymbol (hjärna för träning, kamera för SfM, film för videoframe-extraktion, sparkles för framekvalitetskontrollen, jordglob vid uppackning av 360°-material), scentitel och förloppstalet. Detta tal är under träningen iterationsräknaren ("12 500/20 000"), i alla andra steg ett procenttal. Symbolen pulserar mjukt så länge bearbetningen är aktiv. Vid fel byter titeln till det misslyckade steget ("Structure from Motion Failed", "Training Failed"), ring och tal blir röda. Efter ett avbrott visar cirkeln istället ett orange kryss med "Cancelled!".

VAR

Uppe till vänster på bearbetningsskärmen, 32 × 32 pixlar.

TEKNISKT

Enkel knapp med material-bakgrund. Slår infopanelen på eller av. Ikonen växlar mellan info-cirkel-outline och info-cirkel-fylld, när aktiv. Mjuk intoningsanimation. I tooltipen "Show detailed processing metrics".

VAR

Nere till vänster på bearbetningsskärmen, synlig endast när bearbetningsdetaljerna är visade.

TEKNISKT

Tvåspaltig panel med ultra-thin-material-bakgrund. Vänster spalt: stegspecifika inforader — för SfM statustext och procent; för träning iteration, kombinerad loss, L1-loss, D-SSIM-loss, Gaussian-count (färgad orange), speed (it/s), elapsed-time, beräknad ETA, SH-degree och learning-rate. Höger spalt: statustext, time-info-sträng, inline loss-diagram (se C-28) och en discoverability-nudge (se C-32). Alla värden läses från träningsstatusen som uppdateras vid varje träningstick.

VAR

Nedre navigeringsraden, synlig endast under träningssteget (INTE under SfM) och så länge bearbetningen pågår.

TEKNISKT

Bordered button. Anropar beroende på status Pause eller Resume. Etiketten växlar mellan "Pause" (med pausikon) och "Resume" (playikon). Under SfM-steget visas inte knappen, eftersom Apple Photogrammetry inte har någon paus-semantik. Paus-tillståndet bevarar iteration, Gaussian-status och optimizer-momentum helt — Resume fortsätter exakt där det tidigare pausades.

VAR

Nedre navigeringsraden, synlig medan bearbetningen pågår (SfM eller träning).

TEKNISKT

Röd bordered-knapp. Öppnar en bekräftelsedialog med titeln "Stop and discard progress?", knapparna "Discard Progress" (destruktiv) och "Keep Running" (avbryt). Vid bekräftelse sätts cancel-flaggan, träningsuppgiften avslutas, SfM-subprocessen avslutas om det behövs och en sammanfattningsrad med avbrottsstatus skrivs till JSONL-loggen. Till skillnad från Pause förkastas träningsbuffertar och status.

VAR

Nedre navigeringsraden, synlig om pipelinen misslyckats (SfM-status börjar med "SfM failed" eller träningen är i felläge).

TEKNISKT

Accent-knapp. Startar om hela pipelinen. Innan start kontrolleras om importerade bilder/videor fortfarande finns. Tidigare fellogg finns kvar i JSONL-katalogen; en ny körning skriver en ny loggfil med aktuell tidsstämpel.

VAR

I infopanelen, höger spalt, synlig endast under träning med icke-tom förloppshistorik.

TEKNISKT

Kompakt ritningsyta (40 pixlar hög), ritar loss-historiken som en 1-pixels linje i accentfärg. Data filtreras till finita värden (NaN-skydd för instabila träningar). Min/max beräknas över hela historiken — diagrammet auto-zoomar alltså till värdeintervallet. Det senaste loss-värdet visas uppe till höger ovanför diagrammet. Historiken själv byggs upp i app-tillståndet vid varje träningstick (vanligtvis var 100:e iteration).

VAR

I infopanelen, höger spalt nedtill, synlig endast under träning OCH i nybörjarläge.

TEKNISKT

Liten rad med ögonikon och captiontext "Switch to Expert Mode (⌘2) for live splat preview", i återhållsam tonalitet och 10-punkts stil. Inget interaktivt element, endast ett tips. Reagerar inte på klick — användaren måste faktiskt trycka Cmd+2 eller klicka på menyn Mode → Expert Mode.

VAR

Fullskärmsbakgrund i förhandsvisningssteget.

TEKNISKT

Metal-baserad 3D-viewport som renderar den färdiga punktmolnen. Renderaren är RadianceKits EGEN ForwardPass-rasteriserare — samma som redan renderar splattarna under träningen — alltså äkta WYSIWYG (det som tränas visas och exporteras exakt så). Kakelbaserad render-pipeline med Order-Independent Transparency. Om renderaren inte kan initieras (t.ex. för att Metal inte är tillgängligt på systemet) visas i stället en svart bakgrund med „Metal not available"-text. Vyn ignorerar Safe Area, så att modellen sträcker sig ända ut till fönsterkanten.

VAR

Ovanför viewporten, svävande: två symbolknappar uppe till vänster, och under dem nere till vänster info-panelen.

TEKNISKT

Overlayn består av exakt två knappar: „Scene Info" visar och döljer info-panelen nere till vänster, den andra växlar kameraläget mellan „Orbit" (kretsar kring en målpunkt) och „Fly-Through" (fri flygning). Info-panelen visar bildfrekvens, antal Gaussians, kameraläge, synvinkel, renderupplösning och sampling; under en pågående träning tillkommer en träningsstatusrad, och efter avslutad träning en slutförandrad. Misslyckade eller pågående sceninläsningar visas som en egen statusrad oberoende av info-knappen. Auto-rotation, återställ kamera, bakgrundsfärg och skärmdump är inga overlay-knappar utan poster i menyn „Viewport".

VAR

Nedre navigeringsfältet i Z3.

TEKNISKT

Accentknapp med etiketten „Export" och en dela-ikon. Klick utlöser övergången till Z4. Innan dess kontrollerar den överordnade vyn om fullversionen är upplåst — om inte visas låsvyn i stället för exportsteget (se U-06).

VAR

Vänster huvudsida i exportsteget.

TEKNISKT

Kortrutnät med två flexibla kolumner och 12 punkters avstånd. Itererar över formaten som erbjuds i nybörjarläget — en filtrerad delmängd av den fullständiga formatlistan som endast innehåller de 6 viktigaste formaten: PLY, SPZ, glTF, .splat, orbit-video, webbvisare. Övriga format erbjuds endast i expertläge.

VAR

Varje kort i rutnätet.

TEKNISKT

Enkel knapp med kortlayout: ikon (t. ex. dokument-blixtlås för PLY, arkivlåda för SPZ, videoikon för orbit-video) överst, formatnamn som rubrik, beskrivande bildtext (2 rader förkortad), därunder den beräknade filstorleken (beräknad live utifrån format, Gaussian-antal och SH-grad och formaterad som KB/MB). Vid klick väljs formatet. Valt kort får accentbakgrund, accentram och en bock-ikon uppe till höger. Tooltip är formatbeskrivningen.

VAR

Under formatrutnätet, synligt endast när ett videoformat är valt (orbit-video eller social-video).

TEKNISKT

Skjutreglage 3–30 sekunder i steg om 1 sekund, kopplat till videolängden i apptillståndet. Maxbredd 300 pixlar. Visas endast när ett videoformat är valt. Vid icke-videoformat tas reglaget bort helt från vyn — inget dött utrymme.

VAR

Under formatrutnätet (och under längdreglaget, om video valts).

TEKNISKT

Stor accentknapp. Etikett: "Export {formatnamn}", dela-symbol. Vid klick öppnas macOS-sparadialogen med filändelsen som passar formatet. Det föreslagna filnamnet kommer från namnet på den aktuella scenen; om inget är angivet (t. ex. för att scenen aldrig sparats) blir det "scene". Vid bekräftelse skrivs exporten till den valda platsen. Inaktiverad om inget träningsresultat finns eller om en export redan pågår. Under knappen visas resultatets nyckeltal ("2.991 Gaussians • SH degree 3").

VAR

Under exportknappen, synlig endast medan en export pågår.

TEKNISKT

Förloppsindikator med maxbredd 300 pixlar, därunder bildtext "Exporting… N %". Värdet går från 0 till 1 och uppdateras under skrivningen — för PLY i portioner om 10 000 Gaussians, för SPZ en gång efter kvantisering, för orbit-video vid bildruteintervall.

VAR

Under förloppsindikatorn, synlig endast om ett fel uppstod vid senaste exporten.

TEKNISKT

Röd rad med varningstriangel och texten "Export failed: …" tillsammans med en felbeskrivning. Röd bakgrund med 8 % opacitet, rundade hörn. Maxbredd 400 pixlar. Vanliga felorsaker: skrivfel vid full disk; sandlådefel vid lagringsmål utanför tillåtet område.

VAR

Höger sida av exportsteget.

TEKNISKT

Lista över exporthistoriken (sparas permanent i appinställningarna, uppdateras efter varje lyckad export). Varje rad visar formatmärke (litet, accentfärgat), tidsstämpel (HH:mm), filnamn (1 rad förkortad) och formaterad filstorlek. Klick på en rad öppnar Finder med den markerade filen. Tomt tillstånd: "No exports yet".

VAR

Högerklick på en historikrad.

TEKNISKT

Kontextmeny på varje listpost med två åtgärder: "Reveal in Finder" (öppnar Finder med markerad fil, precis som enkelklick) och "Copy Path" (lägger den fullständiga filsökvägen som text i urklipp). Det senare är användbart för dra-och-släpp till andra appar eller för att skicka till kommandoraden.