Files
akbasic/examples/breakout/sprites/art/ballBlue.png

4 lines
513 B
Plaintext
Raw Normal View History

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

IHDR<00>j<EFBFBD> gAMA<00><> <0B>a<00>PLTE<1C><><1B><><1C><><1C><><1D><><19><><1C><><1D><><1D><><1B><><1C><><11><><1D><>x<><78><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>><3E><>%<25><>.<2E><><EFBFBD><EFBFBD><EFBFBD>W<EFBFBD><57><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>_<EFBFBD><5F><EFBFBD><EFBFBD><EFBFBD>y<EFBFBD><79>\<5C><><EFBFBD><EFBFBD><EFBFBD>E<EFBFBD><45>?<3F><><EFBFBD><EFBFBD><EFBFBD>4<EFBFBD><34>"<22><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>K<EFBFBD><4B><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>p<EFBFBD><70>|<7C><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>n<EFBFBD><6E><EFBFBD><EFBFBD><EFBFBD>F<EFBFBD><46>5<EFBFBD><35><EFBFBD><EFBFBD><EFBFBD>t<EFBFBD><74><EFBFBD><EFBFBD><EFBFBD><1D><>z<EFBFBD><7A><EFBFBD><EFBFBD><EFBFBD>J<EFBFBD>ltRNS<4E>_o<7F>Ϗ<>/<2F><0F><00>0<EFBFBD><00>IDAT<18>]<5D>W<EFBFBD><57> D<>hsrZg+<2B>
4<EFBFBD><EFBFBD>j;J<>J<EFBFBD>o^<5E>@u<><75>C,XD<58><44><EFBFBD>g<EFBFBD>IWb@<40>b<EFBFBD><<04>U<EFBFBD>$O<>y<>E<EFBFBD>jm<06>B<>iUn,y <09><>K<EFBFBD>ף;<3B>.E^a3!<21><><EFBFBD>PJ<50><4A>5<EFBFBD>`<0E><><EFBFBD>iU<69><0E><>Z<EFBFBD><5A><EFBFBD><17>"b<1B><><17>;<18><>d@<40>0<13>3<EFBFBD><33>֟<EFBFBD><D69F><EFBFBD>k<EFBFBD>IK4Z<34>z<EFBFBD><7A><EFBFBD>ihhI<68><49><EFBFBD><EFBFBD><EFBFBD>'<1D><><EFBFBD><EFBFBD>><3E><01><>mN<6D>X<EFBFBD><58>8?<3F>R&<14>d<EFBFBD>W!%<25>%><1A><><08><><<1F>vܯ'<27><>--<2D>%<25><><EFBFBD><EFBFBD>]<5D>2<EFBFBD><32><EFBFBD><07>UF<55>L<EFBFBD><4C>`IEND<4E>B`<60>