examples/galaga/assets/art/enemyGreen3.png

<EFBFBD>PNG


IHDRgT<00><>)<29>
<0A>IDATx<54><78>]is<15><15><1F>'P<>o<EFBFBD>D<EFBFBD>P<EFBFBD>T%e<17>ˉ#ր<><D680>X6<><36><EFBFBD>ll#F<>#<23><06><>3\<02>(LE`<60>QD,A<>
`VQl<51>V<EFBFBD>:s&<26>/<2F>Z<EFBFBD><5A><EFBFBD><EFBFBD><EFBFBD>0Su<53><75><EFBFBD>f<EFBFBD><66>t<EFBFBD>s<EFBFBD><73>~=Æ
<0A><><EFBFBD><EFBFBD>a<EFBFBD><61>Ç<EFBFBD>'O<><4F><EFBFBD>---U<><55><EFBFBD><EFBFBD>
{u<><75>v<EFBFBD><76>U<EFBFBD><55>f_:t<><74>>}:r<>߿<EFBFBD><05><><0B>7<EFBFBD>U<EFBFBD>ƼG<04>ٱ{<7B>n<EFBFBD>@߻w/Rܾ}<7D>=z<>ѽ<EFBFBD><D1BD>f_͢<5F>W<EFBFBD>wUԑ<55><D491><EFBFBD><EFBFBD><0B><>Ç<EFBFBD><C387><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ݻ,Hol<6F>޽Ћ`<15><>m<EFBFBD>6:<3A><>n<02>ĉ<13><>ի<EFBFBD>ƍ<1B><><EFBFBD>Ǳ<EFBFBD><C7B1><EFBFBD>~x<><78><EFBFBD>^<5E><><EFBFBD><EFBFBD>ϢVpګ<70>W\H1A'<27>R<EFBFBD><52><EFBFBD>.]<5D>v&ųg<C5B3>b<EFBFBD><62><EFBFBD>ѣ<EFBFBD><D1A3>uuu<75><75><EFBFBD><EFBFBD><07><><EFBFBD><EFBFBD>q<><71>)<29><>:r<>H<07><1A><><EFBFBD>B<EFBFBD><42>;<3B>"0<08><񞘕<>
<EFBFBD>͢={<7B>t<EFBFBD><74><EFBFBD><EFBFBD>T_<54><5F><EFBFBD><EFBFBD>_<0E>
@)V<><56><EFBFBD><EFBFBD>v<><76><EFBFBD>\Ǡ<><C7A0>rd<72><64><EFBFBD><EFBFBD><EFBFBD>3Ovo<76>E<EFBFBD>6z<17>2<00><1E><><EFBFBD><EFBFBD><EFBFBD><0F>y<EFBFBD><06>x<><78><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>h<EFBFBD><68>sT<1D><00><><07>{fѱc<D1B1>r8p<38>]<5D>v-<2D><>ϟ?<14><>v<EFBFBD><02><><EFBFBD><11><>`6<><36><1C><>\<07>3<EFBFBD><33>u<EFBFBD><75><EFBFBD>f<><66>YP<59>4<EFBFBD><34><EFBFBD><EFBFBD><17>?<3F>=<14><>3ghe<>j:ˢiO<69>>
<1B><><EFBFBD>6<16>F:C<>ME2<>Ν;w<><77>	<09>H<EFBFBD><03><>"<22>L<EFBFBD><4C><EFBFBD><05>tH<03><><EFBFBD>c<EFBFBD>Q<EFBFBD>^<5E>~<7E><><EFBFBD>ض<EFBFBD>(<28><>hQN<51>#<23>"<00><>\<5C>r<EFBFBD><00>2#<23><>9<>s<><73><EFBFBD>\sƇR<C687>Ӓ병vI<76><49><EFBFBD><EFBFBD>x<EFBFBD>"<01>:$x<><00>T<EFBFBD><54><EFBFBD><EFBFBD>\;<3B><>͛<EFBFBD><CD9B><EFBFBD><EFBFBD>iS@<40><>݃<EFBFBD><DD83><EFBFBD><0B><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Y(<00>-<2D><><EFBFBD>U<EFBFBD><55><00>-<2D><>u<05>f<>l&R<><52><EFBFBD><EFBFBD>P@<40>(<00><><EFBFBD>C#M<>9)m#<23>eA<65><41><EFBFBD>=^ `<60>Ph3&C@gNbFE<46>_2<5F><32>LW<4C><57><EFBFBD>GwO,h<>Z0<02>ߚ	y<06>6)<29>(<28><>KF<4B><46>uD<75>	f<>1]r<0B>lA-4!-m:#Еw<D095><y<>9M|<7C><>Q<EFBFBD>X-<2D>*$$<24><>M<EFBFBD>|<>?<3F><>i<EFBFBD>3<EFBFBD><33><06><><EFBFBD>g<>iik<69>^<5E><>@<18>*<2A>#<23><>J䩚G<0F><><EFBFBD><15>fg<66><13>ܺu<DCBA>;8<>r<EFBFBD><72>f<EFBFBD>W<EFBFBD><57><EFBFBD><EFBFBD><15><><EFBFBD>Ǭ<EFBFBD><C7AC>e	<09><><EFBFBD>'x<>h6<>I
\]<5D>Љw|<7C>h
<EFBFBD>I<17>ٺ<EFBFBD><D9BA>ỻ<00>4؟<34>:<06>i<EFBFBD>yѯ<79><D1AF>=<3D>8F<>-<2D><>.C<>r<EFBFBD><72><06><><EFBFBD>}M<><4D>0=۬<>Ξ=<3D><><EFBFBD><EFBFBD>r<EFBFBD>u<EFBFBD><75><EFBFBD>U0<08>D[<5B><>-<2D>)<29>.m<><06><><00>w秊U<EFA695><55>@<40>9ͺ@
<10>A<EFBFBD><41><EFBFBD>/<2F><>UN<55>|#<06>4ҵ͚*q<07>_hڬ;<3B><>vJ<1B><>;<3B>e4ҥ+<2B><><00>y9؉,Py<50>R<>F2c<32><63>UY==W>0<><30>K	<09>H<>Z<EFBFBD><5A>f<EFBFBD><66><EFBFBD>l<EFBFBD><6C><EFBFBD>ʶ<EFBFBD>Om<4F><6D>-P[<5B><><EFBFBD><EFBFBD>iV)30|Y<>*V<16>M<EFBFBD>k<EFBFBD><6B>crH<16>{<7B><>7<EFBFBD>1<EFBFBD><31>:&9M|<7C><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>k&<26><><EFBFBD>f+<2B><>M<EFBFBD>~+<2B><><EFBFBD><EFBFBD><EFBFBD><14>9<EFBFBD>*<2A>,<2C>E<EFBFBD><45>!0<>5uyG%<25><><EFBFBD> [<5B>G<EFBFBD>2@S<>&8<>7z<><7A>><3E><><05>Fb<0E><><EFBFBD> t<>!	m<04><><EFBFBD><EFBFBD>ʗGj<47><6A>"0"M<>#*5<>
-												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
 IHDRgT<00><>)<29>
