Luku 10 — Aloittelijatila
Aloittelijatila (engl. Simple Mode, Cmd+1) on ohjattu työnkulku kaikille, jotka rekonstruoivat 3D Gaussian Splatting -kohtauksen ensimmäistä kertaa. Sen sijaan, että näytettäisiin sivupalkki täynnä Tarkastajan kenttiä, sovellus opastaa neljän vaiheen läpi: ensin tuodaan kuvia tai video ja valitaan laadun esiasetus, sitten suoritetaan käsittely (SfM + koulutus), jonka jälkeen valmista kohtausta voi tarkastella 3D-esikatselussa, ja lopuksi se viedään haluttuun muotoon. Kapea edistymispalkki ikkunan yläreunassa näyttää jatkuvasti, missä vaiheessa olet.
Verrattuna asiantuntijatilaan (Cmd+2), joka näyttää kaikki ohjauspaneelit samanaikaisesti, aloittelijatila piilottaa käyttämättömät vaihtoehdot, antaa validointivaroituksia liian vähistä tai huonoista kuvista ja tarjoaa kussakin vaiheessa vain ne painikkeet, jotka ovat nykyisessä tilassa järkeviä. Voit vaihtaa milloin tahansa aloittelija- ja asiantuntijatilan välillä (Cmd+1 / Cmd+2), ja koko tila – tuodut kuvat, valittu esiasetus, käynnissä oleva koulutus, valmis pistepilvi – säilyy ja on heti saatavilla toisessa tilassa.
Z1 — Tuonti (kuvien ja esiasetuksen valinta)
Polkunavigaatio (Tuonti aktiivinen) näyttää nelivaiheisen työnkulun. Vasemmalla pudotusalue, jossa on kolme toimintakehotusta: "Selaa tiedostoja" (NSOpenPanel), "Kokeile esimerkkikohtausta" (mukana tuleva demo), "Lataa esimerkkikuvat (~427 MB)" (Mip-NeRF360 flowers -osajoukko). Alla olevat muototunnisteet luettelevat kaikki hyväksytyt tiedostotyypit. Oikealla "Tuodut tiedostot" -laskuri "0 kuvaa" ja tyhjä tila "Ei tiedostoja tuotu vielä". Alhaalla laadunvalitsin (oletus: Esikatselu) ja "Aloita käsittely" (pois käytöstä, kunnes kuvia on tuotu).
Ensimmäinen vaihe on antaa sovellukselle kuvamateriaalia. Tämä tapahtuu vetämällä ja pudottamalla suureen, katkoviivalla merkittyyn kenttään keskellä, "Selaa tiedostoja" -painikkeella tai napsauttamalla mukana toimitettua esimerkkikohtausta. Oikealle ilmestyy luettelo kaikista tuoduista kuvista resoluutioineen ja tiedostokokoineen; alhaalla olevasta kelluvasta työkalupalkista valitset laadun esiasetuksen ja käynnistät prosessin "Aloita käsittely" -painikkeella. Validointivaroitukset (punainen, jos kuvia on < 3 tai < 10, oranssi, jos 10–19) osoittavat, odottaako sovellus järkevää rekonstruktiota vai ei.
C-01ProgressIndicator (vaiheen ilmaisin)
MISSÄ
Työnkulun yläpuolella, aina näkyvissä.
TEKNINEN
Näyttää vaakasuoran edistymispalkin koko prosessin (Kuvanlaatu → SfM → Koulutus) ajan vaihejaolla: Kuvanlaatu vie 0–5 % (vaihe 3.11, hyvin lyhyt), SfM vie 0–30 % palkista, Koulutus 30–100 %. Vieressä on tilateksti ja vaihekohtainen prosenttinäyttö ("SfM 41 %", "Koulutus 12 500/20 000"), jotta käyttäjät eivät tulkitse näennäistä taantumista "41 % SfM → 25 % Koulutus" virheeksi – palkki näyttää koko prosessin edistymisen, ei alivaiheen. ETA-laskenta alkaa, kun riittävästi koulutusnopeutta on mitattu (tyypillisesti ensimmäisten 100 iteraation jälkeen). Sama näyttö on käytössä myös asiantuntijatilassa Tarkastajan yläpuolella.
C-03DropZoneView (vedä ja pudota -alue)
MISSÄ
Tuontivaiheen vasen puoli, suuri katkoviivalla merkitty suorakulmio symbolilla. Näytetään aloittelijatilassa tekstillä "Pudota kuvia tai video tähän".
TEKNINEN
Pudotusalue, joka saa symbolin hyppäämään lyhyesti ja värjää taustan, kun vedettävät kohteet leijuvat kentän yllä. Hyväksyy JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, .radiancescene-paketit ja hakemistot. Pudotuksen reititys tyypin mukaan: kuvat kerätään ja lajitellaan, videot käynnistävät kuvien poimintapolun, Splat-tiedostot avaavat suoraan esikatselun, Scene-paketit luetaan. Hakemistot luetteloidaan ja kaikki sisältämät kuvat tuodaan. Turvallisuuden piiriin kuuluvat kirjanmerkit hiekkalaatikkoyhteensopivaa käyttöä varten otetaan oikein käyttöön ja vapautetaan. Ei-tuettuja tiedostopäätteitä näytetään varoitusbannerina 5 sekunnin ajan.
C-05Selaa tiedostoja -painike
MISSÄ
Pudotusalueen sisällä, näkyvä painike.
TEKNINEN
Painike, joka avaa macOS:n tiedostovalintaikkunan, jossa on monivalinta ja tiedostotyypit JPG, PNG, TIFF, MP4, MOV, kansiot sekä sovelluksen oma Scene-muoto. Tulos-URL-osoitteet ovat turvallisuuden piirissä ja ne välitetään samojen tuontipolkujen kautta kuin vedä ja pudota -toiminto. Jos käyttäjä valitsee kansion, se luetteloidaan rekursiivisesti kuvien löytämiseksi.
C-06Kokeile esimerkkikohtausta -painike
MISSÄ
Pudotusalueen sisällä, näkyvissä vain, jos sovelluspaketti sisältää esimerkkikohtauksen ja kuvia/splatteja ei ole vielä tuotu.
TEKNINEN
Näkyy vain, jos (a) sovelluspaketissa on sample-scene.splat, .spz tai .ply JA (b) kuvia/videoita ei ole vielä tuotu eikä pistepilveä ole olemassa. Napsautettaessa lataa valmiin pistepilven (suosii pienintä muotoa – .splat ~3 MB, .spz ~1.4 MB, varalla .ply) ja asettaa 400 ms:n jälkeen kovakoodatut kamera-arvot kukkakohtauksen alkuperäisistä metatiedoista esteettisesti järkevän aloitusperspektiivin saavuttamiseksi.
C-07Lataa esimerkkikuvat -painike
MISSÄ
Pudotusalueen sisällä, "Kokeile esimerkkikohtausta" -painikkeen vieressä; samat näkyvyysehdot.
TEKNINEN
Käynnistää latauksen (repo github.com/bkindler/radiancekit-sample-photos), joka lataa noin 427 MB:n edestä 960 täyden resoluution kuvaa ja syöttää ne sovellukseen. Latauksen aikana painike on pois käytöstä. Edistyminen näkyy ylemmässä edistymispalkissa "Ladataan X %" omana vaiheenaan, koska tämä vaihe säilyttää oman 0–100 %:n asteikkonsa eikä mene päällekkäin myöhemmän SfM-vaiheen kanssa.
C-09Laatuesiasetusten valitsin
MISSÄ
Tuontinäkymän kelluva alapalkki, vasemmalla käynnistyspainikkeen vieressä.
TEKNINEN
Ohjain, jossa on "Laatu"-otsikko, ryhmittelee saatavilla olevat esiasetukset kategorioittain (Classic / MCMC / Custom). Sisäänrakennetut esiasetukset ryhmitellään kategorian mukaan; osioiden otsikot on kovakoodattu. Mukautetut esiasetukset näkyvät vain, jos niitä on olemassa. Lukittu tila: esiasetukset, jotka eivät ole ilmaislistalla (Quick + Preview), saavat nimeensä "🔒"-jälkiliitteen, jos käyttäjä ei ole ostanut sovellusta; valittaessa valitsin palaa Preview-tilaan ja avaa automaattisesti ostoikkunan. Valittaessa esiasetus otetaan käyttöön, mikä korvaa koko koulutuskonfiguraation.
C-10Aloita käsittely -painike
MISSÄ
Tuontinäkymän kelluva alapalkki, oikealla esiasetusvalitsimen vieressä.
TEKNINEN
Painike, joka pysyy harmaana, kunnes kuvia tai video on tuotu. Napsautettaessa käynnistää prosessin ja vaihtaa tilakoneen järjestykseen Kuvanlaatu → SfM → Koulutus. Painikkeella itsellään ei ole muuta tilaa; käynnissä oleva käsittely näkyy sen sijaan erillisenä käsittelynäkymänä.
C-11Videon näytteenoton liukusäädin
MISSÄ
Oikeanpuoleinen kuvaluettelo, näkyvissä vain, kun video (kuvien sijaan) on tuotu.
TEKNINEN
Liukusäädin 0.5 fps – 30 fps 0.5:n askelin. Muutettaessa kuvatiheys päivitetään ja lisäksi lasketaan kohdekuvien määrä (vähintään 10) tiheydestä ja videon pituudesta. Liukusäädin on kuvaluettelon ulkopuolella, koska luetteloelementit estäisivät liukusäätimien hiiritapahtumia. Liukusäätimen alla näkyvät lasketut kohdekuvat ("247 kuvaa") ja videon pituus ("1m23s video"). Työkaluvihje varoittaa: "Tiheyden kaksinkertaistaminen kaksinkertaistaa kuvien määrän ja lisää SfM-aikaa ~100%."
C-12Tyhjennä kaikki -painike
MISSÄ
Oikeanpuoleinen kuvaluettelo, alhaalla oikealla; näkyvissä vain, kun kuvia on tuotu.
TEKNINEN
Punainen painike. Napsautus avaa vahvistusikkunan, jonka otsikko on "Tyhjennetäänkö kaikki tuodut tiedostot?" ja viesti "N kuvaa poistetaan.". Vahvistus tyhjentää kaikki tuodut kuvat/videot, väliaikaishakemistot, pistepilven, koulutustilan, SfM-tuloksen ja kaikki välimuistit; vaihe palaa takaisin tuontiin. Peruutettaessa kaikki säilyy. Dialogi on konfiguroitu tuhoamattomaksi oletuspoluksi (tuhoava painike merkitty punaisella).
C-13Tiedostolista ForEach (yksittäisen kuvan poisto)
MISSÄ
Oikeanpuoleinen kuvaluettelo, jokainen merkintä.
TEKNINEN
Luettelo tuoduista kuvista, joissa on pyyhkäisy poistamista varten. Jokaisella kuvalla on rivi, jossa on kuvake, tiedostonimi, resoluutio ("1920 × 1080") ja tiedostokoko (muotoiltu KB/MB). Resoluutio tulee metatietovälimuistista, joka täytetään asynkronisesti kuvien otsikoista, jotta käyttöliittymä ei jumiudu. Poistotoiminto tarjoaa macOS-tyypillisen pyyhkäisypoiston (ohjauslevyn pyyhkäisy vasemmalle rivillä) sekä näppäimistön Delete-näppäimen valitulla rivillä. Huomautus: laajennettu kuvanpoistopolku, jossa on erillinen miinuspainike, askelpalautin ja Cmd-Z kumoamista varten, on lisätty vain asiantuntijatilaan projektinavigaattoriin – aloittelijatilassa pysytään pyyhkäisypoistossa.
C-15Validointivaroitukset (3-tasoinen järjestelmä)
MISSÄ
Kuvaluettelon alla, Tyhjennä kaikki -painikkeen yläpuolella.
TEKNINEN
Kolme peräkkäistä kynnystä, jotka perustuvat tuotujen kuvien määrään (aktiivinen vain, kun kuvia on eikä videota): - < 3 kuvaa: punainen banneri (punainen kahdeksankulmio), teksti "Vähintään 3 kuvaa vaaditaan. Kameran kohdistusta ei voida laskea vähemmillä kuvilla." - 3–9 kuvaa: punainen banneri, teksti "Alle 10 kuvalla SfM usein epäonnistuu ja koulutettu kohtaus pyrkii ylisovittumaan [...]. Vähintään 15–20 kuvaa suositellaan; 30+ kohteiden kaappauksiin." - 10–19 kuvaa: oranssi banneri (varituskolmio), teksti "Toimiva, mutta laatu yleensä paranee 20+ kuvalla ja hyvällä peitolla kohtauksen ympärillä."
20 kuvan jälkeen banneri katoaa. Kynnysarvot on kovakoodattu ja perustuvat empiirisiin 560+ koulutuskokeeseen.
C-16COLMAP-työtilan tunnistus
MISSÄ
Kansiota pudotettaessa – ei näkyvää painiketta, vaan tunnistuslogiikka.
TEKNINEN
Kansiota pudotettaessa tarkistetaan, onko siinä jokin kolmesta kanonisesta työtila-asettelusta: sparse/0/cameras.bin, sparse/cameras.bin tai suoraan cameras.bin juuressa. Jos näin on, oletusarvoinen kuvien luettelointi keskeytetään ja sen sijaan avataan modaalinen hälytys, joka kysyy käyttäjältä, käytetäänkö olemassa olevaa rekonstruktiota vai lähetetäänkö kuvat uudelleen Apple Photogrammetryn kautta. Sama polku myös tekstitiedostomuotoisille työtiloille (cameras.txt) ja ETH3D-vienneille. Katso lisätietoja luvusta 9, taustajärjestelmän Q6. Toimii aloittelijatilassa samalla tavalla kuin asiantuntijatilassa.
Milloin seuraavaan vaiheeseen?
Voit napsauttaa "Aloita käsittely", kun (a) vähintään yksi kuva tai video on tuotu ja (b) validointibanneri on oranssi tai kadonnut. Punaisella bannerilla sovellus antaa sinun aloittaa, mutta voit todennäköisesti keskeyttää käsittelyn heti. Suositus: vähintään 20 kuvaa, teräviä, selkeällä päällekkäisyydellä peräkkäisten kuvien välillä, kaikki suunnilleen samalta etäisyydeltä kohteesta. Valitse ennen aloittamista esiasetus, joka sopii aikabudjettiisi – 30 kuvalla ja Quick-esiasetuksella olet valmis muutamassa minuutissa, Quality-esiasetuksella se kestää pikemminkin 1–2 tuntia.
Z2 — Käsittely (SfM + koulutus)
SfM-vaihe (kamerat kohdistetaan): Suuri edistymisympyrä näyttää alivaiheen edistymisen (tässä 41 % käynnissä olevasta Apple Photogrammetry -sessiosta). Tilateksti "Kohdistetaan kameroita..." ylhäällä vasemmalla. Polkunavigaatio merkitsee "Kamerat" aktiiviseksi vaiheeksi. Ylempi tilapalkki näyttää koko prosessin edistymisen (25 %) – SfM vie palkin ensimmäisen puoliskon. Taustalla leijuvat rautalankakamerat viittaavat siihen, että asentoja arvioidaan.
Koulutusvaihe (Gauss-pisteitä optimoidaan): Alivaiheen kuvake vaihtuu "Training Gaussians" -tilaan, prosenttiluku laskee valitun esiasetuksen iteraatioita (tässä 400 / 5 000 Preview-esiasetukselle = 8 % vaiheesta). Live-mittaririvi näyttää Loss-arvon (0.1642), iteraatiot sekunnissa (138.7 it/s) ja ETA:n (33 s). Koko prosessin edistyminen kiipeää 50 %:sta 100 %:iin tämän vaiheen aikana. Tauko-painike (SfM-vaiheen pelkän Peruuta-painikkeen sijaan) mahdollistaa jatkamisen myöhemmin; Peruuta hylkää koulutustuloksen ja palaa Z1:een.
Kun prosessi on käynnissä, sovellus piilottaa tuontinäkymän ja näyttää koko näytön käsittelynäkymän. Keskellä on suuri edistymisympyrä (220 × 220 pikseliä), jossa on vaihekuvake, tilateksti ja prosenttiluku; taustalla hienovarainen splat-animaatio symboloi käynnissä olevaa laskentaa. Ylhäällä vasemmalla voidaan näyttää infopaneeli, joka näyttää live-mittareita koulutuksesta ja SfM:stä. Alhaalla on Tauko/Jatka, Peruuta ja virhetilanteessa Yritä uudelleen -painike.
C-18SplatTrainingView (tausta-animaatio)
MISSÄ
Koko näytön tausta edistymisympyrän takana, piilotettu keskeytyksen tai virheen sattuessa.
TEKNINEN
Koristeellinen animaatio, joka renderöi kasvavan määrän pieniä animoituja splat-hiukkasia prosessin edistymisen (0…1) mukaan. Lähde on laskettu edistymisarvo, joka kuvaa SfM-vaiheet 0–0.2:een ja koulutuksen 0.2–1.0:aan (Kuvanlaatu 0–0.05). Tämän ansiosta splatit "rakentuvat" näkyvästi koulutuksen edetessä. Puhtaasti koristeellinen – näyttö ei näytä nykyisen koulutuksen todellisia välituloksia (se olisi live-esikatselu asiantuntijatilassa). Peruutuksen tai virheen sattuessa se piilotetaan ja vain tilaympyrä jää näkyviin.
C-19Suuri edistymisympyrä
MISSÄ
Käsittelynäkymän keskellä, 220 × 220 pikseliä.
TEKNINEN
Kaksi päällekkäin renderöityä rengasta: ulompi himmeä seurantarengas, sisempi täytetty edistymisrengas korostus- tai punaisella viivalla (punainen virheen sattuessa). Ympyrän sisällä vaihekuvake (aivot koulutukselle, kamera SfM:lle, filmi videokuvan poimintaan, kimallukset kuvanlaadulle), vaiheen otsikko ja live-animoitu prosenttiluku 32 pisteen pyöristetyllä fontilla. Kuvake sykkii kevyesti, kun käsittely on aktiivinen. Näyttö interpoloi pehmeästi kohti nykyistä todellista edistymistä 30 Hz:n ajastimella – jatkuvalla ryömimisellä (0.0003/kehys) plus suhteellisella osuudella (4 % erosta) ja pehmeällä katolla, joka asettuu 80 %:iin seuraavasta odotetusta virstanpylväästä (SfM:lle kovakoodatusta virstanpylvästaulukosta). Näin edistyminen näyttää sujuvalta, vaikka todelliset SfM-päivitykset saapuisivat vain muutaman sekunnin välein.
C-22Info-painike (näytä mittarit)
MISSÄ
Käsittelynäkymän ylävasemmalla, 32 × 32 pikseliä.
TEKNINEN
Yksinkertainen painike materiaalitaustalla. Kytkee infopaneelin päälle tai pois. Kuvake vaihtuu info-ympyrän ääriviivan ja täytetyn info-ympyrän välillä, kun se on aktiivinen. Pehmeä häivytysanimaatio. Työkaluvihjeessä "Näytä yksityiskohtaiset käsittelymittarit".
C-23Info-paneeli (live-mittarit)
MISSÄ
Käsittelynäkymän alavasemmalla, näkyvissä vain, kun showProcessingInfo == true.
TEKNINEN
Kaksisarakkeinen paneeli erittäin ohuella materiaalitaustalla. Vasen sarake: vaihekohtaiset tietorivit – SfM:lle tilateksti ja prosentti; koulutukselle iteraatio, yhdistetty Loss, L1-Loss, D-SSIM-Loss, Gauss-pisteiden määrä (oranssilla värillä), nopeus (it/s), kulunut aika, laskettu ETA, SH-aste ja oppimisnopeus. Oikea sarake: tilateksti, aikatietomerkkijono, sisäinen Loss-kaavio (katso C-28) ja löydettävyysvinkki (katso C-32). Kaikki arvot luetaan koulutustilasta, joka päivitetään jokaisella koulutustikillä.
C-25Tauko/Jatka-painike
MISSÄ
Alanavigointipalkki, näkyvissä vain koulutusvaiheen aikana (EI SfM:n aikana) ja niin kauan kuin käsittely on käynnissä.
TEKNINEN
Reunustettu painike. Kutsuu tilan mukaan Tauko- tai Jatka-toimintoa. Teksti vaihtuu "Tauko" (taukokuvakkeella) ja "Jatka" (toistokuvakkeella) välillä. SfM-vaiheen aikana painiketta ei näytetä, koska Apple Photogrammetry ei tunne tauko-semantiikkaa. Taukotila säilyttää iteraation, Gauss-tilan ja optimoijan momentin täysin – Jatka jatkaa siitä, mihin aiemmin pysähdyttiin.
C-26Peruuta-painike
MISSÄ
Alanavigointipalkki, näkyvissä käsittelyn aikana (SfM tai koulutus).
TEKNINEN
Punainen reunustettu painike. Avaa vahvistusikkunan, jonka otsikko on "Pysäytetäänkö ja hylätäänkö edistyminen?", painikkeet "Hylkää edistyminen" (tuhoava) ja "Jatka suoritusta" (Peruuta). Vahvistuksen jälkeen peruutustunniste asetetaan, koulutustehtävä lopetetaan, SfM-aliprosessi lopetetaan tarvittaessa ja yhteenvetorivi keskeytystilalla kirjoitetaan JSONL-lokiin. Toisin kuin tauolla, koulutuspuskurit ja tila hylätään.
C-27Yritä uudelleen -painike
MISSÄ
Alanavigointipalkki, näkyvissä, kun prosessi on epäonnistunut (SfM-tila alkaa "SfM epäonnistui" tai koulutus on virhetilassa).
TEKNINEN
Korostuspainike. Käynnistää koko prosessin 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.
C-28Sisäinen Loss-kaavio
MISSÄ
Infopaneelissa, oikea sarake, näkyvissä vain koulutuksen aikana, kun historia ei ole tyhjä.
TEKNINEN
Kompakti piirtoalue (40 pikseliä korkea), piirtää Loss-historian 1 pikselin viivana korostusvärillä. Tiedot suodatetaan äärellisiin arvoihin (NaN-suojaus epävakaille koulutuksille). Min/Max lasketaan koko historian perusteella – kaavio siis zoomaa automaattisesti arvoalueelle. Viimeinen Loss-arvo on kaavion oikeassa yläkulmassa. Itse historia rakennetaan sovelluksen tilassa jokaisella koulutustikillä (tyypillisesti 100 iteraation välein).
C-32Löydettävyysvinkki (asiantuntijatilan huomautus)
MISSÄ
Infopaneelissa, oikea sarake alhaalla, näkyvissä vain koulutuksen aikana JA aloittelijatilassa.
TEKNINEN
Pieni rivi silmäkuvakkeella ja kuvatekstillä "Vaihda asiantuntijatilaan (⌘2) nähdäksesi live-splat-esikatselun", hillityllä sävyllä ja 10 pisteen fontilla. Ei interaktiivinen elementti, vain huomautus. Ei reagoi napsautukseen – käyttäjän on todella painettava Cmd+2 tai napsautettava valikkoa Mode → Expert Mode.
Milloin seuraavaan vaiheeseen?
Sovellus siirtyy automaattisesti vaiheeseen Z3 (esikatselu), kun koulutus on onnistuneesti päättynyt – sinun ei tarvitse napsauttaa mitään. Alanavigointipalkki vaihtuu silloin Tauko/Peruuta-painikkeista Takaisin-painikkeeseen (takaisin tuontiin) ja Vie-painikkeeseen (eteenpäin vientiin). Virhetilanteessa (punainen virheilmoitus, vaihekuvake on X) ilmestyy sen sijaan Yritä uudelleen, ja sinun on päätettävä, aloitatko uudelleen vai palaatko Takaisin-painikkeella tuontiin muuttamaan kuvamateriaalia.
Z3 — Esikatselu (3D-mallin kääntäminen)
Polkunavigaatio merkitsee "Esikatselu" aktiiviseksi vaiheeksi. Koko näytön 3D-näkymä renderöi valmiiksi koulutetun kukkakimppukohtauksen (synteettinen Blender-testisetti Bjoernilta, 60 kuvan osajoukko 960 puolipallon muotoisesta kamerasta). Ylätunnisteen tilapalkki: "Koulutus valmis – 3 022 Gauss-pistettä 13 s" – antaa lopullisen Gauss-pisteiden määrän ja koulutusajan. Veto näkymässä pyörittää kameraa (kierto/kallistus); vierityspyörä zoomaa katselusuuntaan. "Takaisin"-painike (alhaalla vasemmalla) palaa Z2:een jatkamista tai uudelleenajoa varten; "Vie"-painike (alhaalla oikealla, ensisijainen) siirtyy eteenpäin Z4:ään.
Koulutuksen päätyttyä sovellus siirtyy automaattisesti esikatseluun. Täällä näet valmiin Gaussian Splatting -mallisi koko näytön Metal-näkymässä ja voit kääntää, zoomata ja panoroida sitä hiirellä ja ohjauslevyllä. Näkymän yläosassa on pieni paneeli, jossa on kameran ohjaimet ja tietoja – automaattinen kierto, koulutustilastot, nollauspainike. Ennen seuraavaa vaihetta (vienti) on suositeltavaa tarkastella mallia eri kulmista varmistaaksesi, että rekonstruktio on siisti.
C-36SplatViewportView (3D-päänäkymä)
MISSÄ
Esikatseluvaiheen koko näytön tausta.
TEKNINEN
Metal-pohjainen 3D-näkymä, joka renderöi valmiin pistepilven. Renderöijä on myyty MetalSplatter-haara, jossa on RadianceKit-korjauksia ponnahduksille/välkkymiselle. Laattapohjainen renderöintiputki, jossa on järjestyksestä riippumaton läpinäkyvyys. Jos renderöijää ei voida alustaa (esim. koska Metal ei ole saatavilla järjestelmässä), näytetään sen sijaan musta tausta "Metal ei saatavilla" -tekstillä. Näkymä jättää turva-alueen huomiotta, joten malli ulottuu ikkunan reunaan asti.
C-37CameraControlsOverlay (ohjauspaneeli)
MISSÄ
Näkymän yläpuolella, leijuvana.
TEKNINEN
Kompakti käyttöliittymäpaneeli, jossa on painikkeet automaattiselle kierrolle (levysoitin), kameran nollaukselle, taustan valinnalle (harmaa/musta/valkoinen), kuvakaappauksen tallentamiselle, infopaneelin vaihtamiselle. Sitoutuu kameran parametreihin (etäisyys, atsimuutti, elevaatio, kohde, FOV) ja ohjaa automaattista levysoitinta. Koulutuksen aikana (kun käyttäjä haluaa nähdä näkymän asiantuntijatilassa) paneeli näyttää lisäksi kompaktin koulutustilarivin.
C-38Vie-painike (navigointipalkki)
MISSÄ
Alanavigointipalkki vaiheessa Z3.
TEKNINEN
Korostuspainike, jossa on teksti "Vie" ja jakokuvake. Napsautus käynnistää siirtymisen Z4:ään. Ennen sitä ylempi näkymä tarkistaa, onko täysversio avattu – jos ei, vientinäkymän sijaan näytetään lukitusnäkymä (katso U-06).
Milloin seuraavaan vaiheeseen?
Ennen vientiä, käännä mallia kerran ympäri ja tarkista: Ovatko kaikki alueet, jotka olet kattanut syötekuvissasi, olemassa? Onko ilmassa leijuvia "floater"-pisteitä (vapaasti ilmassa leijuvia Gauss-pistepilviä)? Näyttääkö tausta/taivas siistiltä vai suttuiselta? Vakavat ongelmat voidaan korjata vain uudelleenkoulutuksella – joko useammilla kuvilla, toisella esiasetuksella tai asiantuntijatilassa floater-vähennysasetuksilla.
Z4 — Vienti (muodon valinta ja tallennus)
Polkunavigaatio merkitsee "Vienti" aktiiviseksi vaiheeksi. Vasemmalla korttiruudukko "Valitse vientimuoto", jossa on kaikki kuusi vaihtoehtoa: PLY (standardi 3DGS, 742 KB, täysillä SH-kertoimilla – tässä esivalittu sinisellä rastilla), SPZ (pakattu 3DGS-muoto, ~90 % pienempi kuin PLY, 74 KB), glTF (KHR_gaussian_splatting-laajennuksella, 708 KB), .splat (yhteensopiva antimatter15-verkkokatselimen kanssa, 96 KB), kiertovideo (360°-MP4 kohtauksesta, reaaliaikainen koon laskenta), verkkokatselin (itsenäinen HTML, jossa on upotettu 3D-katselin, 133 KB). Kokotiedot lasketaan reaaliajassa nykyisestä Gauss-pisteiden määrästä ja muodon ylläpitokustannuksista. Oikealla "Vientihistoria" luettelee jo valmistuneet viennit muototunnisteella, tiedostonimellä ja aikaleimalla – napsautus paljastaa Finderissa. Ensisijainen toimintakehotus alhaalla vasemmalla: "Vie PLY (3DGS-standardi)" Gauss-alaotsikolla "2 991 Gauss-pistettä · SH-aste 3".
Viimeisessä vaiheessa valitset kuudesta vientimuodosta (PLY, SPZ, glTF, .splat, kiertovideo, verkkokatselin) 2-sarakkeisesta korttiruudukosta, napsautat Vie ja valitset tallennuspaikan macOS-dialogissa. Oikealla on historia kaikista aiemmista vienneistä – korttia valittaessa jokaisen kortin alla näytetään heti arvioitu tiedostokoko, joten voit suosia esimerkiksi SPZ:tä, jos haluat julkaista verkossa (pieni), ja PLY:tä, jos haluat tuoda toiseen ohjelmistoon (SuperSplat, Postshot, Blender-laajennuksen kautta) (suuri ja täydellinen).
C-392-sarakkeinen muotoruudukko
MISSÄ
Vientivaiheen vasen pääsivu.
TEKNINEN
Korttiruudukko, jossa on kaksi joustavaa saraketta ja 12 pisteen väli. Iteroi aloittelijatilassa tarjottavien muotojen yli – suodatettu osajoukko täydestä muotolistasta, joka sisältää vain 6 tärkeintä muotoa: PLY, SPZ, glTF, .splat, kiertovideo, verkkokatselin. Compressed-PLY ja SOG tarjotaan VAIN asiantuntijatilassa.
C-40Muotokortti-painike
MISSÄ
Jokainen kortti ruudukossa.
TEKNINEN
Yksinkertainen painike korttiasettelulla: kuvake (esim. asiakirjavetoketju PLY:lle, arkistolaatikko SPZ:lle, videokuvake kiertovideolle) ylhäällä, muodon nimi otsikkona, kuvausteksti (lyhennetty 2 riviin), sen alla arvioitu tiedostokoko (laskettu reaaliajassa muodosta, Gauss-pisteiden määrästä ja SH-asteesta ja muotoiltu KB/MB). Napsautettaessa muoto valitaan. Valittu kortti saa korostustaustan, korostusreunuksen ja rastikuvakkeen oikeassa yläkulmassa. Työkaluvihje on muodon kuvaus.
C-41Videon keston liukusäädin
MISSÄ
Muotoruudukon alla, näkyvissä vain, kun videomuoto on valittu (kiertovideo tai sosiaalisen median video).
TEKNINEN
Liukusäädin 3–30 sekuntia 1 sekunnin askelin, sitoutuu videon pituuteen sovelluksen tilassa. Maksimileveys 300 pikseliä. Näytetään vain, kun videomuoto on valittu. Muissa kuin videomuodoissa liukusäädin poistetaan kokonaan näkymästä – ei hukattua tilaa.
C-42Vie-painike
MISSÄ
Muotoruudukon alla (ja keston liukusäätimen alla, jos video on valittu).
TEKNINEN
Suuri korostuspainike. Teksti: "Vie {muodon nimi}", jakokuvake. Napsautettaessa avataan macOS:n tallennusdialogi muotoon sopivalla päätteellä ja oletustiedostonimellä "scene.{ext}"; vahvistuksen jälkeen vienti kirjoitetaan valittuun URL-osoitteeseen. Pois käytöstä, jos koulutustulosta ei ole tai vienti on jo käynnissä.
C-43Viennin edistymispalkki
MISSÄ
Vie-painikkeen alla, näkyvissä vain viennin aikana.
TEKNINEN
Edistymisnäyttö, maksimileveys 300 pikseliä, alla kuvateksti "Viedään… N %". Arvo kulkee 0:sta 1:een ja päivitetään kirjoituksen aikana – PLY:llä 10 000 Gauss-pisteen paloina, SPZ:llä kerran kvantisoinnin jälkeen, kiertovideolla kuva-intervalleina.
C-44Vientivirheen näyttö
MISSÄ
Edistymispalkin alla, näkyvissä vain, jos viimeisimmässä viennissä tapahtui virhe.
TEKNINEN
Punainen rivi varoituskuvakkeella ja virhetekstillä. Punainen 8 %:n taustan peittävyys, pyöristetyt kulmat. Maksimileveys 400 pikseliä. Yleisiä virhesyitä: SOG odottaa cwebp:tä järjestelmän PATH-muuttujassa (ei App Store -yhteensopiva); kirjoitusvirhe täydellä levyllä; hiekkalaatikkovirhe tallennuskohteissa sallitun alueen ulkopuolella.
C-46Vientihistorialista
MISSÄ
Vientivaiheen oikea puoli.
TEKNINEN
Luettelo vientihistoriasta (tallennetaan pysyvästi JSON-muodossa UserDefaultsiin, ylläpidetään jokaisen onnistuneen viennin jälkeen). Jokainen rivi näyttää muotomerkin (pieni, korostusvärinen), aikaleiman (HH:mm), tiedostonimen (lyhennetty 1 riviin) ja muotoillun tiedostokoon. Rivin napsauttaminen avaa Finderin valitulla tiedostolla. Tyhjä tila: "Ei vientiä vielä".
C-48Historian pikavalikko (hiiren oikea napsautus)
MISSÄ
Hiiren oikea napsautus historiarivillä.
TEKNINEN
Pikavalikko jokaisessa luettelomerkinnässä, jossa on kaksi toimintoa: "Näytä Finderissa" (avaa Finderin valitulla tiedostolla, kuten yksinkertainen napsautus) ja "Kopioi polku" (asettaa koko tiedostopolun tekstinä leikepöydälle). Jälkimmäinen on hyödyllinen vedä ja pudota -toiminnossa muihin sovelluksiin tai komentoriville siirtämiseen.
Milloin työnkulku on valmis?
Onnistuneen viennin jälkeen sinulla on 3D-mallisi tiedostona levyllä ja historia näyttää uuden merkinnän. "Valmis"-painiketta ei ole – voit liittää niin monta vientiä eri muodoissa kuin haluat ilman uudelleenkoulutusta. Jos haluat palata esikatseluun (esim. tarkistaaksesi kameran perspektiivin uudelleen), käytä alanavigointipalkin Takaisin-painiketta. Jos haluat aloittaa kokonaan uuden kohtauksen, palaa Takaisin-painikkeella Z1:een ja käytä siellä Tyhjennä kaikki -toimintoa tai Tiedosto → Uusi projekti (Cmd+⇧+N).
Vaihto asiantuntijatilaan
Paina milloin tahansa Cmd+2 tai valitse Mode → Expert Mode (M8). Koko tila säilyy: tuodut kuvat, valittu esiasetus, käynnissä oleva tai valmis koulutus, valmis pistepilvi, vientihistoria, jopa nykyinen vaihe. Asiantuntijatilassa nelivaiheisen näkymän sijaan näytetään koko Tarkastajan sivupalkki kaikilla noin 150 ohjauspaneelilla. Erityisesti: projektinavigaattori (katso luku 2) tarjoaa laajennetut kuvatoiminnot (miinuspainike, askelpalauttimella poisto, Cmd-Z-kumoaminen, Quick Look -esikatselu), live-esikatselun näkymässä koulutuksen aikana sekä kaikki Loss-, MCMC-, Densification- ja Mip-Splatting-parametrit. Cmd+1 vaihtaa takaisin aloittelijatilaan – myöskään tämä ei menetä mitään tilaa.
Usein kysytyt kysymykset
Miksi Aloita käsittely -painikkeeni on harmaa?
Et ole vielä tuonut kuvia tai videota. Vedä vähintään yksi tiedosto pudotusalueelle tai käytä "Selaa tiedostoja" -painiketta. Heti kun oikealla oleva kuvaluettelo sisältää vähintään yhden merkinnän, painike aktivoituu. (Vain 1–2 kuvalla se käynnistyy, mutta SfM keskeytyy heti virheeseen – katso punainen validointibanneri.)
Miksi Vie-painikkeeni on lukittu?
Aloittelijatilassa on kaksi vaihetta: (a) Jos koulutusprosessi ei ole vielä valmis ja sinulla ei ole tulosta, painike on pois käytöstä – sinun on ensin suoritettava Z2. (b) Jos et ole vielä ostanut täysversiota (PurchaseManager.hasAccess == false), näet vientinäkymän sijaan lukitusnäkymän, jossa on lukkosymboli ja "Avaa täysversio" -painike, joka avaa ostoikkunan. Quick- ja Preview-esiasetukset mahdollistavat koulutuksen ilmaiseksi, mutta vienti on premium-ominaisuus.
Miksi en voi valita esiasetusta?
Voit valita sen – mutta jos napautat premium-esiasetusta (Balanced, Quality, MCMC-versiot) ilman ostettua täysversiota, valitsin palaa automaattisesti Preview-tilaan ja ostoikkuna avautuu. Quick ja Preview ovat ainoat ilmaiseksi käytettävät esiasetukset.
Miksi pudotusalueeni on tyhjä ja katkoviivalla harmaa, vaikka vedän sinne kuvia?
Todennäköisesti UTI-tyyppivirhe. Sovellus hyväksyy JPG, PNG, TIFF, HEIC, MP4, MOV sekä sovelluksen omat Splat-muodot. Muita kuvamuotoja (BMP, GIF, WebP, RAW-muodot) EI tunnisteta. Jos olet varma, että kuvatyyppisi pitäisi olla tuettu, tarkista tiedostopääte – sovellus perustuu ensisijaisesti päätteeseen, ei tiedoston sisältöön.
Miksi SfM kestää niin kauan, vaikka minulla on vain 30 kuvaa?
Apple Photogrammetry ei skaalaudu lineaarisesti – joissakin kuva-asetelmissa (sisätilat monimutkaisilla tekstuureilla, liike-epäterävyys, huono valaistus) se kestää huomattavasti kauemmin kuin kuvien määrä antaisi olettaa. Jos SfM on 10+ minuutin jälkeen 30 kuvalla edelleen jumissa, keskeytä ja yritä uudelleen paremmalla materiaalilla, tai vaihda asiantuntijatilaan ja kokeile COLMAP/Native-SfM:ää (Cmd+2 → Tarkastaja → Kameran kohdistus).
Mistä löydän koulutuslokini?
Help → Open Training Logs (Cmd+⇧+L). Tämä avaa ~/Documents/RadianceKit/Logs/. Jokainen koulutussessio kirjoittaa oman JSONL-tiedoston, jonka tiedostonimessä on aikaleima – ensimmäinen rivi on konfiguraatio, sen jälkeen tulee edistymisrivi 100 iteraation välein, viimeinen rivi on yhteenveto lopullisella Loss-arvolla ja onnistumistunnisteella.