časť 52
Obrázok z jednej partie: z nápadu na hotovú funkciu
Hra vie z dohratej partie nakresliť obrázok na tlač: dvanásť variantov, živý obrázok a odtlačok mapy. Ako sa záznam stane obrázkom, prečo je rovnaký v každom prehliadači a čo sa pri tom zistilo, aj čo sa dnes nezopakovalo.
Skladba z jednej partie má vlastný článok, obrázok z nej ho zatiaľ nemal. Článok o zázname, analýze a skladbe o ňom nehovorí a v článku Vtedy a dnes má jeden oddiel s dvoma snímkami okna. Pritom od 20. októbra uplynulo sedemnásť dní a hra (verzia 0.124.0) má okno Obrázok hry, dvanásť variantov, živý obrázok počas hry a odtlačok mapy.
Článok vysvetľuje, ako sa z jednej partie stane obrázok, prečo je ten istý v každom prehliadači a čo sa pri tom zistilo. Obrázky vyrobili nástroje hry zo skutočnej partie, nie ruka. Je to partia zo skladby (Kniežatstvá, štyria hráči, seed CLS4, dvanásť kôl, 140 útokov), takže jeden záznam sa tu aj tam rozpráva dvakrát. Partiu odohrala AI na mieste hráča, hráč Ty (červený) ju vyhral.
Od nápadu k hre
Nápad vznikol 20. októbra: keď sa z partie robí hudba, dá sa z nej robiť aj obrázok, len „projekcia záznamu“, vektorový, na vytlačenie a uloženie; neskôr pribudol dodatok, že sa môže kresliť aj počas hry, ale vypnuté a len pre silný počítač. Čo z toho zostalo a čo nie:
| Nápad z 20. 10. | Dnes v hre | Stav |
|---|---|---|
| Pamiatka na tlač: vektor, ktorý sa dá uložiť | SVG v milimetroch; v okne len A4 na výšku a na šírku, tlač je jedna strana; iné formáty sa stiahnu ako SVG | splnené, formáty zúžené |
| Rastúce kruhy, strom, vnorené štvorce, štvorec pre každého hráča | Kruhy, Rámy, Panely, Prekrývajúce sa štvorce (každé v dvoch smeroch), Les, Prúd, Súhvezdie a Odtlačok mapy | splnené, dvanásť variantov |
| Kreslí sa aj počas hry, predvolene vypnuté | Nastavenie Živý obrázok, predvolene Vypnutý, so strážou | splnené |
| Jedno tlačidlo, ktoré dá obrázok aj skladbu | Dve tlačidlá, Obrázok a Hudba; okno Hudba kreslí obrázok, ktorý s hudbou rastie | nevyšlo |
| Najslabšie varianty zrušiť alebo skryť | Panely (najslabšie) a prekrývanie (zakalené) navrhla zrušiť nezávislá kontrola a skryť odporúčanie z 22. 10.; rozhodnutie z 20. a 22. 10. bolo ponechať ich a okno ponúka všetkých dvanásť | ponechané |
| Jeden veľký strom, štvorce posunuté k vedúcemu | Nepostavené | nevyšlo |
Od záznamu k obrazu
Obrázok sa kreslí zo záznamu: tým istým prehraním, ktoré robí záznam hry vo formáte 2 pre analýzu a skladbu. Nič sa neukladá: obrázok sa robí na požiadanie a záznam, aj z odkazu, stačí na to, aby sa nakreslil. Cesta má šesť krokov.
Node.- Zberač je jediné, čo číta hru. Má 142 riadkov (
picture-collect.js), prehranie záznamu mu posiela udalosti a on z nich robí fakty: čisté čísla o začiatku, útokoch, rozmiestnení kociek, uzavretých kolách a konci. Všetko pod ním pracuje len s číslami a o kockách či pravidlách nevie nič. Článok o architektúre to volá „fakty hotovej partie“ a dodáva, že obraz, hudba a analýza čítajú prúd udalostí prehrania. Mapu dosky zberač pridá len na požiadanie, keď variant mapu potrebuje. - Scéna sa len pridáva. Je to zoznam primitív (čiara, mnohouholník, oblúk, text) so stabilným menom z identity:
r1.a0je oblúk hráča 0 v kruhu 1. kola,m42značka útoku s číslom udalosti 42 ac5.3trhlina hráča 3 v kruhu 5. kola (hráč 3 vypadol v 4. kole, trhlina prechádza každým ďalším kruhom). Pridanie udalosti môže primitíva pridať, žiadne nezmení ani nepresunie, a kolo sa nakreslí, keď sa uzavrie. - Kamera je zvlášť a príde až na konci: mierka a posun, ktoré obrázok zmestia na papier. Rozloženie sa po nej nepočíta znova.
- Zapisovač napíše SVG v milimetroch, v podmnožine, ktorú strážca (
Picture.lint) kontroluje: žiadny filter,<pattern>ani skript. Tri spôsoby slov, štyri atramenty (pozri nižšie).
Jedno poctivé obmedzenie: varianty, ktoré idú od okraja dnu, a panely potrebujú dĺžku partie (prvé kolo je najvonkajší kruh), takže ich scéna je do konca partie prázdna.
Ten istý obrázok v každom prehliadači
Rovnaký záznam, variant, voľby a Picture.VERSION dajú rovnaký SVG, bajt po bajte. Pre tlač je to pohodlie, pre živý obrázok podmienka (nižšie) a pre test výhoda: stačí porovnať odtlačky. Ako sa to dosiahlo:
- Rozloženie počíta len sčítaním, odčítaním, násobením, delením a odmocninou. Uhly nedáva
Math.sin, ale tabuľka 1 025 čísel zapísaných priamo v súbore, medzi ktorými sa interpoluje. (Prečo: základné operácie a odmocninu norma IEEE 754 predpisuje presne, kým sínus môže mať v inom prehliadači inú poslednú číslicu. Je to vysvetlenie pravidla, nie meranie.) - Náhoda je odtlačok identity. Vlnenie okraja, strana konárika a miesto značky sú celočíselný odtlačok (haš) identity prvku a seedu hry, nie prúd čísel, ktorý sa míňa v poradí príchodu: pridaná udalosť preto nemôže zmeniť skorší prvok.
- Každé číslo v súbore zaokrúhľuje jedna funkcia na 0,01 mm, bez
-0, exponentu aNaN. - Zdrojový lint je test, ktorý číta súbory
picture*.jsa zakáže mocninu**,Date,Intl, časovače,toFixedatoLocale*; zMathpovolí lenfloor,ceil,round,min,max,abs,sqrt,imul,trunc,signaPI. Prvá verzia sa dala obísť (Math['sin'],const M = Math); nezávislá kontrola to našla a lint dnes prechádza kód po znakoch, zoznam povolených funkcií je jediná cesta a test skúša 21 zlých zápisov vrátane obchádzok. - Zlaté odtlačky:
tests/…/picture-golden.jsondrží 174 odtlačkov: dvanásť zlatých záznamov vo všetkých dvanástich variantoch, k tomu iné papiere a atramenty, plagáty a obrázky s vymyslenou príbehovou vrstvou. Pri zmene výstupu test hlási, že treba zvýšiťPicture.VERSIONa zapísať odtlačky znova.
Verzia je dnes 5. Verzia 2 prišla, keď nezávislá kontrola okna našla, že remíza sa na plagáte počíta ako výhra; verzie 3 až 5 sú zmeny mena hry na hárku.
Čo sa dnes overilo. Výstup sa zo záznamu CLS4 vyrobil vo všetkých dvanástich variantoch a dvoch atramentoch (farby a sivé) raz v Node a raz v prehliadači Chromium 152 z panelu Browser, s tými istými súbormi hry (rng.js, data/picture.js, core/picture.js). Všetkých 24 SVG je bajt po bajte rovnakých (SHA-256 aj dĺžka). Zlaté odtlačky a ostatné testy obrázka dnes prešli: 180 testov v súbore s odtlačkami a lintom a 70 v súboroch odtlačku mapy, živého obrázka a okna. Kontroly v prehliadači, ktoré hra opisuje, používajú Chromium.
Čo to stálo a čo dalo. Stálo: tabuľku, strážcu a pravidlo, že pri každej zmene výstupu sa píše nová verzia. Dalo: živý obrázok sa dá porovnať s obrázkom záznamu bajt po bajte. Takýto test našiel chybu, ktorá by inak unikla: prvý prívod živých udalostí počítal len svoje udalosti, a tak sa značky volali m4, kde finálny obrázok má m5. Bol to iný obrázok.
Dvanásť obrázkov z jednej partie
Rovnaká partia, dva spôsoby: kruhy hovoria, kto kedy rástol, mapa hovorí, kde.
Názvy sú také, ako ich hráč uvidí v okne. Poznámky v tabuľke sú verdikty z dokumentácie hry (20. a 22. 10.), nie dnešné meranie:
| Názov v okne | Čo ukazuje | Slabina | Živý |
|---|---|---|---|
| Kruhy, od stredu von / od okraja dnu | kolo je kruh, rozdelený podľa podielu políčok; vyradenie je trhlina | pri sto kolách veľmi hustý | von áno, dnu nie |
| Rámy, od stredu von / od okraja dnu | to isté v štvorcoch, ako tunel | hlasné | von áno, dnu nie |
| Panely, dovnútra / von | hráč má vlastný štvorec, dobré na porovnanie | najslabšie ako obraz: samé prázdne rámy s krížikom | nie |
| Prekrývajúce sa štvorce, von / dovnútra | rozeta štvorcov | v strede zakalené, v čiernobielom pri prehre nečitateľné | oba áno |
| Les | strom pre každého hráča, konárik s listom za vyhraný útok | pri 14 hráčoch drobný | áno |
| Prúd | podiely políčok v čase, stĺpec na kolo | skôr graf než obraz | áno |
| Súhvezdie | hviezda pre hráča, väzby za zabrané políčka | pri 2 až 4 hráčoch riedke | áno |
| Odtlačok mapy | skutočná doska, políčka v pruhoch času | váži čas, nie územie | áno |
Z partie CLS4 má scéna 32 (prekrývajúce sa štvorce) až 290 primitív (odtlačok mapy) a SVG 7,8 až 47,6 kB. Osem z dvanástich variantov je živých.
Kým sa vzhľad hľadal, vyskúšalo sa a zavrhlo viac vecí: prvé kruhy striedali dva odtiene ako holičský stĺp, prvé panely nehovorili nič (hrúbka pásu nenesie podiel), a pri odtlačku mapy vyhrali pruhy nad prstencami v každom políčku: prstence sú krajšie (terč s posledným majiteľom v strede), no dávajú menej než polovicu časového rozlíšenia a v čiernobielej tlači sa nedajú vyškrafovať.
Odtlačok mapy
Odtlačok kreslí skutočnú dosku: každé políčko je rozrezané na zvislé pruhy podľa času (začiatok partie vľavo, koniec vpravo) vo farbe toho, kto ho držal, a čiary medzi políčkami sú hrubšie podľa počtu útokov, ktoré cez ne prešli, takže vidno fronty.
Háčik: fakty nenesú majiteľa políčka, len počty (koľko políčok má kto). Majitelia sa preto rátajú z útokov: začína sa majiteľom pred prvým útokom a každý vyhraný útok dá políčko útočníkovi. Takto vyzerá jedno políčko tejto partie.
V 1. kole prešlo políčko trikrát z ruky do ruky (Žltý, Modrý, Zelený a znova Žltý) a na konci kola ho držal opäť pôvodný Žltý, takže prvé kolo vlastný pruh nemá. V dlhej partii sa kolá zlučujú do najviac 24 pruhov na políčko a pruh dostane ten, kto políčko v ňom držal najdlhšie, okrem prvého a posledného: prvý je vždy pôvodný majiteľ a posledný konečný, lebo pravý okraj obrázka je výsledná doska a to je jediné, čo čitateľ kontroluje. Dokumentácia to zapisuje ako zámernú odchýlku od zadania.
Dôkaz proti skutočnej doske. picture.js --map-proof zahrá partie AI s náhodnými nastaveniami (každý tvar, typ mapy, jazerá, neutrálne políčka, pevnosti a mestá, Kniežatstvá, voľná hra a denná výzva), po každom kole porovná majiteľa každého políčka v živej hre s prepočtom z útokov a skontroluje, že každý útok leží na hranici dvoch políčok.
| Beh | Hier | Riadkov dosky | Políčok | Útokov |
|---|---|---|---|---|
| 22. 10., prvé meranie | 289 | 10 589 | 21 231 | 118 667 |
| 22. 10., po zlúčení | 269 | 9 303 | 19 687 | 111 165 |
| 6. 11., dnes (22 s) | 269 | 9 399 | 19 704 | 113 329 |
Rozdiel nebol v žiadnom riadku, žiadnom behu. Počet hier sa líši, lebo z 700 pokusov sa použije len časť (ostatné nenechajú záznam, ktorý sa dá prehrať) a po zmenách hry sú náhodné partie iné; podľa dokumentácie to bolo tak aj po zlúčení 22. 10. Dnešný beh pokryl sedem tvarov dosky, päť typov mapy (pôvodne boli štyri), 195 hier s jazerami, 200 s neutrálnymi políčkami a 241 s pevnosťami alebo mestami.
Živý obrázok
Obrázok sa môže kresliť aj počas hry: v nastavení Živý obrázok (predvolene Vypnutý; Zapnutý sa odporúča „pre silný počítač“) sa pri doske otvorí malé okno, v ktorom obrázok rastie po kole. Dá sa zapnúť aj uprostred partie: obrázok sa dorobí zo záznamu dovtedy. Nekreslí sa v hre s hmlou vojny (zberač číta celú mapu, takže by obrázok ukázal, čo hráč nesmie vidieť), v hlavolame, lekcii, minihre ani v misii kampane. Osem variantov je živých (tabuľka vyššie); tie, čo potrebujú dĺžku partie, sa nakreslia až po nej.
Ochrana je súčasť hry a jej čísla sú dáta: obrázok sa sám vypne (a vypne sa aj nastavenie), ak hru spomaľuje. Zastaví ho aktualizácia nad 16 ms tri razy za sebou, jedna nad 50 ms, viac než 8 000 primitív alebo chyba pri kreslení, a hráč dostane jedno oznámenie. Odtlačok mapy sa kreslí po každom kole znova (pruhy závisia od dĺžky partie, ktorú živá hra nepozná), a preto má vlastné limity: 45 ms trikrát za sebou a 140 ms raz.
| Čo | Hodnota | Zdroj |
|---|---|---|
| Aktualizácia živého obrázka, ktorý len pridáva primitíva | 0,6 až 0,9 ms; so 4-krát pomalším procesorom 1,6 až 2,8 ms, najhoršia 12 ms | dokumentácia, 21. 10., Chromium |
| Živý odtlačok mapy po kole, partia troch hráčov | 6,9 ms, najhoršia 11,7 ms | dokumentácia, 22. 10., Chromium |
| To isté dnes, živé okno hry | 5,1 ms, najhoršia 5,5 ms | --map-browser-check, 6. 11., Chromium bez okna |
| Odkrytie 13 kôl odtlačku mapy v okne Hudba (300 trojuholníkov, 14 hráčov) | 29 ms, najhoršia 35 ms; so 4-krát pomalším procesorom 99 a 107 ms (dokumentácia). Dnes 18 a 20 ms, so 4-krát pomalším procesorom 63 a 72 ms | --map-browser-check |
| Dnes, partia CLS4 (4 hráči, 12 kôl), udalosti kola | medián 0,1 ms, najhoršia 2,3 ms; odtlačok mapy s prekreslením 1,1 a 2,8 ms | Chromium 152 v paneli Browser, bez spomalenia procesora |
| Dnes, 14 hráčov a 57 kôl, udalosti kola | medián 0,1 až 0,2 ms, najhoršia 2,1 ms; odtlačok mapy s prekreslením 2,9 ms, najhoršia 11,3 ms | to isté |
Posledné dva riadky sú výpočet obrázka bez kreslenia do stránky a bez spomalenia procesora, takže s tými starými sa dajú porovnať len hrubo. Aj najhoršia hodnota odtlačku mapy (11 ms) je ďaleko pod jeho limitom 140 ms, ale k nemu patrí aj kreslenie; kontrola v prehliadači ho obsahuje a vyšla pod hranicami.
Brány a kalibrácia
Obrázok nehodnotí človek každý raz, a tak ho meria kontrola: picture.js --check zahrá 60 partií AI (2 až 14 hráčov, každý tvar, tímy, hmla, 3 až 100 kôl) a siedmich okrajových prípadov, nakreslí ich vo všetkých dvanástich variantoch na troch papieroch a štyroch atramentoch a pre každý obrázok skontroluje brány: koľko papiera pokrýva atrament (25 až 85 %), koľko čiar prechádza jednou bunkou (zamotanosť), najtenší pás (aspoň 0,4 mm), vyváženie, veľkosť súboru (500 kB) a platnosť SVG.
Prvý beh s limitmi zo zadania mal 878 porušení z 1 809 obrázkov (podľa dokumentácie hry). Každá brána sa potom menila až po pohľade na najhoršie obrázky a štyri veci sa opravili v návrhu, nie v prahu: značky sa rozložili pozdĺž oblúka, okraje dlhej partie sa riedia podľa kruhu, trhliny sa spájajú a prekrývajúce sa štvorce sa riedia. Zamotanosť s kolami prirodzene rastie, preto brána rastie s nimi.
Pevná hranica 8 z prvého návrhu by neprešla 11 partií zo 60; rastúca hranica nenechá prekročiť žiadnu, najbližšia je partia s 11 kolami: 7 proti hranici 10,4. Je teda voľná a dokumentácia to priznáva: sú to kalibrované hranice, nie ostré stráže. Poučenie, ktoré tam stojí: na zlý obrázok sa neodpovedá zmenou prahu bez pohľadu na najhoršie.
Dnes kontrola nie je zelená. Beh 6. 11. (84 s, 9 648 obrázkov a 19 296 s kľúčom bez slov alebo bez textu) hlási šesť porušení jednej brány, veľkosti súboru: partia s 14 hráčmi a 76 kolami na papieri A3 v sivých a čiarových atramentoch má 502 až 515 kB proti hranici 500 kB. Dokumentácia hry píše, že každý obrázok prejde. A3 okno neponúka, takže hráč na to nenarazí, no kontrola, ktorá má byť zelená, zelená nie je.
Okno a tlač
Okno Obrázok hry sa otvára tlačidlom Obrázok na koncovej karte hry, v zozname posledných hier a v prehrávači záznamu (aj záznamu z odkazu alebo súboru). Záznam starého formátu sa nedá nakresliť a okno to povie.

