Audamir

č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.

· 17 min čítania

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 hreStav
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 SVGsplnené, formáty zúžené
Rastúce kruhy, strom, vnorené štvorce, štvorec pre každého hráčaKruhy, Rámy, Panely, Prekrývajúce sa štvorce (každé v dvoch smeroch), Les, Prúd, Súhvezdie a Odtlačok mapysplnené, dvanásť variantov
Kreslí sa aj počas hry, predvolene vypnutéNastavenie Živý obrázok, predvolene Vypnutý, so strážousplnené
Jedno tlačidlo, ktoré dá obrázok aj skladbuDve tlačidlá, Obrázok a Hudba; okno Hudba kreslí obrázok, ktorý s hudbou rastienevyš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úcemuNepostavené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.

Ako sa záznam partie stane obrázkomSchéma šiestich krokov od záznamu k súboru SVG, s číslami jednej skutočnej partie (seed CLS4, 4 hráči, 12 kôl, 140 útokov). Záznam má 1 267 bajtov. Prehranie záznamu dá 212 udalostí. Zberač je jediné miesto, ktoré číta hru, a z udalostí urobí 182 faktov (140 útokov, 29 rozmiestnení kociek, 11 uzavretých kôl, začiatok a koniec), spolu 31 225 bajtov. Scéna je zoznam primitív, ktoré sa len pridávajú: 180 pre Kruhy a 290 pre Odtlačok mapy. Kamera scénu zmestí na papier a zapisovač napíše SVG: 47 620 bajtov pre Kruhy a 27 523 pre Odtlačok mapy.Záznamrozhodnutia1 267 bajtov: čo urobil každýhráč. Nič iné sa neukladá.PrehranieReplay.run212 udalostí: hra sa z rozhodnutíprehrá znova, nič sa nemení.Zberačpicture-collectJediné, čo číta hru: 182 faktov140 útokov, 29 rozmiestnení kociek, 11 kôl,začiatok a koniec; 31 225 B, z tohomapa dosky 9 339 B (62 ms s prehraním).ScénaPicture.buildZoznam primitív, ktoré sa lenpridávajú: 180 (Kruhy), 290 (mapa).Id z identity: r1.a0, m42, c5.3.(5,3 a 4,7 ms)KameraMierka a posun do papiera, až nakonci. Rozloženie sa nepočíta znova.ZapisovačPicture.svgSVG v milimetroch: 47 620 B (Kruhy),27 523 B (mapa) s textom A4;slová, farebný kľúč alebo nič;štyri atramenty (3,2 ms).
Partia principalities4 z galérie obrázkov hry: seed CLS4, Kniežatstvá, štyria hráči, 12 kôl, 140 útokov, výhra; Picture.build a Picture.svg, hra 0.124.0, 6. 11. 2026. Časy sú medián z 15 behov v jednom procese 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.a0 je oblúk hráča 0 v kruhu 1. kola, m42 značka útoku s číslom udalosti 42 a c5.3 trhlina 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 a NaN.
  • Zdrojový lint je test, ktorý číta súbory picture*.js a zakáže mocninu **, Date, Intl, časovače, toFixed a toLocale*; z Math povolí len floor, ceil, round, min, max, abs, sqrt, imul, trunc, sign a PI. 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.json drží 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.VERSION a 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.

