examples/breakout/sprites/art/element_blue_polygon_glossy.png

<EFBFBD>PNG


IHDR0.Yj^gAMA<00><><0B>a<02>PLTE}<7D>{<7B>|<7C>|<7C>|<7C>}<7D>|<7C>~<7E>{<7B>}<7D>}<7D>w<>}<7D>}<7D>Y<><59>"<22><>.<2E><>t<EFBFBD><74>z<EFBFBD><7A><EFBFBD><EFBFBD><EFBFBD>l<EFBFBD><6C>+<2B><>U<EFBFBD><55>4<EFBFBD><34>Q<EFBFBD><51><1C><>E<EFBFBD><45>=<3D><>o<EFBFBD><6F>b<EFBFBD><62>=<3D><>l<EFBFBD><6C>Z<EFBFBD><5A>c<EFBFBD><63>{<7B><>f<EFBFBD><66>+<2B><><1B><>Z<EFBFBD><5A>D<EFBFBD><44><1D><>J<EFBFBD><4A>g<EFBFBD><67>u<EFBFBD><75><15><>u<EFBFBD><75>&<26><>-<2D><>1<EFBFBD><31>><3E><>^<5E><>W<EFBFBD><57>"<22><>p<EFBFBD><70>M<EFBFBD><4D>G<EFBFBD><47>R<EFBFBD><52>f<EFBFBD><66>#<23><>4<EFBFBD><34>|<7C><>D<EFBFBD><44>$<24><>]<5D><>@<40><>r<EFBFBD><72>i<EFBFBD><69><1E><><15><>*<2A><>,<2C><>m<EFBFBD><6D>"<22><>^<5E><><16><>:<3A><>S<EFBFBD><53>J<EFBFBD><4A>I<EFBFBD><49>(<28><>f<EFBFBD><66>0<EFBFBD><30>*<2A><>$<24><>U<EFBFBD><55>T<EFBFBD><54>><3E><>6<EFBFBD><36>C<EFBFBD><43>"<22><>p<EFBFBD><70><1C><>B<EFBFBD><42>b<EFBFBD><62>;<3B><><14><>0<EFBFBD><30>'<27><>.<2E><>h<EFBFBD><68>c<EFBFBD><63>t<EFBFBD><74><EFBFBD><EFBFBD><EFBFBD>V<EFBFBD><56>y<EFBFBD><79>n<EFBFBD><6E>o<EFBFBD><6F>f<EFBFBD><66>z<EFBFBD><7A>l<EFBFBD><6C>^<5E><>d<EFBFBD><64>a<EFBFBD><61>b<EFBFBD><62>v<EFBFBD><76>y<EFBFBD><79>r<EFBFBD><72>j<EFBFBD><6A>h<EFBFBD><68>q<EFBFBD><71>]<5D><>g<EFBFBD><67>_<EFBFBD><5F><EFBFBD><EFBFBD><EFBFBD>t<EFBFBD><74><EFBFBD><EFBFBD><EFBFBD>E<EFBFBD><45>j<EFBFBD><6A><EFBFBD><EFBFBD><EFBFBD>=<3D><>6<EFBFBD><36>D<EFBFBD><44>H<EFBFBD><48>A<EFBFBD><41>3<EFBFBD><33>2<EFBFBD><32>:<3A><>2<EFBFBD><32>6<EFBFBD><36>|<7C><>{<7B><>[<5B><>X<EFBFBD><58>(<28><>L<EFBFBD><4C>"<22><>@<40><>-<2D><>$<24><><1F><><16><>/<2F><>T<EFBFBD><54>X<EFBFBD><58>c<EFBFBD><63>^<5E><>H<EFBFBD><48>U<EFBFBD><55>=<3D><>(<28><>8<EFBFBD><38> <20><>C<EFBFBD><43>5<EFBFBD><35><17><>m<EFBFBD><6D><16><><1D><><16><><1A><>G<EFBFBD><47>@<40><><<3C><>P<EFBFBD><50>}<7D><><12><>&<26><>1<EFBFBD><31><1B><>Z<EFBFBD><5A>n<EFBFBD><6E>~<7E><><EFBFBD><EFBFBD><EFBFBD>p<EFBFBD><70>\<5C><>q<EFBFBD><71>R<EFBFBD><52><EFBFBD><EFBFBD><EFBFBD>Y<EFBFBD><59>~<7E><><EFBFBD><EFBFBD><EFBFBD>r<EFBFBD><72>s<EFBFBD><73><EFBFBD><EFBFBD><EFBFBD>]<5D><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>}<7D><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>t<EFBFBD><74>v<EFBFBD><76>w<EFBFBD><77>S<EFBFBD><53><EFBFBD><EFBFBD><EFBFBD><EFBFBD><7F>|<7C><>{<7B><>z<EFBFBD><7A>x<EFBFBD><78>_<EFBFBD><5F>U<EFBFBD><55>W<EFBFBD><57>`<60><>/<2F><>b<EFBFBD><62>c<EFBFBD><63>e<EFBFBD><65>g<EFBFBD><67>i<EFBFBD><69>f<EFBFBD><66><14><>}<7D>4<EFBFBD><34>J<EFBFBD><4A>VC<56>htRNS?_<><5F>ϟoO/<2F><0F><>2<>m<EFBFBD><02>IDATHǍ<48>ew<65>@<14><><EFBFBD><EFBFBD>Z6<5A><36><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>]<5D>-V/<2F>*<2A>J<>hKq<4B><71>b<EFBFBD><62><EFBFBD><1F>dfvg%I<>|<7C>s<EFBFBD>s<EFBFBD>s<EFBFBD>d<EFBFBD><64>T<05><>~<7E>T<EFBFBD>f	L<><17>u<><18><>	#4o<34>0<EFBFBD>i+<2B><><EFBFBD>$<24><>&--$<24>m'{<7B><><08><><EFBFBD>b<EFBFBD>cz<63><7A>Ѣ/Xm0jt<6A><74>m<EFBFBD>!@
<EFBFBD>Lc<>Q>Q<04>Z<EFBFBD>h<EFBFBD>1<EFBFBD>
<18><><EFBFBD><EFBFBD>`<60><>x<>'=vQ<76>b<EFBFBD><08><> <20><><EFBFBD>{<7B>y<EFBFBD><79><EFBFBD><EFBFBD>ć?w<>;Nn<4E>+<2B>ȡ|%<25>=<3D><>s<EFBFBD>sv<73>Ʈ~<7E><><EFBFBD>׽Ć<>><3E><><EFBFBD>o<EFBFBD>-<2D><><EFBFBD>ל^<5E>l%<25><0E>O<EFBFBD>bNޮ<4E><DEAE>
[_r<5F>w<EFBFBD>+Ad<41><64>?{<7B><><EFBFBD><EFBFBD>5=hIV<49>,HoQ<6F>ٲ<EFBFBD><D9B2>k<0B>q<1A><> d<><64><EFBFBD><EFBFBD>s<EFBFBD>m<EFBFBD><6D>E麧<45>*<2A><00>P<EFBFBD>Z<EFBFBD>G<EFBFBD><47><EFBFBD><EFBFBD>~<7E><><EFBFBD><EFBFBD>Q<EFBFBD>r,ء<><D8A1><EFBFBD>%<25>\<5C>U;~<7E>p<EFBFBD><70><1D><><EFBFBD><1D>`0"+Ծ<><D4BE>YV<59>b<EFBFBD>/
B<>/<2F><>tU
<EFBFBD><EFBFBD><EFBFBD>B<>_MiG-
 <20>+%<25><>q<><71><18><1E><><EFBFBD>%<25><><06><><EFBFBD><19><>xqL<4C>Y<EFBFBD><59><EFBFBD>O<EFBFBD><4F><EFBFBD><18><>k;<3B>(<28>3<><33>#<23>eY><3E><>-<2D><0F>	6r5<72>0{<7B>LY᰺p<E1B0BA><1C><>Õ<1B><11>&-Q.<2E>S9<1B><><EFBFBD><06>
V:<3A><>H!BID<49><00>a<EFBFBD>k:<3A><><0C>
)<02>t<EFBFBD><74>D<EFBFBD><44><EFBFBD><EFBFBD>.i':CQ<><51><EFBFBD>ɕ<EFBFBD><1C><><EFBFBD>`<60><>t<EFBFBD>	I"<22>j<18>3<1D>N<EFBFBD><04>Lǽ1<>g:<3A>Ç<EFBFBD>L8O<13>2<>+S<>Ӈ<EFBFBD><D387><EFBFBD>~<7E>%r	v<> <20>d<EFBFBD>)<29><><EFBFBD><EFBFBD>ˇ<EFBFBD>2<EFBFBD>V<EFBFBD>K2<4B>g2Md<4D>~<7E>m<10><>Y*<2A><><EFBFBD>EJ"<22><><EFBFBD>&<26><><EFBFBD><EFBFBD>d)<29><01>LS<4C>D<>9`<60><><EFBFBD>H05SKp.v'<27><><00>~<7E>(<28><>K<EFBFBD>_<EFBFBD><EFBFBD>p<EFBFBD>x<11>o<EFBFBD>IEND<4E>B`<60>
-												Add two Breakout examples and the tutorials that build them

Two complete games in `examples/breakout/`, both 100% BASIC: `characters/`
draws its wall in the text grid with two `DATA` sprites for the ball and
paddle, and `sprites/` loads CC0 artwork and captures its whole screen with
`SSHAPE`/`SPRSAV`. They take opposite shapes for reasons that are entirely
this interpreter's, which is what the chapters are for.

`docs/17-tutorial-breakout.md` and `docs/18-tutorial-breakout-artwork.md`
build each one a step at a time, and end in a checklist of the rules a real
program runs into: create every name before the loop starts, write a text row
whole, loop with `GOTO` rather than `DO`, put the float on the left. Every
trap is a runnable block with its own output rather than a claim -- the value
pool dying at four thousand names, the skipped `BEGIN` block that breaks its
caller's `RETURN`, `SSHAPE` ignoring a subscript, `READ`'s single cursor.

Five figures, generated from the listings beside them by `docs_screenshots`,
and a `breakout_art` setup so the ones that load artwork load the example's
own. The character game's wall cannot be photographed -- the screenshot host
omits the text layer on purpose -- so it is shown as compared output instead.

`docs/07-sound.md` never said `SOUND`'s frequency is a SID register value
rather than hertz, which both games depend on. It says so now, with the
conversion from `src/audio_tables.c:84`.

`TODO.md` gains the thirteen defects the two games turned up -- §6 items 30
to 33 and all of §9 -- each with a reduction that fits on a screen, the file
and line of the cause, and what a fix would touch.

Verified: `docs_examples` passes in both build configurations,
`docs_screenshots --check` re-renders all thirteen figures and byte-compares
them, the full 109-test suite passes in both builds, every quoted fragment
was checked to appear verbatim in the listing it came from, and every
relative link and anchor resolves.

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

											
										
										
											2026-08-01 22:54:42 -04:00
+								<EFBFBD>PNG
 IHDR0.Yj^gAMA<00><><0B>a<02>PLTE}<7D>{<7B>|<7C>|<7C>|<7C>}<7D>|<7C>~<7E>{<7B>}<7D>}<7D>w<>}<7D>}<7D>Y<><59>"<22><>.<2E><>t<EFBFBD><74>z<EFBFBD><7A><EFBFBD><EFBFBD><EFBFBD>l<EFBFBD><6C>+<2B><>U<EFBFBD><55>4<EFBFBD><34>Q<EFBFBD><51><1C><>E<EFBFBD><45>=<3D><>o<EFBFBD><6F>b<EFBFBD><62>=<3D><>l<EFBFBD><6C>Z<EFBFBD><5A>c<EFBFBD><63>{<7B><>f<EFBFBD><66>+<2B><><1B><>Z<EFBFBD><5A>D<EFBFBD><44><1D><>J<EFBFBD><4A>g<EFBFBD><67>u<EFBFBD><75><15><>u<EFBFBD><75>&<26><>-<2D><>1<EFBFBD><31>><3E><>^<5E><>W<EFBFBD><57>"<22><>p<EFBFBD><70>M<EFBFBD><4D>G<EFBFBD><47>R<EFBFBD><52>f<EFBFBD><66>#<23><>4<EFBFBD><34>|<7C><>D<EFBFBD><44>$<24><>]<5D><>@<40><>r<EFBFBD><72>i<EFBFBD><69><1E><><15><>*<2A><>,<2C><>m<EFBFBD><6D>"<22><>^<5E><><16><>:<3A><>S<EFBFBD><53>J<EFBFBD><4A>I<EFBFBD><49>(<28><>f<EFBFBD><66>0<EFBFBD><30>*<2A><>$<24><>U<EFBFBD><55>T<EFBFBD><54>><3E><>6<EFBFBD><36>C<EFBFBD><43>"<22><>p<EFBFBD><70><1C><>B<EFBFBD><42>b<EFBFBD><62>;<3B><><14><>0<EFBFBD><30>'<27><>.<2E><>h<EFBFBD><68>c<EFBFBD><63>t<EFBFBD><74><EFBFBD><EFBFBD><EFBFBD>V<EFBFBD><56>y<EFBFBD><79>n<EFBFBD><6E>o<EFBFBD><6F>f<EFBFBD><66>z<EFBFBD><7A>l<EFBFBD><6C>^<5E><>d<EFBFBD><64>a<EFBFBD><61>b<EFBFBD><62>v<EFBFBD><76>y<EFBFBD><79>r<EFBFBD><72>j<EFBFBD><6A>h<EFBFBD><68>q<EFBFBD><71>]<5D><>g<EFBFBD><67>_<EFBFBD><5F><EFBFBD><EFBFBD><EFBFBD>t<EFBFBD><74><EFBFBD><EFBFBD><EFBFBD>E<EFBFBD><45>j<EFBFBD><6A><EFBFBD><EFBFBD><EFBFBD>=<3D><>6<EFBFBD><36>D<EFBFBD><44>H<EFBFBD><48>A<EFBFBD><41>3<EFBFBD><33>2<EFBFBD><32>:<3A><>2<EFBFBD><32>6<EFBFBD><36>|<7C><>{<7B><>[<5B><>X<EFBFBD><58>(<28><>L<EFBFBD><4C>"<22><>@<40><>-<2D><>$<24><><1F><><16><>/<2F><>T<EFBFBD><54>X<EFBFBD><58>c<EFBFBD><63>^<5E><>H<EFBFBD><48>U<EFBFBD><55>=<3D><>(<28><>8<EFBFBD><38> <20><>C<EFBFBD><43>5<EFBFBD><35><17><>m<EFBFBD><6D><16><><1D><><16><><1A><>G<EFBFBD><47>@<40><><<3C><>P<EFBFBD><50>}<7D><><12><>&<26><>1<EFBFBD><31><1B><>Z<EFBFBD><5A>n<EFBFBD><6E>~<7E><><EFBFBD><EFBFBD><EFBFBD>p<EFBFBD><70>\<5C><>q<EFBFBD><71>R<EFBFBD><52><EFBFBD><EFBFBD><EFBFBD>Y<EFBFBD><59>~<7E><><EFBFBD><EFBFBD><EFBFBD>r<EFBFBD><72>s<EFBFBD><73><EFBFBD><EFBFBD><EFBFBD>]<5D><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>}<7D><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>t<EFBFBD><74>v<EFBFBD><76>w<EFBFBD><77>S<EFBFBD><53><EFBFBD><EFBFBD><EFBFBD><EFBFBD><7F>|<7C><>{<7B><>z<EFBFBD><7A>x<EFBFBD><78>_<EFBFBD><5F>U<EFBFBD><55>W<EFBFBD><57>`<60><>/<2F><>b<EFBFBD><62>c<EFBFBD><63>e<EFBFBD><65>g<EFBFBD><67>i<EFBFBD><69>f<EFBFBD><66><14><>}<7D>4<EFBFBD><34>J<EFBFBD><4A>VC<56>htRNS?_<><5F>ϟoO/<2F><0F><>2<>m<EFBFBD><02>IDATHǍ<48>ew<65>@<14><><EFBFBD><EFBFBD>Z6<5A><36><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>]<5D>-V/<2F>*<2A>J<>hKq<4B><71>b<EFBFBD><62><EFBFBD><1F>dfvg%I<>|<7C>s<EFBFBD>s<EFBFBD>s<EFBFBD>d<EFBFBD><64>T<05><>~<7E>T<EFBFBD>f	L<><17>u<><18><>	#4o<34>0<EFBFBD>i+<2B><><EFBFBD>$<24><>&--$<24>m'{<7B><><08><><EFBFBD>b<EFBFBD>cz<63><7A>Ѣ/Xm0jt<6A><74>m<EFBFBD>!@
 								<EFBFBD>Lc<>Q>Q<04>Z<EFBFBD>h<EFBFBD>1<EFBFBD>
 								<18><><EFBFBD><EFBFBD>`<60><>x<>'=vQ<76>b<EFBFBD><08><> <20><><EFBFBD>{<7B>y<EFBFBD><79><EFBFBD><EFBFBD>ć?w<>;Nn<4E>+<2B>ȡ|%<25>=<3D><>s<EFBFBD>sv<73>Ʈ~<7E><><EFBFBD>׽Ć<>><3E><><EFBFBD>o<EFBFBD>-<2D><><EFBFBD>ל^<5E>l%<25><0E>O<EFBFBD>bNޮ<4E><DEAE>
[_r<5F>w<EFBFBD>+Ad<41><64>?{<7B><><EFBFBD><EFBFBD>5=hIV<49>,HoQ<6F>ٲ<EFBFBD><D9B2>k<0B>q<1A><> d<><64><EFBFBD><EFBFBD>s<EFBFBD>m<EFBFBD><6D>E麧<45>*<2A><00>P<EFBFBD>Z<EFBFBD>G<EFBFBD><47><EFBFBD><EFBFBD>~<7E><><EFBFBD><EFBFBD>Q<EFBFBD>r,ء<><D8A1><EFBFBD>%<25>\<5C>U;~<7E>p<EFBFBD><70><1D><><EFBFBD><1D>`0"+Ծ<><D4BE>YV<59>b<EFBFBD>/
B<>/<2F><>tU
 								<EFBFBD><EFBFBD><EFBFBD>B<>_MiG-
 								 <20>+%<25><>q<><71><18><1E><><EFBFBD>%<25><><06><><EFBFBD><19><>xqL<4C>Y<EFBFBD><59><EFBFBD>O<EFBFBD><4F><EFBFBD><18><>k;<3B>(<28>3<><33>#<23>eY><3E><>-<2D><0F>	6r5<72>0{<7B>LY᰺p<E1B0BA><1C><>Õ<1B><11>&-Q.<2E>S9<1B><><EFBFBD><06>
V:<3A><>H!BID<49><00>a<EFBFBD>k:<3A><><0C>
)<02>t<EFBFBD><74>D<EFBFBD><44><EFBFBD><EFBFBD>.i':CQ<><51><EFBFBD>ɕ<EFBFBD><1C><><EFBFBD>`<60><>t<EFBFBD>	I"<22>j<18>3<1D>N<EFBFBD><04>Lǽ1<>g:<3A>Ç<EFBFBD>L8O<13>2<>+S<>Ӈ<EFBFBD><D387><EFBFBD>~<7E>%r	v<> <20>d<EFBFBD>)<29><><EFBFBD><EFBFBD>ˇ<EFBFBD>2<EFBFBD>V<EFBFBD>K2<4B>g2Md<4D>~<7E>m<10><>Y*<2A><><EFBFBD>EJ"<22><><EFBFBD>&<26><><EFBFBD><EFBFBD>d)<29><01>LS<4C>D<>9`<60><><EFBFBD>H05SKp.v'<27><><00>~<7E>(<28><>K<EFBFBD>_<EFBFBD><EFBFBD>p<EFBFBD>x<11>o<EFBFBD>IEND<4E>B`<60>