gtk2/tests/reftests
Benjamin Otte 42450cacd9 reftests: Modify test to ensure identical output
GtkArrow and the align properties use different methods (float vs int)
to center the arrow. If the size of the arrow is odd, this will cause a
rendering that differs by half a pixel. So we request an even size for
both the arrow and the container and everything works out.
2011-05-09 01:36:00 +02:00
..
alignment-props.css Add an alignment property test 2011-05-05 22:21:59 -04:00
alignment-props.ref.ui Add an alignment property test 2011-05-05 22:21:59 -04:00
alignment-props.ui Add an alignment property test 2011-05-05 22:21:59 -04:00
box-expand.css reftests: Add test for box expand handling 2011-05-05 17:33:04 +02:00
box-expand.ref.ui reftests: Add test for box expand handling 2011-05-05 17:33:04 +02:00
box-expand.ui reftests: Add test for box expand handling 2011-05-05 17:33:04 +02:00
box-packing.css Add a box-packing reftest 2011-05-04 20:40:22 -04:00
box-packing.ref.ui More box<>grid comparison tests 2011-05-05 17:13:28 -04:00
box-packing.ui More box<>grid comparison tests 2011-05-05 17:13:28 -04:00
entry-progress-coloring.css reftests: Add a test for correct entry text clipping in progress drawing 2011-05-03 15:40:49 +02:00
entry-progress-coloring.ref.ui reftests: Add a test for correct entry text clipping in progress drawing 2011-05-03 15:40:49 +02:00
entry-progress-coloring.ui reftests: Add a test for correct entry text clipping in progress drawing 2011-05-03 15:40:49 +02:00
grid-expand.css reftests: Add missing css file for grid-expand test 2011-05-05 19:34:31 +02:00
grid-expand.ref.ui reftests: Add a test for grid expand flags 2011-05-05 17:33:04 +02:00
grid-expand.ui reftests: Add a test for grid expand flags 2011-05-05 17:33:04 +02:00
grid-homogeneous.css reftests: Add grid-homogeneous test 2011-05-03 15:40:49 +02:00
grid-homogeneous.ref.ui reftests: Add grid-homogeneous test 2011-05-03 15:40:49 +02:00
grid-homogeneous.ui reftests: Add grid-homogeneous test 2011-05-03 15:40:49 +02:00
gtk-reftest.c reftests: Ensure we got a draw event before quitting the main loop 2011-05-05 17:33:04 +02:00
label-sizing.css reftests: Add label-sizing test 2011-05-03 15:40:48 +02:00
label-sizing.ref.ui reftests: Add label-sizing test 2011-05-03 15:40:48 +02:00
label-sizing.ui reftests: Add label-sizing test 2011-05-03 15:40:48 +02:00
label-small-ellipsized.ref.ui tests: Add a test for small ellipsized labels 2011-05-03 15:40:49 +02:00
label-small-ellipsized.ui tests: Add a test for small ellipsized labels 2011-05-03 15:40:49 +02:00
label-wrap-justify.ref.ui reftests: Add testcase for label justify fix 2011-05-05 17:33:44 +02:00
label-wrap-justify.ui reftests: Add testcase for label justify fix 2011-05-05 17:33:44 +02:00
Makefile.am reftests: Add misc-alignment test to Makefile 2011-05-09 01:12:29 +02:00
misc-alignment.ref.ui reftests: Modify test to ensure identical output 2011-05-09 01:36:00 +02:00
misc-alignment.ui reftests: Modify test to ensure identical output 2011-05-09 01:36:00 +02:00
nonresizable-size.ref.ui reftests: Test that nonresizable windows get the right size 2011-05-03 15:40:49 +02:00
nonresizable-size.ui reftests: Test that nonresizable windows get the right size 2011-05-03 15:40:49 +02:00
quit-mnemonic.ref.ui reftests: Add test for low mnemonics 2011-05-03 15:40:49 +02:00
quit-mnemonic.ui reftests: Add test for low mnemonics 2011-05-03 15:40:49 +02:00
README Convert the commit message into a README 2011-05-03 19:37:00 -04:00
simple.ref.ui
simple.ui
toplevel-vs-popup.ref.ui reftests: Actually add toplevel vs popup testcase 2011-05-09 01:10:13 +02:00
toplevel-vs-popup.ui reftests: Actually add toplevel vs popup testcase 2011-05-09 01:10:13 +02:00

gtk-reftest is a new test runner supposed to do a lot of generic tests.
Run it like this:

./gtk-reftest [OPTIONS] TESTFILE [TESTFILES...]

where FILE is a GtkBuilder ui file to run.

For a general test named "test", you want to have the following files:
1) test.ui
2) test.ref.ui
3) test.css (optional)
The test will then check that test.ui and test.ref.ui are rendered
identically with the provided css.

In detail, for every provided TESTFILE the test runner will:
1) Add the css to the default screen
2) Load the test.ui file and the test.ref.ui file
3) Grab the first GtkWindow subclass widget
4) gtk_widget_show() it and take a snapshot image of its contents into
   a cairo surface.
5) Compare the two images to be bitwise identical. If they are not, a
   diff image will be created hilighting the differences.
6) Save the images as png files to the output directory named:
   - test.out.png (rendering of test.ui)
   - test.ref.png (rendering of test.ref.ui)
   - test.diff.png (optional, differences from step 5)
7) Fail the test if the two images are not bitwise identical

Credit for the idea of reftests goes to Mozilla and in particular David
Baron. For a larger introduction of why reftests are useful, see
http://weblogs.mozillazine.org/roc/archives/2008/12/reftests.html