Material Test Suite OXP
The Material Test Suite is an expansion pack which tests Oolite’s material model and built-in shaders. It was created during the testing phase before version 1.76 to test material functionality across different platforms and hardware. It may be useful in diagnosing some rendering problems.
To run the test suite:
- Download the test suite and install it. (Oolite test release 1.75 or later required. For information on installing expansion packs, see the “OXP” article.)
- Run Oolite, and decline when asked whether you want to load a game. (If you are using Strict Mode, disable it and restart Oolite.)
- You should now be presented with an information screen and the options “Run test suite” and “Cancel”. Select “Run test suite”.
- You will now be shown a series of spinning cubes. The precise number shown depends on your system’s capabilities. A successful test shows a grey box with a number on it (see sample images below). A failed test will show something else, typically a solid black box.
- Please take a note of any failed tests, writing down the label shown on the left of the screen (such as “simple: 3”). If it is something other than a solid black or red box, please also take a screen shot (“*” key).
- While you’re at it, we’d appreciate if you tested dust rendering. When the test suite is complete, leave the station and fly away until you are no longer mass locked. Fly at normal speed and at hyperspeed (default: “J” key). Note whether you see dust particles flying past. Test this in every available shader mode (to change shader mode, pause, press “2” or “F2”, and select “Game Options…”).
If all the tests work and dust is nicely dusty, we’re done. You can throw out the Material Test Suite expansion pack and get back to playing the game. Otherwise, please report the problem:
- Quit Oolite and open the log file. (To locate the log file, see the FAQ entry on diagnosing problems.)
- Copy the lines between “
========== [Marker 1] ==========” and “
========== [Marker 2] ==========”. Paste them into an e-mail to firstname.lastname@example.org or this forum thread (or send the whole log as an attachment). Don’t forget to specify which tests failed!
If your tests passed, feel free to report anyway. Confirmation that we’re doing something right is good for our egos. But if they failed, we really need to know. We can’t fix problems we don’t know about.
Click the images for a bigger view. Note that tests 8–16 will not be shown on systems without GLSL shader support.
Note that the number 2 glows green in the dark.
Note that the number 3 and the ring both glow green in the dark.
Note that number 4 is illuminated as though by a spotlight (with a slightly blue tint).
Note that the number 5 and the ring both glow with a dull blue tint.
Note that the number 6 is illuminated as in test 4, and the ring glows with a slight green tint.
When rendered correctly, the effects should be the same as in test 6.
Note the shadows and highlights around the inside of the ring, which conform to the main light source, producing the effect of an indentation containing the number 8.
This should look similar to test 8, but with slightly better perspective. If you noticed a “creeping” effect in test 8, it should be alleviated in test 9. This is more noticeable if you look at the tests again.
The number 10 and the ring glow as in test 3, and the interior of the ring is indented as in test 9.
The ring is white and the number 11 glows green, as in test 2, and the interior of the ring is indented.
The ring glows and the indented area around the number is illuminated as though by a spotlight, as in tests 6 and 7.
Note that the number 13 is only visible as a variation in the glossiness of the surface, and completely invisible in shadow.
Note that the number 14 and the ring are only visible as a variation in the glossiness of the surface, and the cube is uniformly grey in shadow.
A shiny surface as in tests 13 and 14, but width a glowing number 15.
Everything all at once: like test 12, but with the varying shininess from tests 13–15.
Bug: For unknown reasons, the shininess of test 16 does not match that of tests 13–15.