# Copper Courier: gedeelde platformengine (eerste proefversie)

Een eigen robot-koerier verzamelt kristallen, springt over gaten en op
platforms,
ontwijkt of verslaat patrouillerende robots en bereikt de eindvlag. Het
level,
de personages en de rastertekeningen zijn oorspronkelijk voor deze demo
gemaakt.
Er zijn drie levens, twaalf optionele kristallen en een scrollend level van
80 bij 12 tegels. Kristal:10 punten, vijand van boven raken:100,
eindvlag:500.

## Algemene game-library

Nieuw: de pygame-achtige `STGAME.PY` boven dezelfde native C-kern.
`PLAY.PY` en `PLAY.BAS`/`PLAY.TBP` zijn de Sprite Lab-platformdemo's met
eigen
spelregels, sprites, toetsenbord, vaste tijdstappen en rechthoekbotsingen.
Open die bestanden en druk F5. Uitleg: `STGAME.TXT` naast de programma's;
volledige API in CANVAS.md (Python-docs/stgame-nl.md, BASIC-docs/game-
library-nl.md).
Dit is een eerste functionele proefversie; performancewerk blijft nodig.
Copper Courier hieronder blijft de aparte native platformscene-demo.

## Starten

- BASIC: open C:\TTBASIC\PLATFORM.TBP in Studio, dan F5/Ctrl+R.
- Python: open C:\TTPY\PLATFORM.PY in Studio, dan F5/Ctrl+R.
- De BASIC-demo is ook als zelfstandige PLATFORM.PRG meegeleverd; die werkt
  zonder Studio of losse bronbestanden. Starten in ST Low is zo mogelijk.
- Python in de losse console: start TTCON.PRG vanuit de TTPY-map en voer
  `import PLATFORM` uit. De sourcefile moet naast de console staan.

Pijlen links/rechts of A/D: lopen. Spatie, omhoog of W: springen.
P: pauze/hervatten. F: compact/vergroot als het scherm groot genoeg is.
R: nieuw spel met drie levens en alle kristallen/vijanden terug.
Escape: spel sluiten en terug naar de editor/desktop.
Na winnen of alle levens verliezen blijft het resultaat zichtbaar tot
R/Escape.

## Eerste engine, huidige grenzen

Kale TOS 2.00+; 68000-code zonder FPU; ingebouwde Atari planar schermen met
1..8 bitplanes en minimaal320x200. De Studio's zelf vragen hun gebruikelijke
hogere resolutie; zelfstandig BASIC en de losse Python-console kunnen ST
Low.
TOS1.x wordt voor de game-toetsenbordkoppeling nog niet ondersteund.
Native beeldproeven dekken ST High, TT Medium en Falcon VGA640x480x256
(RAM-TOS4.04); rastertests dekken1/2/4/8 bitplanes. Fysieke
hardwarevalidatie
blijft open.

Intern320x200; grotere schermen kunnen 2x vergroot worden. ST High start
compact om de software-renderer te ontlasten; F vergroot. De physics
gebruikt
vaste stappen van40ms met begrensd inhalen bij trage frames. De werkelijke
beeldverversing hangt van machine en beeldmodus af; geen50fps-garantie.
De ST-renderer is nog een performanceproef. Dit is een platformscene-engine,
nog geen algemene sprite-/asset-editor, joystick- of
tilemapbestandsbibliotheek.
De levelkaart staat leesbaar in het BASIC- of Python-programma.

Korte YM2149-tonen zijn ingebouwd. De geautomatiseerde controles gebruiken
uitgeschakeld emulatorgeluid; geluidskwaliteit is nog niet beluisterd.
Fysieke ST/TT/Falcon-validatie staat open. Er worden geen schermmodi
gewijzigd.
Normaal sluiten herstelt scherm, palet, muis, toetsenbordvector/-herhaling
en
PSG-registers. Pythonexcepties/BASIC-runcleanup sluiten de game ook.

## API in beide talen

BASIC `Game.Open("titel")`, Python `game.open("titel")` na `import game`.
Configureer vervolgens twaalf regels met `Game.Row(index, "...")` of
`game.row(index, "...")`, index0..11, tot96 tegels breed.

| Teken | Betekenis |
| --- | --- |
| . | Lucht |
| # | Massieve tegel |
| = | Platform: van onder doorheen, van boven landen |
| ^ | Gevaarlijke tegel |
| P | Een startpunt |
| o | Kristal (max32) |
| e | Patrouillerende vijand (max12) |
| G | Een eindvlag |

Er moet precies een P en een G zijn. `Run()` / `run()` start de native
spellus en keert terug na Escape. De returnwaarde is0 spelend,1 gewonnen,
2 levens op,3 verlaten. `Step()` / `step()` levert per getekend frame een
Boolean en kan gebruikt worden voor een eigen taalgestuurde lus. Tijdens een
actieve scene kun je de kaart niet vervangen.

`State`, `Score`, `Lives`, `X`, `Y`, `Frame` (Python: kleine letters) lezen
spelstatus. `Reset/reset` herstart, `Pause/pause` wisselt pauze.
`Close/close`
herstelt de desktop en mag ook worden aangeroepen als het spel al dicht is.
Gebruik Try/Finally of try/finally zoals in de demo's.

## Bron en controles

GAME.H, GPHYS.H, GAMECORE.H en GKEYS.H zijn exact dezelfde kern in beide
projecten (alleen CRLF verschilt). `tools/sync_game_engine.py`
synchroniseert
ze. De native spellus, physics en rasterweergave draaien in C; beide talen
maken en starten de scene via hun eigen adapter. Geen aparte engine-PRG
nodig.

`tools/make_platform_demo.py` genereert beide bronvoorbeelden uit hetzelfde
level. `tests/check_sources.py` controleert kaart en kernbestanden.
`tests/test_world.c` test physics, eenrichtingsplatforms, botsingen, vallen,
levens, kristallen, stomp, pauze, eindvlag en een replay van het echte
level.
Die replay bereikt de vlag na578 stappen met drie levens en zeven
kristallen.
`tests/smoke_native.py` bedient de echte binaries op geisoleerde Hatari-
schijven.

Het toetsenbord gebruikt de TOS2+ kbdvec-entry voor make/break-statussen,
met
XBRA-keten en behoud van alle registers. Referenties:
https://github.com/czietz/keyboard-injector
https://freemint.github.io/tos.hyp/en/index.html

Eigen code/tekeningen: GPLv3, zoals beide Studio-projecten. Zie LICENSE.
