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

1.8 KiB

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