singe/testScripts/README.md
2026-09-05 19:52:04 -05:00

26 lines
1.8 KiB
Markdown

# Test scripts
The Lua scripts used to verify the 3D scene and physics work, one per stage
of PLAN.md sections 18 and 19, with everything they load: the Khronos
Duck, Fox and BoxAnimated sample models under Models/, and Box.png. The
disc and the font are the engine's own, addressed as
Singe/menuBackground.mkv and Singe/FreeSansBold.ttf like any engine
asset. This directory is a complete Singe game directory. Run one from the singe directory with
.builddir/Singe-v3.00-Linux-x86_64 -w -d data -v Singe/menuBackground.mkv testScripts/scene6.singe
or pack it (singe --pack testScripts testScripts.game) and run an entry
with --entry N (the numbers follow games.dat). Every script takes a
screenshot or two and quits by itself; the results are in screenshots/.
| Script | Entry | Stage | What it shows |
|-----------------|-------|-------|------------------------------------------------------------|
| scenetest.singe | 1 | 18.1 | The 3D layer: a translucent colour over the disc, text on top |
| scene2.singe | 2 | 18.2 | Primitives, materials, lights, camera, sceneProject label |
| scene3.singe | 3 | 18.3 | glTF models: two Ducks, BoxAnimated, loose and packed |
| scene4.singe | 4 | 18.4 | Node animation at three speeds, one paused |
| scene5.singe | 5 | 18.5 | Skinning: three Foxes in Survey, Walk and Run |
| scene6.singe | 6 | 18.6 | The disc and a loaded video as materials, sceneUnproject |
| scene7.singe | 7 | 18.6b | Shadows: sun, sun and spot together, a point light inside |
| scene8.singe | 8 | 18 | An arcade cabinet from primitives with the disc on screen |
| scene9.singe | 9 | 19.2 | Physics: a crate stack, a ball, a kinematic paddle |