Using the X Test Suite

Build xts5

This is the tree with all the actual test code. It has a framework for running tests and comparing results, but I don't recommend using them. You can learn more about some of those tools in the README if you want.

Build xtsttopng

This tool takes the output logs of tests that generate image comparisons, remaps the pixel values to visibly different colors, and generates pngs for the two (-0 being the rendered image and -1 being the reference image).

Note that these images don't necessarily represent what was actually rendered, since the reference image is generated automatically, and for tests that don't care about some area of the drawable, it'll smash the areas it doesn't care about to a standard value in both the rendered and reference image.

Get piglit

Now, here's an example of using this to do some tests comparing two rendering modes in Xephyr. Xlib9 is the set of core rendering tests (not counting the window movement code, which also does rendering and is covered in another chapter).