Tá istá partia ako Kruhy a ako Odtlačok mapyJedna partia (partia CLS4 (seed CLS4): Kniežatstvá, štyria hráči, 12 kôl, 140 útokov, výhra hráča Ty) nakreslená dvoma spôsobmi. Vľavo Kruhy, od stredu von: každé kolo je jeden kruh, rozdelený na oblúky podľa podielu políčok každého hráča. Hráč Ty je červený, Modrý, Zelený a Žltý majú svoje farby; vyradení hráči nechajú v kruhoch trhlinu. Vpravo Odtlačok mapy: skutočná mapa hry, každé políčko rozrezané na zvislé pruhy podľa času, zľava doprava, vo farbe svojho držiteľa; hrubé čiary sú fronty, cez ktoré prešlo veľa útokov. Obrázky sú bez slov, na hárku štvorec 210 mm.Kruhy, od stredu vonOdtlačok mapyTyModrýZelenýŽltýTyModrýZelenýŽltýpicture-version=5 record=wrkvo0 projection=rings-out ink=color | picture-version=5 record=wrkvo0 projection=map-v-imprint ink=color
Partia principalities4 z galérie obrázkov hry: seed CLS4, Kniežatstvá, štyria hráči, 12 kôl, 140 útokov, výhra hráča Ty; Picture.render s variantmi rings-out a map-imprint na štvorcovom hárku bez slov, hra 0.124.0 (Picture.VERSION 5), 6. 11. 2026. Nakreslil nástroj hry, hárky sú spojené do jedného súboru.

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 ukazujeSlabinaŽivý
Kruhy, od stredu von / od okraja dnukolo je kruh, rozdelený podľa podielu políčok; vyradenie je trhlinapri sto kolách veľmi hustývon áno, dnu nie
Rámy, od stredu von / od okraja dnuto isté v štvorcoch, ako tunelhlasnévon áno, dnu nie
Panely, dovnútra / vonhráč má vlastný štvorec, dobré na porovnanienajslabšie ako obraz: samé prázdne rámy s krížikomnie
Prekrývajúce sa štvorce, von / dovnútrarozeta štvorcovv strede zakalené, v čiernobielom pri prehre nečitateľnéoba áno
Lesstrom pre každého hráča, konárik s listom za vyhraný útokpri 14 hráčoch drobnýáno
Prúdpodiely políčok v čase, stĺpec na koloskôr graf než obrazáno
Súhvezdiehviezda pre hráča, väzby za zabrané políčkapri 2 až 4 hráčoch riedkeáno
Odtlačok mapyskutočná doska, políčka v pruhoch časuváž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.

Štyri ďalšie obrázky tej istej partie: Rámy, Les, Súhvezdie a PrúdTá istá partia (partia CLS4 (seed CLS4): Kniežatstvá, štyria hráči, 12 kôl, 140 útokov, výhra hráča Ty) vo štyroch ďalších variantoch, bez slov. Rámy, od stredu von: kolo je štvorcový rám, ktorého obvod sa delí podľa podielu políčok. Les: strom pre každého hráča, kmeň rastie o jeden článok za kolo, vyhraný útok je konárik s listom. Súhvezdie: hviezda pre každého hráča, lúč za každé kolo a väzba medzi hráčmi za zabrané políčka. Prúd: podiely políčok v čase, jeden stĺpec na kolo.Rámy, od stredu vonLesSúhvezdiePrúdpicture-version=5 record=wrkvo0 projection=frames-out ink=color | picture-version=5 record=wrkvo0 projection=tree-forest ink=color | picture-version=5 record=wrkvo0 projection=constellation-stars ink=color | picture-version=5 record=wrkvo0 projection=stream-stacked ink=color
Partia principalities4 z galérie obrázkov hry (seed CLS4, 12 kôl, 140 útokov); Picture.render s variantmi frames-out, tree-forest, constellation-stars a stream-stacked na štvorcovom hárku bez slov, hra 0.124.0, 6. 11. 2026.

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.

Z desiatich útokov štyri pruhy: jedno políčko odtlačku mapyPolíčko 9 z 32 v partii CLS4 (4 hráči, 12 kôl). Pred prvým útokom ho držal Žltý a postupne ho vzali Modrý, Zelený, Žltý, Ty, Modrý, Ty, Modrý, Ty, Modrý, Ty; v 3 útokoch prvého kola prešlo z ruky do ruky a skončilo kolo opäť u hráča Žltý. Z útokov sa spočíta, kto políčko držal na začiatku každého kola, a z toho vzniknú 4 pruhy: Žltý, Ty, Modrý, Ty. Prvý pruh je držiteľ pred prvým útokom a posledný konečný držiteľ.kolo123456789101112koniecútoky,čo ho vzalidržiteľ nazačiatku kolapruhyv obrázkudržiteliapo sebeTyModrýZelenýŽltý
Políčko 9 z 32 v partii CLS4 (Kniežatstvá, 12 kôl): útoky z faktov partie, držiteľ z Picture.ownership a pruhy z primitív s.9.0 až s.9.3 scény Odtlačku mapy; hra 0.124.0, 6. 11. 2026.

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.

BehHierRiadkov doskyPolíčokÚtokov
22. 10., prvé meranie28910 58921 231118 667
22. 10., po zlúčení2699 30319 687111 165
6. 11., dnes (22 s)2699 39919 704113 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.

