Difference between revisions of "Material Test Suite OXP"

Revision as of 18:05, 26 June 2010

The Material Test Suite is an expansion pack which tests Oolite’s material model and built-in shaders. We request that as many people as possible try out the test suite, on as many machines as they can – within reason – and on multiple operating systems if practical.

To run the test suite:

Download the test suite and install it. (For information on installing expansion packs, see the “OXP” article.)
Run Oolite, and decline when asked whether you want to start a new 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 successfull 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 sold 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 bugs@oolite.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 ego. But if they failed, we really need to know. We can’t fix problems we don’t know about.