Kapitola 10 — Režim pro začátečníky

KDE

V liště na horním okraji okna, vlevo vedle přepínače režimu. Viditelné pouze v režimu pro začátečníky.

TECHNICKY

Zobrazuje šest stupňů pipeline jako řetěz tlačítek řazených za sebou, každé se symbolem a názvem, oddělené šipkou: Import → Frame Quality → Cameras → Training → Preview → Export. Aktuální stupeň je plně obarven, již proběhlé stupně poloprůhledné, ještě nedosažené stupně šedé. Již dokončené stupně jsou klikatelné a umožňují skok zpět; aktuální stupeň a všechny ještě nedosažené jsou deaktivované, stejně jako celý řetěz, dokud probíhá zpracování. Souvislý procentní ukazatel průběhu přes celou pipeline už neexistuje — průběh aktuálního stupně ukazuje velký kruh na obrazovce zpracování (C-19).

KDE

Levá strana kroku Import, velký čárkovaně orámovaný obdélník se symbolem. V režimu pro začátečníky zobrazen s popiskem „Drop photos or a video here".

TECHNICKY

Drop-oblast, která nechá symbol krátce poskočit a obarví pozadí, jakmile se nad polem vznášejí přetahované položky. Přijímá JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, balíčky .radiancescene a adresáře. Směrování při dropu podle typu: obrázky se shromáždí a předají seřazené, videa spouští cestu vzorkování snímků (frame-sampling), soubory se splaty otevřou přímo Preview, balíčky scén se načtou. Adresáře se prohledávají (enumerují) a importují se všechny obsažené obrázky. Security-scoped bookmarky pro sandboxem povolený přístup jsou správně vytvářeny a uvolňovány. Nepodporované přípony se zobrazí jako výstražný banner na 5 sekund.

KDE

Uvnitř Drop-zóny, výrazné tlačítko.

TECHNICKY

Tlačítko, které otevře systémový dialog souborů macOS s vícenásobným výběrem a typy souborů JPG, PNG, TIFF, MP4, MOV, složka a vlastním formátem scény aplikace. Výsledné URL jsou security-scoped a předávají se přes stejné importní cesty jako drag-and-drop. Pokud uživatel zvolí složku, prohledá se rekurzivně na obrázky.

KDE

Uvnitř Drop-zóny, viditelné pouze pokud balíček aplikace obsahuje vzorovou scénu a ještě nejsou importované žádné obrázky/splaty.

TECHNICKY

Objeví se pouze, pokud (a) existuje sample-scene.splat, .spz nebo .ply v balíčku aplikace A ZÁROVEŇ (b) ještě nejsou importované žádné obrázky/videa a ještě neexistuje žádný mrak bodů. Při kliknutí načte hotový mrak bodů (upřednostní nejmenší formát — .splat ~3 MB, .spz ~1.4 MB, záložně .ply) a po 400 ms nastaví napevno zakódované hodnoty kamery z původních metadat scény s květinami pro esteticky smysluplnou vstupní perspektivu.

KDE

Uvnitř Drop-zóny, vedle „Try Sample Scene"; stejné podmínky viditelnosti.

TECHNICKY

Stáhne z internetu vzorovou sadu poskytnutou RadianceKit: zhruba 427 MB, 960 snímků v plném rozlišení, které se následně rozbalí a rovnou převezmou do aplikace. Dokud probíhá jiné zpracování, je tlačítko deaktivováno a stahování nespustí. Průběh stahování se v rozhraní neuvádí jako procentní hodnota; že je stahování hotové, poznáš podle toho, že se seznam obrázků vpravo naplní 960 snímky.

KDE

Plovoucí spodní nástrojová lišta importního overlay, vlevo vedle tlačítka Start.

TECHNICKY

