docs/images/draw.png

<EFBFBD>PNG


IHDR@<00>f<><66><05>IDATx<54><78><EFBFBD>;zEЁ%)#t<><02>Y<EFBFBD>WA<57>5<EFBFBD><35>B<><42>k"0[<5B><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>z<EFBFBD>99|UOQ<4F>A<EFBFBD><41><00>ϟ?F<><00><>ez<65><7A>W?G<00><06>]<5D><>0<14>bh<62>0<EFBFBD><30>긚a<EAB89A><61><00>tc<74>Z<5A><C290>)5Ð׻<C390>i<EFBFBD>!<21>{<7B><>CF<43>O<EFBFBD><4F>3<EFBFBD>+4<<3C>T<EFBFBD>\ѹi4Ð<34><C390>Q4<51><10><>`vq<08>0<EFBFBD>2~<7E>̰<EFBFBD><CCB0>t<><74><EFBFBD>3x;<3B><>
<0A><><0E><><EFBFBD>O<><4F><EFBFBD>F\<5C>nx<6E>Ns#_۩G<DBA9><47><EFBFBD><EFBFBD>܂<EFBFBD><DC82><EFBFBD><EFBFBD>˼<EFBFBD>iz<07>?/<2F>͹0-<2D>총fg8֚<38>hO.L<0B>,gڐ<0B>b<EFBFBD>L<EFBFBD>iv<69>´p<C2B4>v<><76><EFBFBD>0-VH<56><0E>	<17><>3<EFBFBD><33>g<EFBFBD>c<05><>@<40>saZ<61><5A>Hhm'<27>ϑ<0F>!<21>5\<5C><><EFBFBD>R><><7F><EFBFBD><EFBFBD>St<15>)n<<3C><>'<27><<3C>p/7<1E>Kc<>bx<62>ce0[=<3D><><EFBFBD><EFBFBD>X9<58><39>Y<EFBFBD>=6<><36><05><><07>5<EFBFBD><35>0V<30><56>2<EFBFBD>ƿ<EFBFBD><1E>#T<7F>Ē<EFBFBD><C492>;7<1E>*W<>"7<><37><EFBFBD>XU<58><55>R<EFBFBD>^<5E>x<18>PJ<50>J=|<7C><>|<7C>NǍ<4E><C78D>*<2A>S<EFBFBD>fH̕<48><CC95><EFBFBD>&S<><53>V\Y<1A>t,<2C><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>gR<67><52><EFBFBD>\Y<1A>G=<3D>(ɍ<><C98D><EFBFBD>DѦ<44>bp<>f94k<34>W<><57>jB<>v
pei<EFBFBD><EFBFBD><EFBFBD><EFBFBD>l*<2A><><EFBFBD><EFBFBD><0B>յ<EFBFBD><D5B5>}<7D><>!<21>5<>h<EFBFBD>x<EFBFBD><78>I<>r<EFBFBD>2<EFBFBD><32><EFBFBD>x<EFBFBD><78>R<EFBFBD>q<>J<EFBFBD>١<EFBFBD>z<0C>-<2D>l<EFBFBD>̶C<CCB6>;<3B>&[<5B><><EFBFBD><EFBFBD>j<EFBFBD>f<EFBFBD><66>t<EFBFBD><74><EFBFBD><EFBFBD><EFBFBD>j<EFBFBD>}:=6kv<6B><76><EFBFBD><EFBFBD>-l<>z|aÖ'ʜf<CA9C>چh<DA86><68><EFBFBD><EFBFBD><EFBFBD>z<EFBFBD><7A>i&/<2F><><EFBFBD><EFBFBD>ݰmフȱD<C8B1>'t<><74>N<EFBFBD><4E><EFBFBD>Uh*<2A>N<EFBFBD>::!0<18>r<EFBFBD><72>y<EFBFBD><79>+W<>
<0A>z<EFBFBD>H'U<0C>bͯj<CDAF><6A><10>xX<78>Ȋ<EFBFBD><C88A>B<EFBFBD>.ƒ<>c<EFBFBD><63>U<EFBFBD><55><EFBFBD><1A>0<EFBFBD>X<EFBFBD>U=<3D><><EFBFBD><EFBFBD>.~<7E><><EFBFBD><EFBFBD>

