Luku 10 — Aloittelijatila

MISSÄ

Ikkunan yläreunan palkissa, tilanvaihtimen vasemmalla puolella. Näkyy vain Aloittelija-tilassa.

TEKNINEN

Näyttää liukuhihnan kuusi vaihetta peräkkäin aseteltuina painikkeina, kussakin symboli ja nimi, erotettuina nuolimerkillä: Import → Frame Quality → Cameras → Training → Preview → Export. Nykyinen vaihe on täysin väritetty, jo läpikäydyt vaiheet puoliläpinäkyviä, vielä saavuttamattomat vaiheet harmaita. Jo valmiit vaiheet ovat klikattavia ja hyppäävät takaisin; nykyinen vaihe ja kaikki vielä saavuttamattomat ovat poissa käytöstä, samoin koko ketju niin kauan kuin käsittely on käynnissä. Koko liukuhihnan kattavaa yhtenäistä prosentti-edistymispalkkia ei enää ole — käynnissä olevan vaiheen edistymisen näyttää suuri ympyrä käsittelynäytöllä (C-19).

MISSÄ

Tuontivaiheen vasen puoli, suuri katkoviivoitettu suorakulmio symbolin kera. Näytetään Aloittelija-tilassa tekstillä „Drop photos or a video here".

TEKNINEN

Pudotusalue, joka saa symbolin lyhyesti hyppäämään ja värittää taustan, heti kun vedettäviä kohteita leijuu kentän yllä. Hyväksyy JPG-, PNG-, TIFF-, HEIC-, MP4-, MOV-, PLY-, SPZ-, .splat-, .radiancescene-paketit sekä hakemistot. Pudotusreititys tyypin mukaan: kuvat kerätään ja lajitellaan ja siirretään eteenpäin, videot laukaisevat kehysnäytteistys-polun, splat-tiedostot avaavat suoraan esikatselun, scene-paketit luetaan sisään. Hakemistot listataan ja kaikki niissä olevat kuvat tuodaan. Sandbox-yhteensopivaa käyttöä varten tarvittavat security-scoped bookmarkit tallennetaan ja vapautetaan asianmukaisesti. Tuntemattomat tiedostopäätteet näytetään varoitusbannerina 5 sekunnin ajan.

MISSÄ

Pudotusalueen sisällä, näkyvä painike.

TEKNINEN

Painike, joka avaa macOS:n tiedostovalintaikkunan monivalinnalla ja tiedostotyypeillä JPG, PNG, TIFF, MP4, MOV, kansiot sekä sovelluksen omalla scene-formaatilla. Tulosten URL-osoitteet ovat security-scoped ja ne ohjataan samoja tuontipolkuja pitkin kuin vedä-ja-pudota. Kun käyttäjä valitsee kansion, se listataan rekursiivisesti kuvien varalta.

MISSÄ

Pudotusalueen sisällä, näkyvissä vain jos sovelluspaketti sisältää esimerkkiskeneen eikä kuvia/splateja ole vielä tuotu.

TEKNINEN

Näkyy vain, jos (a) sovelluspaketissa on sample-scene.splat, .spz tai .ply JA (b) vielä ei ole tuotu kuvia/videoita eikä pistepilveä ole vielä olemassa. Klikkauksesta latautuu valmis pistepilvi (etusijalla pienin formaatti — .splat ~3 MB, .spz ~1.4 MB, varmuudeksi .ply) ja 400 ms:n kuluttua asetetaan kovakoodatut kamera-arvot kukka-skenen alkuperäisistä metatiedoista esteettisesti järkevää lähtöperspektiiviä varten.

MISSÄ

Pudotusalueen sisällä, „Try Sample Scene"-painikkeen vieressä; samat näkyvyysehdot.

TEKNINEN

