cairo/test
Carl Worth 9bb1715159 Move surface-specific cairo_t functions to cairo.c.
Remove functions that have now moved to cairo.c.
A few new files to ignore now with new compilation mode using a libtool helper library.
2005-03-23 13:49:32 +00:00
..
.cvsignore Move surface-specific cairo_t functions to cairo.c. 2005-03-23 13:49:32 +00:00
buffer-diff.c test/imagediff.c 2005-01-25 14:45:31 +00:00
buffer-diff.h test/imagediff.c 2005-01-25 14:45:31 +00:00
buffer_diff.c test/imagediff.c 2005-01-25 14:45:31 +00:00
buffer_diff.h test/imagediff.c 2005-01-25 14:45:31 +00:00
cairo-test.c From Tor Lillqvist <tml@novell.com>: 2005-03-17 13:13:56 +00:00
cairo-test.h Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
cairo_test.c From Tor Lillqvist <tml@novell.com>: 2005-03-17 13:13:56 +00:00
cairo_test.h Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
clip-twice-ref.png Update these two once again, this time generated using libpixman-0.1.3 without leaky circles. 2005-01-27 12:28:17 +00:00
clip-twice.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
clip_twice-ref.png Update these two once again, this time generated using libpixman-0.1.3 without leaky circles. 2005-01-27 12:28:17 +00:00
clip_twice.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
coverage-ref.png Fix accidental commit of diff, rather than ref image. 2005-03-08 14:30:14 +00:00
coverage.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
fill-rule-ref.png Update reference images for new rasterization in libpixman 0.1.3. 2005-01-21 11:27:56 +00:00
fill-rule.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
fill_rule-ref.png Update reference images for new rasterization in libpixman 0.1.3. 2005-01-21 11:27:56 +00:00
fill_rule.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
get-and-set.c Move filename initialization up to before first use. 2005-03-09 14:34:26 +00:00
get_and_set.c Move filename initialization up to before first use. 2005-03-09 14:34:26 +00:00
imagediff.c test/imagediff.c 2005-01-25 14:45:31 +00:00
leaky-polygon-ref.png Update reference images for new rasterization in libpixman 0.1.3. 2005-01-21 11:27:56 +00:00
leaky-polygon.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
leaky_polygon-ref.png Update reference images for new rasterization in libpixman 0.1.3. 2005-01-21 11:27:56 +00:00
leaky_polygon.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
line-width-ref.png Update reference images for new rasterization in libpixman 0.1.3. 2005-01-21 11:27:56 +00:00
line-width.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
line_width-ref.png Update reference images for new rasterization in libpixman 0.1.3. 2005-01-21 11:27:56 +00:00
line_width.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
linear-gradient-ref.png Comment and clean up the gradient computation. (_cairo_linear_pattern_classify): Determine if a linear gradient is horizontal or vertical. (_cairo_pattern_acquire_surface_for_gradient): Optimize horizontal/vertical gradients with a repeating surface. 2005-03-06 12:05:23 +00:00
linear-gradient.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
linear_gradient-ref.png Comment and clean up the gradient computation. (_cairo_linear_pattern_classify): Determine if a linear gradient is horizontal or vertical. (_cairo_pattern_acquire_surface_for_gradient): Optimize horizontal/vertical gradients with a repeating surface. 2005-03-06 12:05:23 +00:00
linear_gradient.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
Makefile.am Fixes to force tests to run against locally compiled version (thanks to Manish Singh). 2005-03-14 11:14:13 +00:00
move-to-show-surface-ref.png Add initial regression test suite. 2004-10-26 14:38:43 +00:00
move-to-show-surface.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
move_to_show_surface-ref.png Add initial regression test suite. 2004-10-26 14:38:43 +00:00
move_to_show_surface.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
path-data-ref.png Add reference image. 2005-03-14 11:49:12 +00:00
path-data.c * src/cairo.c: (cairo_copy_path), (cairo_copy_path_flat), (cairo_append_path): Rename cairo_copy_path_data, cairop_copy_path_data_flat, and cairo_append_path_data to cairo_copy_path, cairo_copy_path_flat, and cairo_append_path. 2005-03-18 14:28:53 +00:00
path_data-ref.png Add reference image. 2005-03-14 11:49:12 +00:00
path_data.c * src/cairo.c: (cairo_copy_path), (cairo_copy_path_flat), (cairo_append_path): Rename cairo_copy_path_data, cairop_copy_path_data_flat, and cairo_append_path_data to cairo_copy_path, cairo_copy_path_flat, and cairo_append_path. 2005-03-18 14:28:53 +00:00
pixman-rotate-ref.png New test case which exposes off-by-one rotation error in pixman. 2005-02-07 09:38:43 +00:00
pixman-rotate.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
pixman_rotate-ref.png New test case which exposes off-by-one rotation error in pixman. 2005-02-07 09:38:43 +00:00
pixman_rotate.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
read-png.c Fix missing rounding in these two functions. 2005-01-27 11:40:29 +00:00
read-png.h Add initial regression test suite. 2004-10-26 14:38:43 +00:00
read_png.c Fix missing rounding in these two functions. 2005-01-27 11:40:29 +00:00
read_png.h Add initial regression test suite. 2004-10-26 14:38:43 +00:00
README Add paragraph on new features. 2004-10-26 16:31:31 +00:00
romedalen.png New test case, covering various combinations of pattern types, drawing operations and clipping. Currently fails, for some combinations, coverage-ref.png is just a placeholder. 2005-01-26 13:41:55 +00:00
testsvg Added testsvg script 2005-02-15 15:07:25 +00:00
text-cache-crash.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
text-rotate.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
text_cache_crash.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
text_rotate.c Change the draw function under test to return a cairo_test_status_t so that it can indicate test failure even if there is no result image. 2005-03-09 13:58:20 +00:00
user-data.c Dont call user data destroy function if it's NULL. 2005-03-16 12:15:29 +00:00
user_data.c Dont call user data destroy function if it's NULL. 2005-03-16 12:15:29 +00:00
write-png.c Convert to utf-8 encoding. 2005-02-22 11:32:02 +00:00
write-png.h test/imagediff.c 2005-01-25 14:45:31 +00:00
write_png.c Convert to utf-8 encoding. 2005-02-22 11:32:02 +00:00
write_png.h test/imagediff.c 2005-01-25 14:45:31 +00:00
xmalloc.c Add initial regression test suite. 2004-10-26 14:38:43 +00:00
xmalloc.h Add initial regression test suite. 2004-10-26 14:38:43 +00:00