Menu-picker s popiskem „Quality", který dodávané Presety seskupuje podle kategorie do čtyř sekcí: „Classic", „MCMC (fewer Gaussians, slower)", „Hybrid (sharp detail, compact)" a „Capture — curated real-world (Drone / 360° / Photo)". Pátá sekce „Custom" přibude, jakmile je odemčena plná verze a je uložen alespoň jeden vlastní Preset. Zamčený stav: Všechny Presety kromě Quick a Preview dostanou příponu „🔒" k názvu, pokud uživatel nevlastní plnou verzi; při výběru picker skočí zpět na Preview a automaticky otevře okno nákupu. Při výběru se Preset aplikuje, což nahradí celou konfiguraci trénování.

KDE

Plovoucí spodní nástrojová lišta importního overlay, vpravo vedle Preset-pickeru.

TECHNICKY

Tlačítko, které zůstává šedé, dokud nejsou importovány žádné obrázky ani video. Při kliknutí spustí pipeline a přepne stavový automat do pořadí Frame-Quality → SfM → Training. Samo tlačítko nemá další stav; probíhající zpracování se místo toho zobrazí jako samostatná obrazovka zpracování.

KDE

Pravý seznam obrázků, viditelný pouze pokud bylo importováno video (místo obrázků).

TECHNICKY

Posuvník 0.5 fps – 30 fps v krocích po 0.5. Při změně se aktualizuje hustota snímků a navíc se z hustoty a délky videa vypočítá počet cílových snímků (minimálně 10). Posuvník leží mimo seznam obrázků, protože prvky seznamu by blokovaly události myši od posuvníků. Pod posuvníkem se zobrazují vypočítané cílové snímky („247 frames") a délka videa („1m23s video"). Tooltip varuje: „Doubling the density doubles the number of frames and increases SfM time by ~100%."

KDE

Pravý seznam obrázků, vpravo dole; viditelné pouze pokud jsou importované obrázky.

TECHNICKY

Červené tlačítko. Kliknutí otevře potvrzovací dialog s titulkem „Clear all imported files?" a zprávou „N images will be removed.". Potvrzením se vymažou všechny importované obrázky/videa, pracovní adresáře, mrak bodů, stav trénování, výsledek SfM a všechny cache; stupeň se vrátí zpět na Import. Při Cancel zůstává vše zachováno. Dialog je nakonfigurován jako nedestruktivní výchozí cesta (destruktivní tlačítko označeno červeně).

KDE

Pravý seznam obrázků, každá položka.

TECHNICKY