Lataa RadianceKitin tarjoaman esimerkkijoukon internetistä: noin 427 Mt eli 960 täysresoluutioista kehystä, jotka puretaan ja otetaan sen jälkeen suoraan sovellukseen käyttöön. Niin kauan kuin jokin toinen käsittely on käynnissä, painike on pois käytöstä eikä lataus käynnisty. Latauksen edistyminen ei näy käyttöliittymässä prosenttilukuna; sen huomaa latauksen valmistuneen, kun kuvaluettelo oikealla täyttyy 960 kehyksestä.

MISSÄ

Tuonti-overlayn alempi kelluva työkalupalkki, esiasetusvalitsimen vasemmalla puolella.

TEKNINEN

Valikkovalitsin, jonka otsikko on „Quality" ja joka ryhmittelee mukana toimitetut esiasetukset luokittain neljään osioon: „Classic", „MCMC (fewer Gaussians, slower)", „Hybrid (sharp detail, compact)" ja „Capture — curated real-world (Drone / 360° / Photo)". Viides osio „Custom" ilmestyy heti, kun täysversio on avattu ja vähintään yksi oma esiasetus on tallennettu. Lukitustila: kaikki muut esiasetukset paitsi Quick ja Preview saavat nimeensä „🔒"-jälkiliitteen, jos käyttäjällä ei ole täysversiota; valittaessa valitsin hyppää takaisin Previewiin ja avaa automaattisesti ostoikkunan. Valinnan yhteydessä esiasetus otetaan käyttöön, mikä korvaa koko koulutuskonfiguraation.

MISSÄ

Tuonti-overlayn alempi kelluva työkalupalkki, esiasetusvalitsimen oikealla puolella.

TEKNINEN

Painike, joka pysyy harmaana niin kauan kuin kuvia tai videota ei ole tuotu. Klikkauksesta liukuhihna käynnistyy ja vaihekone siirtyy järjestykseen Frame-Quality → SfM → Training. Painikkeella itsellään ei ole muuta tilaa; käynnissä oleva käsittely näkyy sen sijaan erillisenä käsittelynäyttönä.

MISSÄ

Oikea kuvaluettelo, näkyy vain kun video (kuvien sijaan) on tuotu.

TEKNINEN

Liukusäädin 0.5 fps – 30 fps 0.5:n askelin. Muutoksesta kehystiheys päivittyy ja lisäksi lasketaan tavoitekehysten määrä (vähintään 10) tiheydestä ja videon pituudesta. Liukusäädin sijaitsee kuvaluettelon ulkopuolella, koska listan elementit estäisivät liukusäätimien hiiritapahtumat. Liukusäätimen alla näkyvät lasketut tavoitekehykset („247 frames") ja videon pituus („1m23s video"). Työkaluvihje varoittaa: „Doubling the density doubles the number of frames and increases SfM time by ~100%."

MISSÄ

Oikea kuvaluettelo, alhaalla oikealla; näkyy vain jos kuvia on tuotu.

TEKNINEN

Punainen painike. Klikkaus avaa vahvistusdialogin, jonka otsikko on „Clear all imported files?" ja viesti „N images will be removed.". Vahvistus tyhjentää kaikki tuodut kuvat/videot, väliaikaishakemistot, pistepilven, koulutustilan, SfM-tuloksen ja kaikki välimuistit; vaihe hyppää takaisin Importiin. Cancel säilyttää kaiken. Dialogi on määritetty ei-tuhoavaksi oletuspoluksi (tuhoava painike merkitty punaisella).

MISSÄ

Oikea kuvaluettelo, jokainen rivi.

TEKNINEN