Regression test suite for cairo.

Using this test should be as simple as running:

	make check

assuming that the cairo distribution in the directory above has been
configured and built. The test suite here goes through some effort to
run against the locally compiled library rather than any installed
version.

The test suite needs to be run before any code is committed and before
any release. Here are the rules governing the use of the suite:

Before committing
-----------------

All tests should return a result of PASS or XFAIL. The XFAIL results
indicate known bugs. The final message should be one of the following:

	All XX tests behaved as expected (YY expected failures)
	All XX tests passed

If any tests have a status of FAIL, then the new code has caused a
regression error which should be fixed before the code is committed.

When a new bug is found
-----------------------
A new test case should be added by imitating the style of an existing
test. This means adding the following files:

	new_bug.c
	new_bug-ref.png

Where new_bug.c is a minimal program to demonstrate the bug, following
the style of existing tests. The new_bug-ref.png image should contain
the desired result of new_bug.c if the bug were fixed.

Makefile.am should be edited, adding new_bug.c to both the TESTS and
XFAIL_TESTS lists.

When a new feature is added
---------------------------
It's important for the regression suite to keep pace with development
of the library. So a new test should be added for each new
feature. The work involved is similar the work described above for new
bugs. The only distinction is that the test is expected to pass so it
should not be added to the XFAIL_TESTS list.


When a bug is fixed
-------------------
The fix should be verified by running the test suite which should
result in an "unexpected pass" for the test of interest. Rejoice as
appropriate, then remove the relevant file name from the XFAIL_TESTS
variable in Makefile.am.

Before releasing
----------------
All tests should return a result of PASS meaning all known bugs are
fixed, resulting in the happy message:

	All XX tests passed