Seznam importovaných obrázků se smazáním přejetím (swipe). Na obrázek jeden řádek s ikonou, názvem souboru, rozlišením („1920 × 1080") a velikostí souboru (formátováno KB/MB). Rozlišení pochází z cache metadat, která se asynchronně plní z hlaviček obrázků, aby se rozhraní neblokovalo. Odebírá se typickým macOS swipe-delete (přejetí trackpadem doleva na řádku); seznam nezná výběr řádku, takže smazání klávesnicí zde neexistuje. Poznámka: rozšířená cesta mazání obrázků s explicitním tlačítkem minus, Backspace a Cmd-Z pro vrácení zpět byla doplněna pouze v expert režimu v Project Navigatoru — v režimu pro začátečníky zůstává jen swipe-delete.

KDE

Pod seznamem obrázků, nad tlačítkem Clear All.

TECHNICKY

Tři po sobě jdoucí prahové hodnoty založené na počtu importovaných obrázků (aktivní pouze pokud jsou obrázky přítomny a nejde o video): - < 3 obrázky: červený banner (red octagon), text „At least 3 images are required. Camera alignment cannot be computed from fewer images." - 3–9 obrázků: červený 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 obrázků: oranžový banner (warning triangle), text „Workable, but quality usually improves with 20+ images and good coverage around the scene."

Od 20 obrázků banner zmizí. Prahové hodnoty jsou napevno zakódované a vycházejí z empirických experimentů s více než 560 tréninky.

KDE

Při dropu složky — žádné viditelné tlačítko, ale logika rozpoznávání.

TECHNICKY

Při dropu adresáře se kontroluje, zda se v něm nachází jedno ze tří kanonických rozvržení workspace: sparse/0/cameras.bin, sparse/cameras.bin nebo přímo cameras.bin v kořeni. Pokud ano, standardní enumerace obrázků se přeruší a místo toho se otevře modální upozornění, které se uživatele zeptá, zda se má použít existující rekonstrukce, nebo zda mají být obrázky znovu poslány přes Apple Photogrammetry. Stejná cesta platí i pro textové formáty workspace (cameras.txt) a exporty ETH3D. Podrobnosti viz kapitola 9, Backend Q6. Funguje stejně v režimu pro začátečníky jako v expert režimu.

KDE

Pozadí přes celou plochu za kruhem průběhu, skryté při přerušení nebo chybě.

TECHNICKY

Dekorativní animace, která podle postupu pipeline (0…1) vykresluje rostoucí počet malých animovaných částic splatů. Zdrojem je vypočtená hodnota průběhu, která mapuje fáze SfM na 0–0.2 a trénování na 0.2–1.0 (kvalita snímků na 0–0.05). Díky tomu se splaty viditelně „budují", zatímco trénování probíhá. Jde čistě o dekoraci — zobrazení neukazuje skutečné mezivýsledky aktuálního trénování (to by byl živý náhled v Expert módu). Při Cancel nebo selhání se skryje a zůstane viditelný pouze stavový kruh.

KDE

Uprostřed obrazovky zpracování, 220 × 220 pixelů.

TECHNICKY

Dva na sebe vykreslené prstence: vnější tlumený prstenec dráhy, vnitřní vyplněný prstenec průběhu s akcentovým nebo červeným tahem (červený při chybě). Prstenec přímo sleduje skutečný průběh aktuální fáze (plynule přes krátkou animaci prolnutí), aby zobrazení odpovídalo řádku průběhu v Expert módu. Uvnitř kruhu je ikona fáze (mozek pro trénování, kamera pro SfM, film pro extrakci snímků z videa, jiskřičky pro kontrolu kvality snímků, glóbus pro rozbalování 360° materiálu), název fáze a číslo průběhu. Toto číslo je během trénování počítadlo iterací („12 500/20 000"), ve všech ostatních fázích procento. Ikona jemně pulzuje, dokud zpracování probíhá. Při chybě se název přepne na fázi, která selhala („Structure from Motion Failed", „Training Failed"), prstenec i číslo zčervenají. Po přerušení kruh místo toho zobrazí oranžový křížek s „Cancelled!".

KDE

Vlevo nahoře na obrazovce zpracování, 32 × 32 pixelů.

TECHNICKY

Jednoduché tlačítko s materiálovým pozadím. Zapíná nebo vypíná informační panel. Ikona se při aktivaci mění mezi obrysem info-kruhu a vyplněným info-kruhem. Jemná animace prolnutí. V tooltipu „Show detailed processing metrics".

KDE

Vlevo dole na obrazovce zpracování, viditelný pouze pokud jsou zobrazeny podrobnosti zpracování.

TECHNICKY

Dvousloupcový panel s ultra tenkým materiálovým pozadím. Levý sloupec: řádky informací specifické pro fázi — pro SfM stavový text a procento; pro trénování iterace, kombinovaný loss, L1-loss, D-SSIM-loss, počet Gaussianů (zbarvený oranžově), rychlost (it/s), uplynulý čas, vypočtené ETA, SH-Degree a learning rate. Pravý sloupec: stavový text, řetězec s časovou informací, vložený graf loss (viz C-28) a nudge pro objevitelnost (viz C-32). Všechny hodnoty se čtou ze stavu trénování, který se aktualizuje při každém tiku trénování.

KDE

Spodní navigační lišta, viditelná pouze během fáze trénování (NE během SfM) a dokud zpracování probíhá.

TECHNICKY

Tlačítko s rámečkem. Podle stavu volá Pause nebo Resume. Popisek se mění mezi „Pause" (s ikonou pauzy) a „Resume" (ikona přehrávání). Během kroku SfM se tlačítko nezobrazuje, protože Apple Photogrammetry nezná sémantiku pauzy. Stav pauzy zachovává kompletně iteraci, stav Gaussianů a momentum optimalizátoru — Resume pokračuje přesně tam, kde bylo předtím zastaveno.

KDE

Spodní navigační lišta, viditelná zatímco zpracování probíhá (SfM nebo trénování).

TECHNICKY

Červené tlačítko s rámečkem. Otevře potvrzovací dialog s titulkem „Stop and discard progress?", tlačítky „Discard Progress" (destruktivní) a „Keep Running" (Cancel). Po potvrzení se nastaví příznak Cancel, ukončí se úloha trénování, případně ukončí subproces SfM a do JSONL logu se zapíše souhrnný řádek se stavem přerušení. Na rozdíl od Pause se buffer trénování a stav zahodí.

KDE

Spodní navigační lišta, viditelná pokud pipeline selhala (stav SfM začíná s „SfM failed" nebo je trénování ve stavu chyby).

TECHNICKY

Akcentové tlačítko. Znovu spustí celou pipeline. Před spuštěním se ověří, zda jsou stále k dispozici importované obrázky/videa. Předchozí logy chyb zůstávají zachovány v adresáři JSONL; nový běh zapíše nový logovací soubor s aktuálním časovým razítkem.

KDE

V informačním panelu, pravý sloupec, viditelný pouze během trénování s neprázdnou historií průběhu.

TECHNICKY

Kompaktní kreslicí plocha (40 pixelů vysoká), vykresluje historii loss jako linku o tloušťce 1 pixel v akcentové barvě. Data se filtrují na konečné hodnoty (ochrana proti NaN u nestabilního trénování). Min/Max se počítají za celou historii — graf se tedy automaticky přizpůsobuje rozsahu hodnot. Poslední hodnota loss je uvedena vpravo nahoře nad grafem. Samotná historie se buduje ve stavu aplikace při každém tiku trénování (typicky každých 100 iterací).

KDE

V informačním panelu, pravý sloupec dole, viditelný pouze během trénování A v režimu pro začátečníky.

TECHNICKY

Malý řádek s ikonou oka a popiskem „Switch to Expert Mode (⌘2) for live splat preview", v tlumeném odstínu a 10bodovém písmu. Žádný interaktivní prvek, jen upozornění. Nereaguje na kliknutí — uživatel musí skutečně stisknout Cmd+2 nebo kliknout na menu Mode → Expert Mode.

KDE

Celoobrazovkové pozadí kroku náhledu.

TECHNICKY

3D viewport založený na Metalu, vykreslující hotový bod-mrak. Renderer je VLASTNÍ ForwardPass rasterizér RadianceKitu — stejný, který vykresluje splaty už během tréninku — tedy skutečný WYSIWYG (co se trénuje, se přesně tak zobrazuje a exportuje). Dlaždicově založená render pipeline s Order-Independent Transparency. Pokud se renderer nepodaří inicializovat (např. protože Metal na systému není k dispozici), zobrazí se místo toho černé pozadí s textem „Metal not available". Zobrazení ignoruje bezpečnou zónu (safe area), takže model sahá až k okraji okna.

KDE

Nad viewportem, plovoucí: dvě ikonová tlačítka vlevo nahoře, pod nimi vlevo dole informační panel.

TECHNICKY

Překrytí se skládá přesně ze dvou tlačítek: „Scene Info" zapíná a vypíná informační panel vlevo dole, druhé přepíná režim kamery mezi „Orbit" (kroužení kolem cílového bodu) a „Fly-Through" (volný let). Informační panel zobrazuje snímkovou frekvenci, počet Gaussianů, režim kamery, zorný úhel, rozlišení vykreslování a vzorkování; během probíhajícího tréninku přibude řádek se stavem tréninku, po jeho skončení řádek s dokončením. Neúspěšné nebo probíhající načítání scény se zobrazuje jako vlastní stavový řádek nezávisle na přepínači informací. Automatická rotace, reset kamery, barva pozadí a snímek obrazovky nejsou tlačítka překrytí, ale položky v menu „Viewport".

KDE

Spodní navigační lišta v Z3.

TECHNICKY

Akcentované tlačítko s popiskem „Export" a ikonou sdílení. Klik spouští přechod na Z4. Předtím nadřazené zobrazení zkontroluje, zda je odemčena plná verze — pokud ne, místo exportní fáze se zobrazí uzamykací obrazovka (viz U-06).

KDE

Levá hlavní strana kroku exportu.

TECHNICKY

Mřížka karet se dvěma flexibilními sloupci a 12 body odsazení. Iteruje přes formáty nabízené v režimu pro začátečníky — filtrovanou podmnožinu celého seznamu formátů, obsahující jen 6 nejdůležitějších formátů: PLY, SPZ, glTF, .splat, Orbit Video, Web Viewer. Ostatní formáty jsou nabízeny pouze v Expert režimu.

KDE

Každá karta v mřížce.

TECHNICKY

Jednoduché tlačítko s uspořádáním karty: ikona (např. zip-dokument pro PLY, archivní krabice pro SPZ, ikona videa pro Orbit Video) nahoře, název formátu jako nadpis, popisný text (zkrácený na 2 řádky), pod tím odhadovaná velikost souboru (počítaná naživo z formátu, počtu Gaussianů a stupně SH a formátovaná jako KB/MB). Kliknutím se formát vybere. Vybraná karta dostane akcentové pozadí, akcentový rámeček a ikonu fajfky vpravo nahoře. Tooltip je popis formátu.

KDE

Pod mřížkou formátů, viditelný pouze pokud je zvolen video formát (Orbit Video nebo Social Video).

TECHNICKY

Posuvník 3–30 sekund v krocích po 1 sekundě, je navázán na délku videa ve stavu aplikace. Maximální šířka 300 bodů. Zobrazí se pouze, pokud je vybraný video formát. U nevideo formátů je posuvník úplně odstraněn z pohledu — žádné mrtvé místo.

KDE

Pod mřížkou formátů (a pod posuvníkem délky, pokud je zvoleno video).

TECHNICKY

Velké akcentové tlačítko. Popisek: „Export {Format-Name}", symbol sdílení. Kliknutím se otevře dialog uložení macOS s příponou souboru odpovídající formátu. Navrhovaný název souboru pochází z názvu aktuální scény; pokud žádný není nastaven (např. protože scéna ještě nikdy nebyla uložena), zní „scene". Po potvrzení se export zapíše na zvolené místo. Deaktivováno, pokud není k dispozici výsledek tréninku nebo export již běží. Pod tlačítkem stojí ukazatel výsledku („2.991 Gaussians • SH degree 3").

KDE

Pod tlačítkem Export, viditelný pouze během probíhajícího exportu.

TECHNICKY

Ukazatel průběhu s maximální šířkou 300 bodů, pod ním popisek „Exporting… N %". Hodnota jde od 0 do 1 a aktualizuje se během zápisu — u PLY po dávkách 10 000 Gaussianů, u SPZ jednorázově po kvantizaci, u Orbit Video po intervalech snímků.

KDE

Pod ukazatelem průběhu, viditelné pouze pokud při posledním exportu došlo k chybě.

TECHNICKY

Červený řádek s výstražným trojúhelníkem a textem „Export failed: …" spolu s popisem chyby. Červené pozadí s 8 % krytím, zaoblené rohy. Maximální šířka 400 bodů. Časté příčiny chyb: chyba zápisu při plném diskovém prostoru; chyba sandboxu při cílech uložení mimo povolenou oblast.

KDE

Pravá strana kroku exportu.

TECHNICKY

Seznam historie exportů (trvale uložený v nastavení aplikace, aktualizovaný po každém úspěšném exportu). Každý řádek zobrazuje odznak formátu (malý, akcentové barvy), časové razítko (HH:mm), název souboru (zkrácený na 1 řádek) a formátovanou velikost souboru. Klik na řádek otevře Finder s vybraným souborem. Prázdný stav: „No exports yet".

KDE

Kliknutí pravým tlačítkem na řádek historie.

TECHNICKY

Kontextové menu na každé položce seznamu se dvěma akcemi: „Reveal in Finder" (otevře Finder s vybraným souborem, stejně jako jednoduché kliknutí) a „Copy Path" (uloží celou cestu k souboru jako text do schránky). Druhá je užitečná pro přetažení do jiných aplikací nebo předání do příkazové řádky.