Luettelo tuoduista kuvista pyyhkäisyllä poistoa varten. Kutakin kuvaa kohti yksi rivi, jossa on kuvake, tiedostonimi, resoluutio („1920 × 1080") ja tiedostokoko (muotoiltuna KB/MB). Resoluutio tulee metatietovälimuistista, joka täytetään asynkronisesti kuvien otsikkotiedoista, ettei käyttöliittymä jumitu. Poisto tapahtuu macOS:lle tyypillisellä pyyhkäisyllä (kosketuslevyllä pyyhkäisy vasemmalle rivin päällä); listassa ei ole rivivalintaa, joten näppäimistön Delete-toiminto ei siis toimi tässä. Huomautus: laajennettu kuvien poistopolku, jossa on selkeä miinuspainike, Backspace ja Cmd-Z kumoamista varten, lisättiin vain Expert-tilassa Project Navigatoriin — Aloittelija-tilassa pyyhkäisypoisto pysyy käytössä.

MISSÄ

Kuvaluettelon alla, Clear All -painikkeen yläpuolella.

TEKNINEN

Kolme peräkkäistä kynnysarvoa tuotujen kuvien määrän perusteella (aktiivinen vain kun kuvia on eikä videota ole): - alle 3 kuvaa: punainen banneri (red octagon), teksti „At least 3 images are required. Camera alignment cannot be computed from fewer images." - 3–9 kuvaa: punainen banneri, teksti „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 kuvaa: oranssi banneri (warning triangle), teksti „Workable, but quality usually improves with 20+ images and good coverage around the scene."

20 kuvasta alkaen banneri katoaa. Kynnysarvot ovat kovakoodattuja ja perustuvat empiirisiin 560+:n koulutuskokeen tuloksiin.

MISSÄ

Kansiota pudotettaessa — ei näkyvää painiketta, vaan tunnistuslogiikka.

TEKNINEN

Kansiota pudotettaessa tarkistetaan, löytyykö siitä jokin kolmesta kanonisesta työtila-asettelusta: sparse/0/cameras.bin, sparse/cameras.bin tai suoraan cameras.bin juuressa. Jos näin on, oletuskuvien listaus keskeytetään ja sen sijaan avataan modaalinen hälytys, joka kysyy käyttäjältä, halutaanko käyttää olemassa olevaa rekonstruktiota vai lähettää kuvat uudelleen Apple Photogrammetryn kautta. Sama polku myös teksti-formaatin työtiloille (cameras.txt) ja ETH3D-vienneille. Katso luku 9, Backend Q6, lisätietoja varten. Toimii Aloittelija-tilassa samoin kuin Expert-tilassa.

MISSÄ

Koko näytön täyttävä tausta edistymisympyrän takana, piilotetaan keskeytyksen tai virheen yhteydessä.

TEKNINEN

Dekoratiivinen animaatio, joka putken edistymisen mukaan (0…1) renderöi kasvavan määrän pieniä animoituja splat-partikkeleita. Lähteenä on laskettu edistymisarvo, joka kuvaa SfM-vaiheet välille 0–0.2 ja koulutuksen välille 0.2–1.0 (Frame-Quality välille 0–0.05). Näin splatit „rakentuvat" näkyvästi koulutuksen edetessä. Puhtaasti dekoratiivinen — näyttö ei näytä nykyisen koulutuksen todellisia välituloksia (se olisi Live-Preview Expert-tilassa). Cancel- tai Failure-tilanteessa se piilotetaan ja vain tilaympyrä jää näkyviin.

MISSÄ

Keskellä käsittelynäyttöä, 220 × 220 pikseliä.

TEKNINEN

Kaksi päällekkäin renderöityä rengasta: ulompi himmennetty track-rengas, sisempi täytetty edistymisrengas, jossa on aksentti- tai punainen väri (punainen virhetilanteessa). Rengas seuraa käynnissä olevan vaiheen todellista edistymistä suoraan (pehmeästi lyhyen esiin-/piiloonhäivytysanimaation kautta), jotta näyttö vastaa Expert-tilan edistymisriviä. Ympyrän sisällä on vaihekuvake (aivot koulutukselle, kamera SfM:lle, filmi videon frame-erottelulle, kimallukset frame-laatutarkistukselle, maapallo 360°-materiaalin purkamiselle), vaiheen otsikko ja edistymisluku. Tämä luku on koulutuksen aikana iteraatiolaskuri („12 500/20 000"), kaikissa muissa vaiheissa prosenttiluku. Kuvake sykkii hienovaraisesti niin kauan kuin käsittely on käynnissä. Virhetilanteessa otsikko vaihtuu epäonnistuneeseen vaiheeseen („Structure from Motion Failed", „Training Failed"), rengas ja luku muuttuvat punaisiksi. Keskeytyksen jälkeen ympyrä näyttää sen sijaan oranssin ristin tekstillä „Cancelled!".

MISSÄ

Vasemmassa yläkulmassa käsittelynäytöllä, 32 × 32 pikseliä.

TEKNINEN

Yksinkertainen painike materiaalitaustalla. Kytkee info-paneelin päälle tai pois. Kuvake vaihtuu i-kirjain-ympyrä-ääriviivan ja täytetyn i-kirjain-ympyrän välillä, kun aktiivinen. Pehmeä esiinhäivytysanimaatio. Tooltipissä „Show detailed processing metrics".

MISSÄ

Vasemmassa alakulmassa käsittelynäytöllä, näkyvissä vain kun käsittelyn tiedot on avattu.

TEKNINEN

Kaksipalstainen paneeli ultra-ohuella material-taustalla. Vasen palsta: vaihekohtaiset infoivit — SfM:lle tilateksti ja prosentti; koulutukselle iteraatio, yhdistetty loss, L1-loss, D-SSIM-loss, Gaussian-määrä (oranssilla värillä), nopeus (it/s), kulunut aika, laskettu ETA, SH-Degree ja oppimisnopeus. Oikea palsta: tilateksti, aika-info-merkkijono, sisäinen loss-kaavio (ks. C-28) ja huomiovihje (ks. C-32). Kaikki arvot luetaan koulutuksen tilasta, joka päivittyy jokaisella koulutus-tickillä.

MISSÄ

Alempi navigointipalkki, näkyvissä vain koulutusvaiheen aikana (EI SfM:n aikana) ja niin kauan kuin käsittely on käynnissä.

TEKNINEN

Bordered Button. Kutsuu tilan mukaan joko Pause- tai Resume-toimintoa. Nimike vaihtuu tekstien „Pause" (Pause-kuvakkeella) ja „Resume" (Play-kuvakkeella) välillä. SfM-vaiheen aikana painiketta ei näytetä, koska Apple Photogrammetry ei tunne pause-semantiikkaa. Pause-tila säilyttää iteraation, Gaussian-tilan ja optimointimomentin kokonaisuudessaan — Resume jatkaa juuri siitä, mihin jäätiin.

MISSÄ

Alempi navigointipalkki, näkyvissä käsittelyn ollessa käynnissä (SfM tai koulutus).

TEKNINEN

Punainen Bordered-painike. Avaa vahvistusdialogin otsikolla „Stop and discard progress?", painikkeet „Discard Progress" (tuhoava) ja „Keep Running" (Cancel). Vahvistuksesta cancel-lippu asetetaan, koulutustehtävä lopetetaan, tarvittaessa SfM-alaprosessi lopetetaan ja yhteenvetorivi keskeytystilalla kirjoitetaan JSONL-lokiin. Toisin kuin Pause-toiminnossa, koulutuksen puskurit ja tila hylätään.

MISSÄ

Alempi navigointipalkki, näkyvissä kun putki on epäonnistunut (SfM-tila alkaa tekstillä „SfM failed" tai koulutus on virhetilassa).

TEKNINEN

Aksenttipainike. Käynnistää koko putken uudelleen. Ennen käynnistystä tarkistetaan, onko tuotuja kuvia/videoita vielä olemassa. Aiemmat virhelokit säilyvät JSONL-hakemistossa; uusi ajo kirjoittaa uuden lokitiedoston nykyisellä aikaleimalla.

MISSÄ

Info-paneelissa, oikea palsta, näkyvissä vain koulutuksen aikana kun historia ei ole tyhjä.

TEKNINEN

Kompakti piirtoalue (40 pikseliä korkea), piirtää loss-historian 1 pikselin viivana aksenttivärillä. Data suodatetaan äärellisiin arvoihin (NaN-suoja epävakaille koulutuksille). Min/max lasketaan koko historian yli — kaavio siis automaattisesti tarkentaa arvoalueeseen. Viimeisin loss-arvo näkyy oikealla ylhäällä kaavion yläpuolella. Historia itsessään kootaan sovelluksen tilaan jokaisella koulutus-tickillä (tyypillisesti joka 100. iteraatiolla).

MISSÄ

Info-paneelissa, oikea palsta alhaalla, näkyvissä vain koulutuksen aikana JA aloittelijatilassa.

TEKNINEN

Pieni rivi silmäkuvakkeella ja teksti „Switch to Expert Mode (⌘2) for live splat preview", hillityllä sävyllä ja 10 pisteen fontilla. Ei interaktiivinen elementti, vain vihje. Ei reagoi napsautukseen — käyttäjän täytyy todella painaa Cmd+2 tai napsauttaa valikkoa Mode → Expert Mode.

MISSÄ

Esikatseluvaiheen koko näytön tausta.

TEKNINEN

Metal-pohjainen 3D-viewport, joka renderöi valmiin pistepilven. Renderöijä on RadianceKitin OMA ForwardPass-rasterisoija — sama, joka renderöi splatit jo koulutuksen aikana — eli aito WYSIWYG (se, mitä koulutetaan, näytetään ja viedään täsmälleen samanlaisena). Tiilipohjainen renderöintiputki, jossa on Order-Independent Transparency. Jos renderöijää ei voida alustaa (esim. koska Metal ei ole järjestelmässä käytettävissä), näytetään sen sijaan musta tausta tekstillä „Metal not available". Näkymä ohittaa turva-alueen (safe area), joten malli ulottuu aina ikkunan reunaan asti.

MISSÄ

Viewportin päällä kelluen: kaksi kuvakepainiketta vasemmassa yläkulmassa, niiden alla vasemmassa alakulmassa info-paneeli.

TEKNINEN

Overlay koostuu tasan kahdesta painikkeesta: „Scene Info" näyttää ja piilottaa info-paneelin vasemmassa alakulmassa, toinen vaihtaa kameratilaa „Orbit"-tilan (kiertäminen kohdepisteen ympäri) ja „Fly-Through"-tilan (vapaa lentäminen) välillä. Info-paneeli näyttää kuvataajuuden, gaussien määrän, kameratilan, katselukulman, renderöintitarkkuuden ja näytteenoton; käynnissä olevan koulutuksen aikana lisätään koulutuksen tilarivi, ja sen päätyttyä valmistumisrivi. Epäonnistuneet tai käynnissä olevat kohtauksen lataukset näytetään omana tilarivinään info-kytkimestä riippumatta. Automaattinen pyöritys, kameran nollaus, taustaväri ja kuvakaappaus eivät ole overlay-painikkeita, vaan valikon „Viewport" kohtia.

MISSÄ

Z3:n alempi navigointipalkki.

TEKNINEN

Korostettu painike, jossa on teksti „Export" ja jakamiskuvake. Napsautus laukaisee siirtymisen Z4:ään. Sitä ennen ylempi näkymä tarkistaa, onko täysi versio avattu — jos ei, vienti-vaiheen sijaan näytetään lukitusnäkymä (katso U-06).

MISSÄ

Vientivaiheen vasen pääsivu.

TEKNINEN

Korttiruudukko kahdella joustavalla sarakkeella ja 12 pisteen välillä. Käy läpi Aloittelija-tilassa tarjotut muodot — suodatetun osajoukon täydestä muotolistasta, joka sisältää vain 6 tärkeintä muotoa: PLY, SPZ, glTF, .splat, Orbit-video, Web-katselin. Muut muodot tarjotaan vain Expert-tilassa.

MISSÄ

Jokainen kortti ruudukossa.

TEKNINEN

Yksinkertainen painike korttiasettelulla: kuvake (esim. tiedostozipperi PLY:lle, arkistolaatikko SPZ:lle, video-kuvake Orbit-videolle) ylhäällä, muodon nimi otsikkona, kuvausteksti (2-riviseksi lyhennetty), alla arvioitu tiedostokoko (lasketaan reaaliajassa muodosta, Gaussian-määrästä ja SH-asteesta ja muotoillaan KB/MB-muodossa). Klikkauksella muoto valitaan. Valittu kortti saa korostustaustan, korostusreunan ja valintamerkki-kuvakkeen oikeassa yläkulmassa. Työkaluvihje näyttää muodon kuvauksen.

MISSÄ

Muotoruudukon alla, näkyvissä vain kun video-muoto on valittu (Orbit-video tai Social-video).

TEKNINEN

Liukusäädin 3–30 sekuntia 1 sekunnin askelin, sidottu videon pituuteen sovelluksen tilassa. Enimmäisleveys 300 pikseliä. Näytetään vain, kun video-muoto on valittuna. Muiden kuin video-muotojen kohdalla liukusäädin poistetaan kokonaan näkymästä — ei turhaa tilaa.

MISSÄ

Muotoruudukon alla (ja Duration-liukusäätimen alla, jos video on valittu).

TEKNINEN

Suuri korostuspainike. Nimike: "Export {muodon nimi}", Share-symboli. Klikkauksella avautuu macOS-tallennusvalintaikkuna muotoa vastaavalla tiedostopäätteellä. Ehdotettu tiedostonimi tulee nykyisen kohtauksen nimestä; jos sitä ei ole asetettu (esim. koska kohtausta ei ole koskaan tallennettu), se on "scene". Vahvistettaessa vienti kirjoitetaan valittuun paikkaan. Poistettu käytöstä, jos harjoitustulosta ei ole tai vienti on jo käynnissä. Painikkeen alla näkyy tuloksen tunnusluku ("2 991 Gaussians • SH degree 3").

MISSÄ

Vientipainikkeen alla, näkyvissä vain viennin ollessa käynnissä.

TEKNINEN

Edistymisilmaisin, jonka enimmäisleveys on 300 pikseliä, alla kuvateksti "Exporting… N %". Arvo kulkee 0:sta 1:een ja päivittyy kirjoituksen aikana — PLY:llä 10 000 Gaussianin lohkoissa, SPZ:llä kertaalleen kvantisoinnin jälkeen, Orbit-videolla kehysväleittäin.

MISSÄ

Edistymispalkin alla, näkyvissä vain jos viimeisessä viennissä tapahtui virhe.

TEKNINEN

Punainen rivi varoituskolmiolla ja tekstillä "Export failed: …" sekä virheen kuvaus. Punainen tausta 8 %:n peittävyydellä, pyöristetyt kulmat. Enimmäisleveys 400 pikseliä. Yleisiä virheen syitä: kirjoitusvirhe levyn ollessa täynnä; sandbox-virhe tallennuskohteiden ollessa sallitun alueen ulkopuolella.

MISSÄ

Vientivaiheen oikea puoli.

TEKNINEN

Lista vientihistoriasta (tallennettu pysyvästi sovelluksen asetuksiin, päivitetään jokaisen onnistuneen viennin jälkeen). Jokainen rivi näyttää muototunnisteen (pieni, korostusvärillinen), aikaleiman (HH:mm), tiedostonimen (1 rivi lyhennettynä) ja muotoillun tiedostokoon. Rivin klikkaus avaa Finderin valitulla tiedostolla. Tyhjä tila: "No exports yet".

MISSÄ

Hiiren oikean painikkeen klikkaus historiariviltä.

TEKNINEN

Kontekstivalikko jokaisessa listamerkinnässä kahdella toiminnolla: "Reveal in Finder" (avaa Finderin valitulla tiedostolla, kuten tavallinen klikkaus) ja "Copy Path" (kopioi koko tiedostopolun tekstinä leikepöydälle). Jälkimmäinen on hyödyllinen vedä-ja-pudota-toimintoon muissa sovelluksissa tai komentorivin käyttöön.