<0A>IDATx<54><78>]is<15><15><1F>'P<>o<EFBFBD>D<EFBFBD>P<EFBFBD>T%e<17>ˉ#ր<><D680>X6<><36><EFBFBD>ll#F<>#<23><06><>3\<02>(LE`<60>QD,A<>
 								`VQl<51>V<EFBFBD>:s&<26>/<2F>Z<EFBFBD><5A><EFBFBD><EFBFBD><EFBFBD>0Su<53><75><EFBFBD>f<EFBFBD><66>t<EFBFBD>s<EFBFBD><73>~=Æ
<0A><><EFBFBD><EFBFBD>a<EFBFBD><61>Ç<EFBFBD>'O<><4F><EFBFBD>---U<><55><EFBFBD><EFBFBD>
{u<><75>v<EFBFBD><76>U<EFBFBD><55>f_:t<><74>>}:r<>߿<EFBFBD><05><><0B>7<EFBFBD>U<EFBFBD>ƼG<04>ٱ{<7B>n<EFBFBD>@߻w/Rܾ}<7D>=z<>ѽ<EFBFBD><D1BD>f_͢<5F>W<EFBFBD>wUԑ<55><D491><EFBFBD><EFBFBD><0B><>Ç<EFBFBD><C387><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ݻ,Hol<6F>޽Ћ`<15><>m<EFBFBD>6:<3A><>n<02>ĉ<13><>ի<EFBFBD>ƍ<1B><><EFBFBD>Ǳ<EFBFBD><C7B1><EFBFBD>~x<><78><EFBFBD>^<5E><><EFBFBD><EFBFBD>ϢVpګ<70>W\H1A'<27>R<EFBFBD><52><EFBFBD>.]<5D>v&ųg<C5B3>b<EFBFBD><62><EFBFBD>ѣ<EFBFBD><D1A3>uuu<75><75><EFBFBD><EFBFBD><07><><EFBFBD><EFBFBD>q<><71>)<29><>:r<>H<07><1A><><EFBFBD>B<EFBFBD><42>;<3B>"0<08><񞘕<>
 								<EFBFBD>͢={<7B>t<EFBFBD><74><EFBFBD><EFBFBD>T_<54><5F><EFBFBD><EFBFBD>_<0E>
 								@)V<><56><EFBFBD><EFBFBD>v<><76><EFBFBD>\Ǡ<><C7A0>rd<72><64><EFBFBD><EFBFBD><EFBFBD>3Ovo<76>E<EFBFBD>6z<17>2<00><1E><><EFBFBD><EFBFBD><EFBFBD><0F>y<EFBFBD><06>x<><78><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>h<EFBFBD><68>sT<1D><00><><07>{fѱc<D1B1>r8p<38>]<5D>v-<2D><>ϟ?<14><>v<EFBFBD><02><><EFBFBD><11><>`6<><36><1C><>\<07>3<EFBFBD><33>u<EFBFBD><75><EFBFBD>f<><66>YP<59>4<EFBFBD><34><EFBFBD><EFBFBD><17>?<3F>=<14><>3ghe<>j:ˢiO<69>>
<1B><><EFBFBD>6<16>F:C<>ME2<>Ν;w<><77>	<09>H<EFBFBD><03><>"<22>L<EFBFBD><4C><EFBFBD><05>tH<03><><EFBFBD>c<EFBFBD>Q<EFBFBD>^<5E>~<7E><><EFBFBD>ض<EFBFBD>(<28><>hQN<51>#<23>"<00><>\<5C>r<EFBFBD><00>2#<23><>9<>s<><73><EFBFBD>\sƇR<C687>Ӓ병vI<76><49><EFBFBD><EFBFBD>x<EFBFBD>"<01>:$x<><00>T<EFBFBD><54><EFBFBD><EFBFBD>\;<3B><>͛<EFBFBD><CD9B><EFBFBD><EFBFBD>iS@<40><>݃<EFBFBD><DD83><EFBFBD><0B><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Y(<00>-<2D><><EFBFBD>U<EFBFBD><55><00>-<2D><>u<05>f<>l&R<><52><EFBFBD><EFBFBD>P@<40>(<00><><EFBFBD>C#M<>9)m#<23>eA<65><41><EFBFBD>=^ `<60>Ph3&C@gNbFE<46>_2<5F><32>LW<4C><57><EFBFBD>GwO,h<>Z0<02>ߚ	y<06>6)<29>(<28><>KF<4B><46>uD<75>	f<>1]r<0B>lA-4!-m:#Еw<D095><y<>9M|<7C><>Q<EFBFBD>X-<2D>*$$<24><>M<EFBFBD>|<>?<3F><>i<EFBFBD>3<EFBFBD><33><06><><EFBFBD>g<>iik<69>^<5E><>@<18>*<2A>#<23><>J䩚G<0F><><EFBFBD><15>fg<66><13>ܺu<DCBA>;8<>r<EFBFBD><72>f<EFBFBD>W<EFBFBD><57><EFBFBD><EFBFBD><15><><EFBFBD>Ǭ<EFBFBD><C7AC>e	<09><><EFBFBD>'x<>h6<>I
\]<5D>Љw|<7C>h
 								<EFBFBD>I<17>ٺ<EFBFBD><D9BA>ỻ<00>4؟<34>:<06>i<EFBFBD>yѯ<79><D1AF>=<3D>8F<>-<2D><>.C<>r<EFBFBD><72><06><><EFBFBD>}M<><4D>0=۬<>Ξ=<3D><><EFBFBD><EFBFBD>r<EFBFBD>u<EFBFBD><75><EFBFBD>U0<08>D[<5B><>-<2D>)<29>.m<><06><><00>w秊U<EFA695><55>@<40>9ͺ@
 								<10>A<EFBFBD><41><EFBFBD>/<2F><>UN<55>|#<06>4ҵ͚*q<07>_hڬ;<3B><>vJ<1B><>;<3B>e4ҥ+<2B><><00>y9؉,Py<50>R<>F2c<32><63>UY==W>0<><30>K	<09>H<>Z<EFBFBD><5A>f<EFBFBD><66><EFBFBD>l<EFBFBD><6C><EFBFBD>ʶ<EFBFBD>Om<4F><6D>-P[<5B><><EFBFBD><EFBFBD>iV)30|Y<>*V<16>M<EFBFBD>k<EFBFBD><6B>crH<16>{<7B><>7<EFBFBD>1<EFBFBD><31>:&9M|<7C><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>k&<26><><EFBFBD>f+<2B><>M<EFBFBD>~+<2B><><EFBFBD><EFBFBD><EFBFBD><14>9<EFBFBD>*<2A>,<2C>E<EFBFBD><45>!0<>5uyG%<25><><EFBFBD> [<5B>G<EFBFBD>2@S<>&8<>7z<><7A>><3E><><05>Fb<0E><><EFBFBD> t<>!	m<04><><EFBFBD><EFBFBD>ʗGj<47><6A>"0"M<>#*5<>