časť 47
Náhľady v nastaveniach: hudba, živý obrázok a čísla
Posledný krok náhľadov, hudba a živý obrázok, pribudol 3. novembra 2026 (záznam zmien 0.102). Opisujeme ho z neskoršej verzie hry spolu s číslami stavby, pasciami a mutáciami.
Predchádzajúci článok o náhľadoch skončil krokom P5: hudba a živý obrázok čakali na funkciu, ktorá zahrá štyri takty, a rozhodnutie D10 ich odložilo. Krok sa postavil 3. novembra 2026 a je v zázname zmien ako verzia 0.102. Tento článok ho opisuje z neskoršieho stavu hry, z 16. novembra 2026 (verzia 0.190.2). Kde je dôležité, kedy ktorá časť pribudla, je to napísané v texte.
Článok obsahuje aj čísla stavby (register, odhad oproti skutočnosti), pasce a mutácie.
Prečo P5 čakala
Krok P5 sa v pláne volá „Hudba a živý obrázok“ a je označený ako voliteľný (SETTINGS-PREVIEW §5): tlačidlo ▶ Počúvať pre tri nastavenia hudby (štýl, hustota, hlasitosť) a príklad obrázka pre Živý obrázok. Potrebuje funkciu, ktorá zahrá štyri takty zvoleného štýlu, a tá v hre neexistovala: grep -rn audition js nenašiel nič (0 zásahov, 3. novembra 2026, nad hrou 0.97.1). Odhad v pláne je 1 až 1,5 dňa.
Prečo čakala: rozhodnutie D10 z 1. novembra odložilo hudbu do P5 a hlasitosť smela medzitým použiť tón. P5 teda nezlyhala, bola odložená vopred. Zvláštnosť: ani tón pre hlasitosť sa nepostavil, hoci D10 ho dovoľoval; hlasitosť čakala spolu s ostatnými. Čakali štyri nastavenia: livePicture, musicStyle, musicDensity, musicVolume. Z pôvodných 10 živých obrazov a 7 ukážok je teda postavených 9 a 4.
Hudba: ▶ Počúvať
Hudba mala tri nastavenia: štýl, hustotu a hlasitosť. Pri nich nebolo čo ukázať okrem zvuku. Tón pre hlasitosť sa nepostavil: hlasitosť ukazuje tú istú živú hudbu ako ostatné dve nastavenia.
Tlačidlo ▶ Počúvať patrí všetkým trom riadkom a prehrá štyri takty živej hudby zvoleného štýlu, hustoty a hlasitosti. Ukážka je tá istá živá hudba, akú by hra hrala pod efektmi, teda tichšie než samotný hudobný podklad, a nie tón ani pieseň po hre. Riadok hustoty ukáže počet nôt, riadok hlasitosti pridanie v decibeloch proti obvyklej hlasitosti.
Zvuk nikdy nezačne sám, len na klik. Prehrá sa, kým prebehnú takty. Zastaví sa tlačidlom Stop, pri zmene štýlu alebo hustoty (nová skladba je nové kliknutie), keď zvuk hry alebo jej živá hudba prevezme zvuk, keď sa panel prepne na riadok bez ukážky, a pri zatvorení okna. Hlasitosť sa sleduje, kým hrá, takže posuvník je spôsob, ako nájsť správnu úroveň. Tlačidlo je vypnuté a hovorí prečo, ak zvuk nejde: vypnutý zvuk v nastaveniach, prebiehajúca hudba hry (ukážka by zneli cez ňu) alebo prehliadač bez zvuku.