#<23>"}<7D><15><>h<EFBFBD>+<2B><>m*<2A>H<EFBFBD><48>CH<43><48>N<EFBFBD><4E><EFBFBD><EFBFBD><EFBFBD>_<EFBFBD><5F><EFBFBD>;<3B>?<3F><><EFBFBD><EFBFBD>,<2C>B<EFBFBD>*5<>q<><71><EFBFBD><EFBFBD><EFBFBD><EFBFBD>㇧O<E387A7>U<00><>\%<25>*Qd6B<36>N<EFBFBD>8򷖿<F2B796BF><C29C><EFBFBD><EFBFBD>Y$o-yy<79>I<EFBFBD>86H!s<><73>k<EFBFBD>OzǱG
9{<7B>YU-<2D>g<EFBFBD>I<EFBFBD>9<EFBFBD><39>YU9[ǸO<C7B8><4F>:<3A>VO]<5D>&<26>[<5B><><EFBFBD>MULu<4C><75><EFBFBD>[<5B>y<EFBFBD><79>SI<1B>E<EFBFBD>]<5D><>q<EFBFBD><71>:C
<0A><>M<EFBFBD>ޯRBi{<7B><><EFBFBD>F<EFBFBD><46> <20><><EFBFBD><EFBFBD>_`<60>xw<78><77>
<0A><>o<EFBFBD><6F><02><13><><EFBFBD>{<7B><12><><02>C<EFBFBD><43><EFBFBD>BB<42><42><1A>s<EFBFBD><73>ۃG!<21><>.<2E><>+40<34>%<25>²@$<24>^<5E><><1B>tٚL$<24>U<EFBFBD><55>W-<2D>E<EFBFBD><45>x.c<><63><EFBFBD><EFBFBD>(<28><>
SÑ<x<>n<EFBFBD><6E><EFBFBD><EFBFBD><19>ct<63>)I<>(<28><><EFBFBD>+<2B>,<2C><><EFBFBD><EFBFBD>J<EFBFBD><0C>1zȨ<7A><C8A8>^Z<><1F><><07><>'\M<><0C>1:<3A>bt<62><74>.ˏЬ絅,<2C><>N(<28>l<>MY<4D>`	q"F<>3<EFBFBD><33>h<EFBFBD><68><EFBFBD>;x<><06>?L<>w<EFBFBD><1D>	-<2D>R<EFBFBD><52><19>MU<4D><55><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ynd+<2B>~l<>n<EFBFBD>3<><33>k<EFBFBD>W{K6pC<70>0<EFBFBD>x<EFBFBD><78>x<EFBFBD><78>ػ<EFBFBD><D8BB>{<7B><><19>#<23>ؗ<EFBFBD><D897>ޘ
<0C><>!v<><76>$AU<41>f<><0C>d<EFBFBD><64>$60<36>6<EFBFBD>汁<>7X<37>0<EFBFBD>
<0C><><EFBFBD><EFBFBD><EFBFBD>l`<60><07>/,`߳~a
<18><><EFBFBD><0B><><EFBFBD><EFBFBD><EFBFBD>_X<5F><06><><EFBFBD>~a9<18>~!<21>
۳~!<21>
{<7B>~!<21>
<1B>~!<21>
<0C><>~<00><><EFBFBD><EFBFBD><EFBFBD>?<3F>۟<EFBFBD><DB9F><EFBFBD>v<><76><EFBFBD>G<7F><00>%<25>֭.<2E><><EFBFBD>IEND<4E>B`<60>
-												Generate the documentation's figures from the listings they illustrate

Chapters 6 and 8 described what a verb draws in prose. Eight figures now show
it, and each one is produced by running the BASIC listing printed immediately
above it -- so a picture cannot drift away from the code beside it, which is the
way a screenshot goes wrong and the way nothing notices.

tools/screenshot.c is a second SDL host, much smaller than the frontend: dummy
video driver, software renderer, run to completion, read the target back, write
a PNG. It draws no text layer on purpose, so a READY in the corner is not noise
in a figure about BOX and no font has to be resolved.

tools/docs_screenshots.sh reads the new screenshot=NAME fence tag straight out
of the markdown. size=WxH is the second tag, and SCALE's figure uses it: the
point being made is a 320x200 listing filling a larger window, which cannot be
made on a 320x200 surface.

Two gates, answering different questions. docs_examples fails a tagged block
with no image, in both configurations, so a figure cannot be added and
forgotten. docs_screenshots -- a CTest, AKGL build only -- re-renders every
figure and compares byte for byte, so a listing edited without regenerating
fails. Only the second catches a stale picture.

The PNGs are checked in because a reader on the forge has no build tree, and
docs/images/README.md says loudly that they are generated. Regenerating is never
part of a build: the target is run deliberately, so a make cannot put eight
binary diffs in front of whoever ran it.

Drawing the BOX figure caught a defect in TODO.md itself. Deviation 16 claimed
in bold that BOX fills on a negative angle while its own paragraph said the fill
was filed rather than implemented. BOX cannot fill, and filled_rect is reached
by no verb as a result.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

											
										
										
											2026-08-01 07:37:04 -04:00
+								<EFBFBD>PNG
 IHDR@<00>f<><66><05>IDATx<54><78><EFBFBD>;zEЁ%)#t<><02>Y<EFBFBD>WA<57>5<EFBFBD><35>B<><42>k"0[<5B><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>z<EFBFBD>99|UOQ<4F>A<EFBFBD><41><00>ϟ?F<><00><>ez<65><7A>W?G<00><06>]<5D><>0<14>bh<62>0<EFBFBD><30>긚a<EAB89A><61><00>tc<74>Z<5A><C290>)5Ð׻<C390>i<EFBFBD>!<21>{<7B><>CF<43>O<EFBFBD><4F>3<EFBFBD>+4<<3C>T<EFBFBD>\ѹi4Ð<34><C390>Q4<51><10><>`vq<08>0<EFBFBD>2~<7E>̰<EFBFBD><CCB0>t<><74><EFBFBD>3x;<3B><>
<0A><><0E><><EFBFBD>O<><4F><EFBFBD>F\<5C>nx<6E>Ns#_۩G<DBA9><47><EFBFBD><EFBFBD>܂<EFBFBD><DC82><EFBFBD><EFBFBD>˼<EFBFBD>iz<07>?/<2F>͹0-<2D>총fg8֚<38>hO.L<0B>,gڐ<0B>b<EFBFBD>L<EFBFBD>iv<69>´p<C2B4>v<><76><EFBFBD>0-VH<56><0E>	<17><>3<EFBFBD><33>g<EFBFBD>c<05><>@<40>saZ<61><5A>Hhm'<27>ϑ<0F>!<21>5\<5C><><EFBFBD>R><><7F><EFBFBD><EFBFBD>St<15>)n<<3C><>'<27><<3C>p/7<1E>Kc<>bx<62>ce0[=<3D><><EFBFBD><EFBFBD>X9<58><39>Y<EFBFBD>=6<><36><05><><07>5<EFBFBD><35>0V<30><56>2<EFBFBD>ƿ<EFBFBD><1E>#T<7F>Ē<EFBFBD><C492>;7<1E>*W<>"7<><37><EFBFBD>XU<58><55>R<EFBFBD>^<5E>x<18>PJ<50>J=|<7C><>|<7C>NǍ<4E><C78D>*<2A>S<EFBFBD>fH̕<48><CC95><EFBFBD>&S<><53>V\Y<1A>t,<2C><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>gR<67><52><EFBFBD>\Y<1A>G=<3D>(ɍ<><C98D><EFBFBD>DѦ<44>bp<>f94k<34>W<><57>jB<>v
 								pei<EFBFBD><EFBFBD><EFBFBD><EFBFBD>l*<2A><><EFBFBD><EFBFBD><0B>յ<EFBFBD><D5B5>}<7D><>!<21>5<>h<EFBFBD>x<EFBFBD><78>I<>r<EFBFBD>2<EFBFBD><32><EFBFBD>x<EFBFBD><78>R<EFBFBD>q<>J<EFBFBD>١<EFBFBD>z<0C>-<2D>l<EFBFBD>̶C<CCB6>;<3B>&[<5B><><EFBFBD><EFBFBD>j<EFBFBD>f<EFBFBD><66>t<EFBFBD><74><EFBFBD><EFBFBD><EFBFBD>j<EFBFBD>}:=6kv<6B><76><EFBFBD><EFBFBD>-l<>z|aÖ'ʜf<CA9C>چh<DA86><68><EFBFBD><EFBFBD><EFBFBD>z<EFBFBD><7A>i&/<2F><><EFBFBD><EFBFBD>ݰmフȱD<C8B1>'t<><74>N<EFBFBD><4E><EFBFBD>Uh*<2A>N<EFBFBD>::!0<18>r<EFBFBD><72>y<EFBFBD><79>+W<>
<0A>z<EFBFBD>H'U<0C>bͯj<CDAF><6A><10>xX<78>Ȋ<EFBFBD><C88A>B<EFBFBD>.ƒ<>c<EFBFBD><63>U<EFBFBD><55><EFBFBD><1A>0<EFBFBD>X<EFBFBD>U=<3D><><EFBFBD><EFBFBD>.~<7E><><EFBFBD><EFBFBD>
 #<23>"}<7D><15><>h<EFBFBD>+<2B><>m*<2A>H<EFBFBD><48>CH<43><48>N<EFBFBD><4E><EFBFBD><EFBFBD><EFBFBD>_<EFBFBD><5F><EFBFBD>;<3B>?<3F><><EFBFBD><EFBFBD>,<2C>B<EFBFBD>*5<>q<><71><EFBFBD><EFBFBD><EFBFBD><EFBFBD>㇧O<E387A7>U<00><>\%<25>*Qd6B<36>N<EFBFBD>8򷖿<F2B796BF><C29C><EFBFBD><EFBFBD>Y$o-yy<79>I<EFBFBD>86H!s<><73>k<EFBFBD>OzǱG
 {<7B>YU-<2D>g<EFBFBD>I<EFBFBD>9<EFBFBD><39>YU9[ǸO<C7B8><4F>:<3A>VO]<5D>&<26>[<5B><><EFBFBD>MULu<4C><75><EFBFBD>[<5B>y<EFBFBD><79>SI<1B>E<EFBFBD>]<5D><>q<EFBFBD><71>:C
<0A><>M<EFBFBD>ޯRBi{<7B><><EFBFBD>F<EFBFBD><46> <20><><EFBFBD><EFBFBD>_`<60>xw<78><77>
<0A><>o<EFBFBD><6F><02><13><><EFBFBD>{<7B><12><><02>C<EFBFBD><43><EFBFBD>BB<42><42><1A>s<EFBFBD><73>ۃG!<21><>.<2E><>+40<34>%<25>²@$<24>^<5E><><1B>tٚL$<24>U<EFBFBD><55>W-<2D>E<EFBFBD><45>x.c<><63><EFBFBD><EFBFBD>(<28><>
SÑ<x<>n<EFBFBD><6E><EFBFBD><EFBFBD><19>ct<63>)I<>(<28><><EFBFBD>+<2B>,<2C><><EFBFBD><EFBFBD>J<EFBFBD><0C>1zȨ<7A><C8A8>^Z<><1F><><07><>'\M<><0C>1:<3A>bt<62><74>.ˏЬ絅,<2C><>N(<28>l<>MY<4D>`	q"F<>3<EFBFBD><33>h<EFBFBD><68><EFBFBD>;x<><06>?L<>w<EFBFBD><1D>	-<2D>R<EFBFBD><52><19>MU<4D><55><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ynd+<2B>~l<>n<EFBFBD>3<><33>k<EFBFBD>W{K6pC<70>0<EFBFBD>x<EFBFBD><78>x<EFBFBD><78>ػ<EFBFBD><D8BB>{<7B><><19>#<23>ؗ<EFBFBD><D897>ޘ
<0C><>!v<><76>$AU<41>f<><0C>d<EFBFBD><64>$60<36>6<EFBFBD>汁<>7X<37>0<EFBFBD>
<0C><><EFBFBD><EFBFBD><EFBFBD>l`<60><07>/,`߳~a
<18><><EFBFBD><0B><><EFBFBD><EFBFBD><EFBFBD>_X<5F><06><><EFBFBD>~a9<18>~!<21>
۳~!<21>
{<7B>~!<21>
<1B>~!<21>
<0C><>~<00><><EFBFBD><EFBFBD><EFBFBD>?<3F>۟<EFBFBD><DB9F><EFBFBD>v<><76><EFBFBD>G<7F><00>%<25>֭.<2E><><EFBFBD>IEND<4E>B`<60>