# 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, BoxAnimated and AnimatedMorphCube sample models under Models/, Box.png and crate.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

(scene12 has no disc:  give it -C 720x480 instead of -v)

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        |
| scene10.singe   | 10    | 19.3  | Physics:  a trigger volume, collision callbacks, a raycast pick |
| scene11.singe   | 11    | 19.4  | Physics:  a hull down a ramp, a mesh torus, hinge, ball and slider joints |
| scene12.singe   | 12    | 19.6  | 2D physics drawn with sprites; runs with no GPU (SDL_GPU_DRIVER=nothing) |
| scene13.singe   | 13    | 18.8  | Morph targets:  the AnimatedMorphCube, animated and driven from script |
| scene14.singe   | 14    | -     | The solid tangram dragon (Models/DragonModel.glb, a copy of assets/DragonModel.glb) turning under a sun with shadows |
| scene15.singe   | 15    | -     | The Singe logotype as solid letters (Models/SingeText.glb, a copy of assets/SingeText.glb) turning under a sun with shadows |
| scene16.singe   | 16    | -     | The dragon perched on the logotype, both models under one parent node, turning together |