docs/images/galaga-title.png

<EFBFBD>PNG


IHDR<03><00><>C.GIDATx<54><78>ݱ<EFBFBD><1B>ॱ<0F>B|<7C>,z<03>$<24><>ݹ	 <20>Iq<49><71><EFBFBD><EFBFBD>Ngo<67>")<29>@<1A><>.UZ<55><5A><EFBFBD><EFBFBD>y<00><>#<23>p<EFBFBD>л\<5C>Krxf<78>|_<><5F>83<38><33>`<60><><EFBFBD>w<EFBFBD>^\@<40><>ֲ#}<11><00><>٧<00><>h<EFBFBD>eG<00>=EDv<00>l<EFBFBD>v<00>p#<00>Zk<5A>F""<22>#<00>?nG<00><><EFBFBD><EFBFBD><00><01><><EFBFBD>0R<11><00>DZk<5A>8<11><><00>@<40>ֲ#<00>Hk-;U<>ֲ#<00><><EFBFBD><EFBFBD><00><11>`O<11><00>0|8#<23>@<00>a<EFBFBD><61><00><>Zˎ;<3B>U6<><36><EFBFBD>pN<70><4E>'<27>\.<13>><3E>N<13><>ݑG&w<>>׸<0F><><EFBFBD>1<EFBFBD>><3E>'<27>Yv8<00>`JP<4A>(A<00><00>`JP<4A>(A<00><>Iv<00>ݖ<EFBFBD><DD96>1<EFBFBD><31><EFBFBD><EFBFBD><1E><><EFBFBD>7o<37>Y|:<3A><1E><>NG<1E>#u<>wG<77>Z<EFBFBD>G><3E><><EFBFBD><18>{w<>}ME(<28><><00><16><>װ <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?<3F><>ޝq_S@<11>@Љ<>Zv<5A><76>Q<EFBFBD><06>o<EFBFBD>N<1E><>f<EFBFBD>~G<18><><EFBFBD>:<00>?<00>`JP<4A>z<><7A><EFBFBD>]S<>z<><7A><EFBFBD>]S<>(<28>2;@<40><><EFBFBD><EFBFBD>fG<00><><EFBFBD><0E>("<22><>y<EFBFBD><79><EFBFBD>t<EFBFBD>v<EFBFBD><76>X.<2E><>,><3E>NO<4E><4F><EFBFBD>r<EFBFBD><72><EFBFBD><EFBFBD>sU><3E><><EFBFBD><EFBFBD>y<><79><EFBFBD>3<04>s#<00>b<<05>s#<00>b<<00>P<EFBFBD>(A<00><00>`JP<4A>(A<00><><EFBFBD><EFBFBD><00>^<5E>|<7C><>ի<EFBFBD><D5AB>}}<7D><><EFBFBD>w<EFBFBD><77><EFBFBD>I<EFBFBD>:Y<><59>Ǹ<EFBFBD><01><>d<00>m<EFBFBD>\<1E><>t:<3A><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>޽;f<><66>l}<7D>#<23>=W<><57><1F><>\<5C>{G[w<>wg<77>WP<>!<21><00><>P<>@	
0%(<28><00><>P<><02>0DDv`<60>`<60>a><3E>gG<00>M<00><>Iv<00>ݖ<EFBFBD><DD96>1<EFBFBD>O<EFBFBD>S[<5B><>a<EFBFBD>|<7C>m<EFBFBD><6D><EFBFBD><01><>7<EFBFBD><00><>P<>@	
0%(<28><00><>P<>@	
p/<2F>ֲ#<00><><02><0B><>,;<00><>)<29><00><>P<>@	
0%(<28>p2<70><32>}<7D><03><>x<EFBFBD>?<00><>@	
0%(<28><00><>P<>@	<09><>v<>N<EFBFBD><4E>߰\.<2E><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>I<EFBFBD>ܷ3)<29>><3E><>]__'n}<7D>\<5C>tg<74><00><04> <20>Z<EFBFBD><1F><>ܵ#<23>
z<><7A>*<1F><>+<2B><><EFBFBD>1<EFBFBD>><3E>'a4<>h<EFBFBD>eG<65>i<EFBFBD>2P<>9<EFBFBD>l6ˎ<36><CB8E>8e<00>P<>@	
0%(<28><00><>P<>@	
0pqq<11>`MDdGƦ<><C6A6><11><00><>Iv*<2A><><EFBFBD>Cv<04>={<7B>";<00>\fx<><78><EFBFBD><EFBFBD><EFBFBD><EFBFBD>)8<><38><EFBFBD><EFBFBD><EFBFBD>H<>X<EFBFBD>eG<00><>ϲ<<3C><><00><><EFBFBD>T<EFBFBD>-"<22>#<00><><00><><EFBFBD><EFBFBD>r)<29><00><>P<>@	C<>	<09><>3;<3B><><EFBFBD><EFBFBD>
<EFBFBD><EFBFBD><EFBFBD>
0%(<28><00><>P<>{<7B><18><>?<3F>Ӟ<EFBFBD><D39E><EFBFBD><EFBFBD><EFBFBD>d=<07>|熎\|<7C><><EFBFBD>;<00><>o<EFBFBD>Kh<4B>eGH<><00>0<EFBFBD>Ͳ#$3<1A>!<21>8d<38><64>/<2F>x<EFBFBD><78><EFBFBD>?<3F><><EFBFBD>R<1B><><EFBFBD>\|<7C>;w<>><3E>x<EFBFBD>_Q<><51>}<07>^Q<><18>o<EFBFBD>y<EFBFBD><79>ō-<2D><><EFBFBD>7<EFBFBD>3W<33>}<07><>2<00>|<0C>8<19>ܣ0N<30>Cv<43><76><EFBFBD>h<EFBFBD><68><EFBFBD><EFBFBD><EFBFBD><00>d4%(<28><00>`4C<>>6x5`<60><><1F>o_<6F>'O0ޙ<30>FS<03><><0C><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>'x<>ى<EFBFBD><D989>}<7D>a`<60>!<21>۴ֲ#p
0<EFBFBD>6<EFBFBD><EFBFBD>,;<00>a4C<><43><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>os<6F>B<EFBFBD><42><06>T޽<54>Őo<00><18><>[<5B>|ۓ<><DB93><EFBFBD><EFBFBD><EFBFBD>W_dG<00>>2<00><><EFBFBD><EFBFBD><08><>7<EFBFBD>0`WWX<7F><58>X<EFBFBD><58><EFBFBD><0F><>0<>ϳ#@&<18>!<21>x<EFBFBD>l<EFBFBD><6C>n߿<6E><DFBF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>y<EFBFBD><79><EFBFBD><EFBFBD>+X<><58><EFBFBD>|n4#<23><><EFBFBD><00><0C>`H<>'<27><><EFBFBD><EFBFBD><EFBFBD>Mn<4D><6E><EFBFBD>h<EFBFBD><68>Fl<46><6C><EFBFBD>#sћ)<29><00>`<00>d}<7D><>U<EFBFBD>[<5B>r<EFBFBD><72>R#<23><><EFBFBD><EFBFBD>\m
(<00><>hJP<4A>(a<><00><>>}<7D>pu<70><75><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Щ<EFBFBD>N<EFBFBD><4E><EFBFBD>/<2F><06><>|@	
0%(<28><00>k<EFBFBD>eG@<06><>/]<00>5<EFBFBD>Ͳ#<23><03><><EFBFBD>.<2E><><1F><><EFBFBD>P<EFBFBD><00><>?<3F><01>q<EFBFBD><00>o<EFBFBD><6F>9'<27>`JP<4A>(A<00><04>0T<30><54>ݞ<EFBFBD><DD9E>~k<><6B><EFBFBD>l\d<>w<EFBFBD>\j<>r<><72><EFBFBD><EFBFBD><00>` <20>Y183<18>aV<00><>h<00>d<EFBFBD>0<EFBFBD><30>~<7E><><EFBFBD><17><><EFBFBD><EFBFBD><0F>J<06>o=<3D><>7칞<37><ECB99E><00><>d<00><>O?<1C>E<EFBFBD><45>_<EFBFBD><5F>{<7B>O<EFBFBD><4F><EFBFBD>Wx<1E><>ݳ<EFBFBD>/<2F>SP<>!<21><00>ϼ<>^Q<><51><EFBFBD>.<0E><><17>+
<EFBFBD>^<5E><>0t
0%(<28><00><>P<>@	
0%(<28><00><>P<>@	
0%\f<00>'<27><>z<EFBFBD><7A>y<EFBFBD><79>;`)<00>,<18><>ۿ	<00>
@	
0%
<0A>P}<7D><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><7F><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>o?<3F>cϕ<63>9<><39>U8<>$;}<7D><><EFBFBD><EFBFBD>S<><53>x<>F<EFBFBD>x<EFBFBD>V<EFBFBD><0F>ڸ<EFBFBD><DAB8>?<3F>k<EFBFBD><6B>{<7B><>Ev
<00>1<00>`J0<1A>
<0A>f(<0C>>XD<58><44><EFBFBD><EFBFBD>C<>`<00><><EFBFBD>~<01><>P<>@	
0%(<28><00><>P<>@	
0%(<28><00><>P<>@	
0%(<28><00>0<EFBFBD>@E<>>~Ȏ@<40>g<EFBFBD>_dG<18><>Ȏ@<40><>ֲ#<00>[k-;02<30><32><EFBFBD><00><>a<00>_<EFBFBD>}<7D>Zˎ<00><>"";<00>@a<><61><EFBFBD><00><>Zk<5A><18><>Ȏp<><70>Ȏ<00>c<11>`<60>"";䋈<>c<>O<EFBFBD><00><>"";<00>"";<00><><EFBFBD>ֲ#;<3B>ֲ#p<><70>]<00>&"<22>#<00>K<11><00><><EFBFBD>8<00>t<EFBFBD><74><EFBFBD>0@>I<00><><EFBFBD><EFBFBD>)Zk<5A>`<60><>Ȏ<00><><EFBFBD><18><>Zvz<>gD`<0F>@DDvF*"<22>#@_<>ֲ#<14>_<EFBFBD><5F><EFBFBD>j~3<><33>IEND<4E>B`<60>
-												Add the galaga example: a C engine with akbasic as its enemy brain

A GALAGA-style fixed shooter whose engine is C on libakgl (null physics)
with the interpreter embedded as the scripting engine that owns every
enemy's behavior. One DEF-only script is called per enemy per frame
through a custom akgl_Actor update hook; SELF@, ACTOR@ and GAME@ are host
bindings, so the script reads and writes the engine's real memory -- the
boss even swaps its own damage sprite by raising an actor state bit from
BASIC. Bullets, collision, scoring and screens stay C.

Structure arguments were measured and rejected for the per-frame path:
each pointer parameter spends a value-pool slot the pool never reclaims,
1,015 calls to exhaustion against an unbounded rebind (issue #36).

Built when AKBASIC_WITH_AKGL=ON. Two CTest entries: a 600-frame headless
autoplay run under the dummy SDL drivers, and an interop round-trip test
that links the real script.c and galaga.bas and pins the four boundary
claims, 24,000 sustained calls among them. docs_galaga_figures
regenerates the two checked-in figures. Art is Kenney CC0, byte for
byte, with provenance.

Co-authored-by: andrew <andrew@aklabs.net>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XiGgpHuXUm2mR4Wzndw3dc

											
										
										
											2026-08-04 08:47:21 -04:00
+								<EFBFBD>PNG
 IHDR<03><00><>C.GIDATx<54><78>ݱ<EFBFBD><1B>ॱ<0F>B|<7C>,z<03>$<24><>ݹ	 <20>Iq<49><71><EFBFBD><EFBFBD>Ngo<67>")<29>@<1A><>.UZ<55><5A><EFBFBD><EFBFBD>y<00><>#<23>p<EFBFBD>л\<5C>Krxf<78>|_<><5F>83<38><33>`<60><><EFBFBD>w<EFBFBD>^\@<40><>ֲ#}<11><00><>٧<00><>h<EFBFBD>eG<00>=EDv<00>l<EFBFBD>v<00>p#<00>Zk<5A>F""<22>#<00>?nG<00><><EFBFBD><EFBFBD><00><01><><EFBFBD>0R<11><00>DZk<5A>8<11><><00>@<40>ֲ#<00>Hk-;U<>ֲ#<00><><EFBFBD><EFBFBD><00><11>`O<11><00>0|8#<23>@<00>a<EFBFBD><61><00><>Zˎ;<3B>U6<><36><EFBFBD>pN<70><4E>'<27>\.<13>><3E>N<13><>ݑG&w<>>׸<0F><><EFBFBD>1<EFBFBD>><3E>'<27>Yv8<00>`JP<4A>(A<00><00>`JP<4A>(A<00><>Iv<00>ݖ<EFBFBD><DD96>1<EFBFBD><31><EFBFBD><EFBFBD><1E><><EFBFBD>7o<37>Y|:<3A><1E><>NG<1E>#u<>wG<77>Z<EFBFBD>G><3E><><EFBFBD><18>{w<>}ME(<28><><00><16><>װ <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?<3F><>ޝq_S@<11>@Љ<>Zv<5A><76>Q<EFBFBD><06>o<EFBFBD>N<1E><>f<EFBFBD>~G<18><><EFBFBD>:<00>?<00>`JP<4A>z<><7A><EFBFBD>]S<>z<><7A><EFBFBD>]S<>(<28>2;@<40><><EFBFBD><EFBFBD>fG<00><><EFBFBD><0E>("<22><>y<EFBFBD><79><EFBFBD>t<EFBFBD>v<EFBFBD><76>X.<2E><>,><3E>NO<4E><4F><EFBFBD>r<EFBFBD><72><EFBFBD><EFBFBD>sU><3E><><EFBFBD><EFBFBD>y<><79><EFBFBD>3<04>s#<00>b<<05>s#<00>b<<00>P<EFBFBD>(A<00><00>`JP<4A>(A<00><><EFBFBD><EFBFBD><00>^<5E>|<7C><>ի<EFBFBD><D5AB>}}<7D><><EFBFBD>w<EFBFBD><77><EFBFBD>I<EFBFBD>:Y<><59>Ǹ<EFBFBD><01><>d<00>m<EFBFBD>\<1E><>t:<3A><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>޽;f<><66>l}<7D>#<23>=W<><57><1F><>\<5C>{G[w<>wg<77>WP<>!<21><00><>P<>@
 %(<28><00><>P<><02>0DDv`<60>`<60>a><3E>gG<00>M<00><>Iv<00>ݖ<EFBFBD><DD96>1<EFBFBD>O<EFBFBD>S[<5B><>a<EFBFBD>|<7C>m<EFBFBD><6D><EFBFBD><01><>7<EFBFBD><00><>P<>@
 %(<28><00><>P<>@
 								p/<2F>ֲ#<00><><02><0B><>,;<00><>)<29><00><>P<>@
 %(<28>p2<70><32>}<7D><03><>x<EFBFBD>?<00><>@
 %(<28><00><>P<>@	<09><>v<>N<EFBFBD><4E>߰\.<2E><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>I<EFBFBD>ܷ3)<29>><3E><>]__'n}<7D>\<5C>tg<74><00><04> <20>Z<EFBFBD><1F><>ܵ#<23>
z<><7A>*<1F><>+<2B><><EFBFBD>1<EFBFBD>><3E>'a4<>h<EFBFBD>eG<65>i<EFBFBD>2P<>9<EFBFBD>l6ˎ<36><CB8E>8e<00>P<>@
 %(<28><00><>P<>@
 pqq<11>`MDdGƦ<><C6A6><11><00><>Iv*<2A><><EFBFBD>Cv<04>={<7B>";<00>\fx<><78><EFBFBD><EFBFBD><EFBFBD><EFBFBD>)8<><38><EFBFBD><EFBFBD><EFBFBD>H<>X<EFBFBD>eG<00><>ϲ<<3C><><00><><EFBFBD>T<EFBFBD>-"<22>#<00><><00><><EFBFBD><EFBFBD>r)<29><00><>P<>@	C<>	<09><>3;<3B><><EFBFBD><EFBFBD>
 								<EFBFBD><EFBFBD><EFBFBD>
0%(<28><00><>P<>{<7B><18><>?<3F>Ӟ<EFBFBD><D39E><EFBFBD><EFBFBD><EFBFBD>d=<07>|熎\|<7C><><EFBFBD>;<00><>o<EFBFBD>Kh<4B>eGH<><00>0<EFBFBD>Ͳ#$3<1A>!<21>8d<38><64>/<2F>x<EFBFBD><78><EFBFBD>?<3F><><EFBFBD>R<1B><><EFBFBD>\|<7C>;w<>><3E>x<EFBFBD>_Q<><51>}<07>^Q<><18>o<EFBFBD>y<EFBFBD><79>ō-<2D><><EFBFBD>7<EFBFBD>3W<33>}<07><>2<00>|<0C>8<19>ܣ0N<30>Cv<43><76><EFBFBD>h<EFBFBD><68><EFBFBD><EFBFBD><EFBFBD><00>d4%(<28><00>`4C<>>6x5`<60><><1F>o_<6F>'O0ޙ<30>FS<03><><0C><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>'x<>ى<EFBFBD><D989>}<7D>a`<60>!<21>۴ֲ#p
 <EFBFBD>6<EFBFBD><EFBFBD>,;<00>a4C<><43><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>os<6F>B<EFBFBD><42><06>T޽<54>Őo<00><18><>[<5B>|ۓ<><DB93><EFBFBD><EFBFBD><EFBFBD>W_dG<00>>2<00><><EFBFBD><EFBFBD><08><>7<EFBFBD>0`WWX<7F><58>X<EFBFBD><58><EFBFBD><0F><>0<>ϳ#@&<18>!<21>x<EFBFBD>l<EFBFBD><6C>n߿<6E><DFBF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>y<EFBFBD><79><EFBFBD><EFBFBD>+X<><58><EFBFBD>|n4#<23><><EFBFBD><00><0C>`H<>'<27><><EFBFBD><EFBFBD><EFBFBD>Mn<4D><6E><EFBFBD>h<EFBFBD><68>Fl<46><6C><EFBFBD>#sћ)<29><00>`<00>d}<7D><>U<EFBFBD>[<5B>r<EFBFBD><72>R#<23><><EFBFBD><EFBFBD>\m
 								(<00><>hJP<4A>(a<><00><>>}<7D>pu<70><75><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Щ<EFBFBD>N<EFBFBD><4E><EFBFBD>/<2F><06><>|@
 %(<28><00>k<EFBFBD>eG@<06><>/]<00>5<EFBFBD>Ͳ#<23><03><><EFBFBD>.<2E><><1F><><EFBFBD>P<EFBFBD><00><>?<3F><01>q<EFBFBD><00>o<EFBFBD><6F>9'<27>`JP<4A>(A<00><04>0T<30><54>ݞ<EFBFBD><DD9E>~k<><6B><EFBFBD>l\d<>w<EFBFBD>\j<>r<><72><EFBFBD><EFBFBD><00>` <20>Y183<18>aV<00><>h<00>d<EFBFBD>0<EFBFBD><30>~<7E><><EFBFBD><17><><EFBFBD><EFBFBD><0F>J<06>o=<3D><>7칞<37><ECB99E><00><>d<00><>O?<1C>E<EFBFBD><45>_<EFBFBD><5F>{<7B>O<EFBFBD><4F><EFBFBD>Wx<1E><>ݳ<EFBFBD>/<2F>SP<>!<21><00>ϼ<>^Q<><51><EFBFBD>.<0E><><17>+
 								<EFBFBD>^<5E><>0t
 %(<28><00><>P<>@
 %(<28><00><>P<>@
 %\f<00>'<27><>z<EFBFBD><7A>y<EFBFBD><79>;`)<00>,<18><>ۿ	<00>
@
 %
<0A>P}<7D><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><7F><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>o?<3F>cϕ<63>9<><39>U8<>$;}<7D><><EFBFBD><EFBFBD>S<><53>x<>F<EFBFBD>x<EFBFBD>V<EFBFBD><0F>ڸ<EFBFBD><DAB8>?<3F>k<EFBFBD><6B>{<7B><>Ev
 								<00>1<00>`J0<1A>
<0A>f(<0C>>XD<58><44><EFBFBD><EFBFBD>C<>`<00><><EFBFBD>~<01><>P<>@
 %(<28><00><>P<>@
 %(<28><00><>P<>@
 %(<28><00>0<EFBFBD>@E<>>~Ȏ@<40>g<EFBFBD>_dG<18><>Ȏ@<40><>ֲ#<00>[k-;02<30><32><EFBFBD><00><>a<00>_<EFBFBD>}<7D>Zˎ<00><>"";<00>@a<><61><EFBFBD><00><>Zk<5A><18><>Ȏp<><70>Ȏ<00>c<11>`<60>"";䋈<>c<>O<EFBFBD><00><>"";<00>"";<00><><EFBFBD>ֲ#;<3B>ֲ#p<><70>]<00>&"<22>#<00>K<11><00><><EFBFBD>8<00>t<EFBFBD><74><EFBFBD>0@>I<00><><EFBFBD><EFBFBD>)Zk<5A>`<60><>Ȏ<00><><EFBFBD><18><>Zvz<>gD`<0F>@DDvF*"<22>#@_<>ֲ#<14>_<EFBFBD><5F><EFBFBD>j~3<><33>IEND<4E>B`<60>