Overené je to testami na falošnom zvukovom kontexte: sleduje sa, čo sa naplánuje, aká je hlasitosť a kedy ukážka skončí. Zvuk v skutočnom prehliadači v tomto článku overený nebol.
Živý obrázok
Riadok Živý obrázok ukazuje vzorovú hru: záznam s 740 bajtmi, v ktorom tri sedadlá hrajú sedem kôl na malej mape a hráč vyhrá. Záznam sa prehrá tým istým zberačom, ktorý kreslí živý obrázok v hre, a obraz rastie kolo po kole. Pri zapnutom prepínači obraz rastie asi pol sekundy na kolo. Tlačidlo Ukáž nechá obraz rásť znova. Pri vypnutom prepínači je scéna prázdna a hovorí to. So zníženým pohybom systému je obraz hotový hneď.
V dokumentácii hry je údaj 600 bajtov. Kód má 740 bajtov a platí kód. Obrázok nie je obrázok bodiek z makety. Je to vlastný mechanizmus živého obrázka, takže náhľad a hra kreslia tým istým kódom.

Register: koľko riadkov má riadok
Pod „riadkami registra“ sa počítali dve veci: rozhodnutia v registri (riadky Settings.PREVIEWS) a hodnoty s riadkom pod panelom. Hodnota má riadok, ak Settings.captionOf nie je prázdne. Posuvník je jedna hodnota; Farba hráča má 14 hodnôt a Jazyk 10.
| Stav | Nastavení | Rozhodnutí v registri | Nakreslených | „Žiadna“ | Čakajúcich | Hodnôt s riadkom |
|---|---|---|---|---|---|---|
| pred prvým krokom (hra 0.80.1) | 23 | 0 | 0 | 0 | 0 | 50 z 88 |
| P1 | 23 | 23 | 4 | 4 | 15 | 55 z 88 |
| P2 | 24 | 24 | 9 | 4 | 11 | 75 z 90 |
| P3 | 24 | 24 | 13 | 4 | 7 | 87 z 90 |
| P4 | 24 | 24 | 16 | 4 | 4 | 87 z 90 |
| P6 (stav z 3. 11., pred P5) | 24 | 24 | 16 | 4 | 4 | 88 z 90 |
„Nakreslených“ je rozhodnutie so scénou a bez step, „čakajúcich“ rozhodnutie so step. Riadok P1 je commit kroku pred zlúčením s 0.81.2; vo verzii 0.82.2 mal register po zlúčení už 24 rozhodnutí. Na začiatku register neexistoval. Po P6 malo riadok 22 z 24 nastavení a chýbali len dve hodnoty z P5: „Živý obrázok: Vypnutý“ a „Hustota hudby: Normálna“. Dostali popisy v P5.
Po nastaveniach: pred prvým krokom malo riadok pre každú hodnotu 8 z 23 nastavení (6, ktoré vysvetľovali každú hodnotu, a 2 s nápovedou: Jazyk a Hlasitosť hudby) a 7 nemalo žiaden text; zhoduje sa to s konceptom č. 39. Z 38 hodnôt bez riadka na začiatku (88 − 50) dostalo riadok 36 a 2 ostávajú (vlastný výpočet). Dve hodnoty nového Pohybu avatara ho mali hneď. Za tým je 14 napísaných popisov: 13 z prílohy A analýzy a „Živá hudba: Vypnutá“ z P6. Sedem popisov je pre celé nastavenie a kryje 29 hodnôt (Farba hráča 14, Rýchlosť 4, Zvuk 2, Motív 3, Zobraziť čísla 2, Paleta 2, Avatar v rohu 2) a sedem pre jednu hodnotu (7 + 29 = 36). Počítal to jednorazový skript nad stromami js/ z git archive.
Koľko to stálo oproti odhadu
Odhad je zo SETTINGS-PREVIEW §3.4 a §3.6, skutočnosť je wc nad stromom hry vo verzii 0.97.1, teda pred hudbou a živým obrázkom. Súčty sú vlastný výpočet.
| Súbor | Odhad (riadky) | Skutočnosť (riadky) | Bajty |
|---|---|---|---|
js/ui/settings-preview.js | 220 | 302 | 21 130 |
js/ui/preview-board.js | 70 | 97 | 5 831 |
js/realms/kastgard/ui/previews.js | 90 | 321 | 21 769 |
js/realms/rokgard/ui/previews.js | 40 | 93 | 5 988 |
| spolu | 420 | 813 | 54 718 |
Skutočnosť je po riadkoch 1,94-násobok odhadu a po bajtoch asi 2,7-krát viac než odhadnutých „asi 20 KB“. Najviac vyrástol súbor Kastgardu, z 74 riadkov v prvom kroku na 321 (P3 pridal 191 riadkov, P4 54). Odhad vychádzal z makety; dokument neuvádza, v čom sa minul. CSS: odhad 60 riadkov, skutočnosť 91 pridaných. Texty: odhad 29 kľúčov, skutočnosť 31 kľúčov a 279 reťazcov v deviatich jazykoch. Súborov s testami bolo odhadnutých 2, sú štyri a majú 53 testov. ConfigPane ostal taký, aký bol: js/ui/config-pane.js má 53 riadkov a od stavu pred prvým krokom sa nezmenil.
Pasce zo stavby krokov
- Zložený kľúč textu neprejde testom kľúčov. Strážca fragmentov odmietne kľúč poskladaný z premennej (názov režimu v kľúči), preto sú tri štítky súbojov tri doslovné kľúče. Podobne musela byť veta pohlavia doslovný kľúč.
- Kľúč, ktorý číta len súbor cárstva, sa presunie do katalógu cárstva. Strážca potom hlási chybu. Kľúče ukážok Kastgardu sa píšu rovno pod
kastgard.previews. - Čísla kapitol v dokumentácii sa zrážajú. Kroky P3 až P6 niesli kapitoly 136 až 138, ale počas práce ich obsadila iná kapitola a pri zlúčení sa prečíslovali na 137 až 139.
Mutácie a testy
Testy krokov P3 až P6 sa napadli 84 mutáciami: kópia stromu, jedna zmena naraz a len testy tejto časti. Prvý beh nechal nažive 9 mutácií. Štyri boli diery v testoch: ukážka, ktorá by zmenila územie, sa nikdy nehľadala; upozornenie sa nikdy neskúšalo bez zostávajúceho útoku; šanca 60 % sa nikdy neskúšala; Hud.showRoll sa nikdy nemeral na čas. Po pinoch a ďalších testoch je 83 zachytených a jedna mutácia ekvivalentná. Mutácie merajú kvalitu testov, nie správnosť ukážok. Prvé celé overenie našlo ešte jednu vec: predpona textov previews patrila medzi miesta, ktoré lint rodov nečíta.
Krok P5 má vlastné testy: záznam ukážky sa pinuje testom (prehrá sa a je to, čo recept vyrobí), zvuk sa testuje na falošnom zvukovom kontexte.
Čo si z toho odnášam
- Zvuk nesmie začať sám. Tlačidlo je jediný spôsob, ako sa ukážka ozve, a test to pinuje.
- Obraz z vlastného mechanizmu hry je lepší ako napodobenina. Náhľad a hra kreslia tým istým kódom, takže nemôžu nesúhlasiť.
- „Existuje“ a „je pravda“ sú dva testy. Tvrdenie „každá hodnota má riadok“ našlo hodnotu, ktorú rozhodnutia nenašli.
- Mutácie ukážu diery v testoch. Z 84 prežilo prvý beh 9 a štyri boli skutočné medzery.
- Odhad z makety bol o niečo viac než polovica skutočnosti (420 z 813 riadkov, vlastný výpočet).
Zdroje a poznámky
- Dokumenty hry:
docs/SETTINGS-PREVIEW.md(krok P5 v pláne a v stave),docs/DESIGN.md§144 pre P5. - Záznam zmien: položka 0.102 (3. 11. 2026) s tlačidlom Počúvať a vzorovou hrou živého obrázka.
- Kód: scény
listenapicture(previews-music.js,previews-picture.js),audition.js; záznam ukážky má 740 bajtov. - Snímky hry z 16. 11. 2026, verzia 0.190.2. Ostatné čísla sú zo stavu 0.97.1, ak nie je uvedené inak.
- Súvisiace články: Náhľady v nastaveniach: čo je náhľad a ako sa stavia, Náhľady v nastaveniach.