ČoHodnotaZdroj
Aktualizácia živého obrázka, ktorý len pridáva primitíva0,6 až 0,9 ms; so 4-krát pomalším procesorom 1,6 až 2,8 ms, najhoršia 12 msdokumentácia, 21. 10., Chromium
Živý odtlačok mapy po kole, partia troch hráčov6,9 ms, najhoršia 11,7 msdokumentácia, 22. 10., Chromium
To isté dnes, živé okno hry5,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 kolamedián 0,1 ms, najhoršia 2,3 ms; odtlačok mapy s prekreslením 1,1 a 2,8 msChromium 152 v paneli Browser, bez spomalenia procesora
Dnes, 14 hráčov a 57 kôl, udalosti kolamediá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 msto 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.

Zamotanosť Kruhov rastie s počtom kôl a hranica s ňouBodový graf šesťdesiatich partií kontroly nástroja hry (seed PICCHK, Kruhy od stredu von na A4): vodorovne počet kôl partie (3 až 100), zvisle najviac čiar cez jednu bunku papiera, teda zamotanosť. Čím dlhšia partia, tým viac kruhov a tým väčšia zamotanosť. Pevná hranica 8 z prvého návrhu by neprešlo 11 partií z 60; dnešná hranica 8 + 0,22 na kolo nenechá prekročiť žiadnu, najbližšia je partia s 11 kolami: 7 proti hranici 10,4.01020300255075100kôl v partiiprvý návrh: 8 pre každú partiudnešná hranicapartia, ktorá by prešla aj s pevnou hranicou 8partia, ktorá by s ňou neprešla (11 zo 60)8 + 0,22 na kolonajviac čiar cez jednu bunku papiera
60 partií kontroly nástroja hry (seed PICCHK), Kruhy od stredu von na A4; zamotanosť je najväčší počet čiar cez jednu bunku papiera (Picture.metrics); hranica 8 + 0,22 na kolo z data/picture.js; hra 0.124.0, 6. 11. 2026.

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.

Okno Obrázok hry po dohratej partii: náhľad obrázka na papieri A4 a voľby variantu, farieb, papiera, slov a názvu; uložiť sa dá ako SVG alebo PNG, alebo vytlačiť.
Obrázok sa kreslí zo záznamu partie; variant a farby sa dajú zmeniť, kým sa neuloží alebo nevytlačí.

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.
Hárok A4 s Kruhmi z jednej partie, ako sa tlačíHárok papiera A4 na výšku, na ňom Kruhy, od stredu von z partie partia CLS4 (seed CLS4): Kniežatstvá, štyria hráči, 12 kôl, 140 útokov, výhra hráča Ty. Hore obrázok so zlomovými bodmi z analýzy (2 zlomové body: 1. kolo a 2. kolo), každý je vyznačený čiarou a štítkom, tenký kruh okolo je šanca hráča Ty na výhru po kolách. Dolu blok s názvom Audamir, výsledkom Výhra v 12. kole, popisom Kniežatstvá, 4 hráči, 32 políčok, dátumom hárku a legendou hráčov: Ty s hviezdičkou víťaza, Modrý vyradený v 12. kole, Zelený vyradený v 5. kole, Žltý vyradený v 4. kole.Zlomový bod: 2. koloZlomový bod: 1. koloAudamirVýhra v 12. koleKniežatstvá - 4 hráči - 32 políčok2026-11-06Záznam wrkvo0 - Obrázok v5 - rings-outTy100%Modrývyradený v 12. koleZelenývyradený v 5. koleŽltývyradený v 4. kolepicture-version=5 record=wrkvo0 projection=rings-out ink=color
Hárok A4, ako ho nakreslí Picture.render so slovenskými textami hry: partia CLS4 (Kniežatstvá, 12 kôl, 140 útokov), Kruhy od stredu von so zlomovými bodmi z analýzy, hra 0.124.0 (Picture.VERSION 5). Dátum na hárku je 6. 11. 2026, deň výroby obrázka.

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.VERSION 5. Rozhodnutia sú v docs/DESIGN.md hry, §37, a v docs/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.render hry, ostatné grafy tools/charts.js.
  • Nezhoduje sa: dokumentácia píše Picture.VERSION 2 a sedem živých variantov; kód má verziu 5 a dnes je živých osem.