Voľby: Obrázok (dvanásť variantov), Farby (Farby hry, Paleta pre farboslepých, Sivé s vzorkami pre čiernobielu tlačiareň, Iba čiary), Papier (A4 na výšku, A4 na šírku), Slová, názov a popis, mená hráčov, seed s tlačidlom Iný hod a voľba Označiť zlomové body hry z analýzy partie. Obrázok vedľa je presne ten SVG, ktorý sa uloží (test porovnáva bajty).
- Slová majú tri spôsoby: slová (názov, výsledok, mená hráčov), farebný kľúč (žiadne slovo, len farebné štvorčeky, hviezdička pri víťazovi a čísla) a žiadne (iba obrázok). Víťaz je vždy vidieť aj z obrázka.
- Sivé s vzorkami: po prevode do sivej by sa farebný hárok s ôsmimi hráčmi zlial do podobných sivých (modrá, zelená, oranžová a tyrkysová dali skoro tú istú), kým verzia Sivé s vzorkami ich rozlíši sivou, šrafovaním a čiarkovaním (pohľadom, 20. 10.).
- Uložiť a Vytlačiť: dnes sa to skúsilo v skutočnom prehliadači (
--map-browser-check, 35 s, Chromium bez okna, odtlačok mapy): Uložiť SVG dá presne ten istý hárok (74 766 B), Uložiť PNG obrázok 2 480 × 3 508 bodov (A4 v 300 dpi) a Vytlačiť jednu stranu 594,96 × 841,92 bodu (A4 má 595 × 842). Okno sa pri 375 px aj 1 100 px zmestí vo svetlej aj tmavej téme a hárok je vždy biely papier. - Plagát posledných hier: z posledných hier (profil drží 20 záznamov) sa vyberie, čo sa dá na jeden hárok; najnovších deväť je zaškrtnutých, plný kruh pod obrázkom je výhra a prázdny prstenec prehra. Remíza sa nepočíta ako výhra.
Obrázok, ktorý s hudbou rastie, má aj okno Hudba po hre (skladba z jednej partie).
Poctivé obmedzenia
- Obrázok nie je analýza. Ukazuje podiely políčok po kolách a výber útokov, nie prečo sa partia rozhodla. To robí analýza; do obrázka sa dostane len nepovinnou vrstvou zlomových bodov.
- Odtlačok mapy váži čas, nie územie. V dlhej partii, v ktorej sa bojuje všade, nemusí byť víťazova farba tá, čo obrázku dominuje. Víťaza ukazuje okraj okolo dosky a hviezdička v legende.
- Brány merajú tvar, nie krásu. O tom, či je obrázok pekný, rozhodoval ten, kto sa naň pozrel; kontrola povie len, že papier nie je zamotaný ani prázdny.
- Partia s hmlou vojny má obrázok až po hre, živý sa v nej nekreslí.
- Nezopakovalo sa: kontrola všetkých dvanástich variantov na všetkých papieroch a atramentoch v prehliadači (
--browser-check, tlač do PDF, sedem papierov); z dnešnej kontroly platí len pre odtlačok mapy. - Zostalo otvorené (dokumentácia hry): značka na prvom a poslednom políčku hráča, vyznačenie políčok hráča Ty, mapa tímov, spoločné okno pre obrázok a skladbu a rozhodnutie o paneloch a prekrývaní, ktoré sa ponechali „zatiaľ“.
Čo si z toho odnášam
- Čistá funkcia záznamu sa dá otestovať bajt po bajte a z toho plynie veľa: obrázok sa neukladá, živý je obrázkom záznamu, zmena výstupu je viditeľná.
- Odtlačky pripínajú bajty, nie zmysel. Osem zmien významu (okraj víťaza, koruna, „vyradený v kole N“) prežilo, keď sa zlatý test vynechal; pribudlo 25 testov o význame.
- Na zlý obrázok sa neodpovedá zmenou prahu. Zo 878 porušení sa najprv opravil návrh a až potom sa menila brána.
- Dokumentácia a kód sa rozídu. Dnes má kontrola šesť porušení, verzia obrázka je 5 a nie 2 a vzorky v
docs/picture/sú zo starých verzií.
Zdroje a poznámky
- Stav a história: hra 0.124.0 (6. novembra 2026),
Picture.VERSION5. Rozhodnutia sú vdocs/DESIGN.mdhry, §37, a vdocs/ROADMAP.md, kapitola 19. - Dáta a merania: partia CLS4 z galérie obrázkov hry (
tools/charts-data/obrazok.json). Kontrola brán, dôkaz odtlačku mapy a zhoda v prehliadači sú dnešné behy nástrojov hry; časy sú medián z 15 behov. - Obrázky z nástrojov hry: dve varianty, hárok a rodiny kreslí
Picture.renderhry, ostatné grafytools/charts.js. - Nezhoduje sa: dokumentácia píše
Picture.VERSION2 a sedem živých variantov; kód má verziu 5 a dnes je živých osem.