Print Reftests¶
Print reftests are like ordinary reftests, except that the output is rendered to pagninated form and then compared page-by-page with the reference.
Print reftests are distinguished by the string -print
in the
filename immediately before the extension, or by being under a
directory named print
. Examples:
css/css-foo/bar-print.html
is a print reftestcss/css-foo/print/bar.html
is a print reftestcss/css-foo/bar-print-001.html
is not a print reftest
Like ordinary reftests, the reference is specified using a <link rel=match>
element.
The default page size (page box) for print reftests is 12.7 cm by 7.62 cm (5 inches by 3 inches) with a default margin of 12.7 mm (0.5 inches) on all sides.
All the features of ordinary reftests also work with print reftests including fuzzy matching. Any fuzzy specifier applies to each image comparison performed i.e. separately for each page.
Page Ranges¶
In some cases it may be desirable to only compare a subset of the output pages in the reftest. This is possible using
<meta name=reftest-pages content=[range-specifier]>
Where a range specifier has the form
range-specifier = <specifier-item> ["," <specifier-item>]*
specifier-item = <int> | <int>? "-" <int>?
For example to specify rendering pages 1 and 2, 4, 6 and 7, and 9 and 10 of a 10 page page document one could write:
<meta name=reftest-pages content="-2,4,6,7,9-">