# SVG Conformance Test Suite --
Release Notes for Second BE Release

Date: October 26, 2001

## Overview

The SVG working group has finished building the entire test set of the Basic Effectivity (BE) level of an SVG conformance test suite. This is the third publication of BE tests. The first was a partial release of 70 tests in June, 2000. The second release contained 127 BE tests, which span the functionality of the SVG specification. This third release is an update of the 127 BE tests. The tests now use the final release public and system identifiers and incorporate minor fixes in the tests themselves.

## References

1. The tests in this release conform to the 4 September 2001 SVG Recommendation document: http://www.w3.org/TR/2001/REC-SVG-20010904/.
2. The definitive reference on the principles and structure of the test suite, as well as the conventions and specific methods for building and maintaining the tests, is the document svgTest-manual.html.

## Note

- Reference images are in PNG format and have an alpha channel which means that the reference image provides the reference values for the Red, Green, Blue and Alpha components which conformant viewers should produce. Caveat: the reference images for the animation and scripting tests were generated with no alpha channel. These images provide the correct visual reference for the corresponding SVG tests rendered on an opaque white background but they do not contain the alpha channel reference.

## Release Contents

The entire test suite release is contained in the zip file, rel-20011026.zip. Unzipping this will result in:

1. 127 SVG test files, 127 PNG reference images, and 127 XML description files.
2. a few extra SVG, as well as PNG and JPEG files, used for support of some of the tests.
3. harness-html-20011026.zip
4. harness-svg-20011026.zip
5. harness-ps-20011026.zip
6. harness-svgcmp-20011026.zip

#3, #4, #5 and #6 provide linked navigation pages for viewing the test suite.

Please check the SVG web pages at http://www.w3.org/Graphics/SVG for further information, including an implementation matrix covering all of the test cases in this suite.

## Viewing the Test Suite

### Unpack the HTML Navigation Pages

Unzipping harness-html-20011026.zip will result in:

> H1: toc.html;

> H2: 127 HTML navigation pages named identically to the test cases;

> H3: files for making #H2:

- CreateHTMLharness.xslt, generateNames.xslt, navigationBar-html.xslt
- make-all-html.bat, make-1-html.bat

### Unpack the SVG Navigation Pages

Unzipping harness-svg-20011026.zip will result in:

> S1: toc-sv.svg;

> S2: 127 SVG navigation pages named identically to the test cases, except with a "-nav" suffix to the test case name;

> S3: files for making #S2:

- CreateSVGharness.xslt, generateNames.xslt, navigationBar-svg.xslt
- make-all-svg.bat, make-1-svg.bat

### Unpack the HTML Side-By-Side (PNG & SVG) Navigation Pages

Unzipping harness-ps-20011026.zip will result in:

> PS1: toc-ps.html;

> PS2: 127 HTML navigation pages named identically to the test cases, except with a "-ps" suffix to the test case name these contain the frameset for this harness type);

> PS3: 127 HTML navigation pages named identically to the test cases, except with a "-ps-top" suffix to the test case name;

> PS4: 127 HTML navigation pages named identically to the test cases, except with a "-ps-bottom" suffix to the test case name;

> PS5: files for making #PS2, #PS3 and #PS4:

- harness-ps-create-frameset.xslt, generateNames.xslt, navigationBar-html.xslt
- harness-ps-create-top.xslt
- harness-ps-create-bottom.xslt
- make-all-ps.bat, make-1-ps.bat

### Unpack the all-SVG Side-By-Side (PNG & SVG) Navigation Pages

Unzipping harness-svgcmp-20011026.zip will result in:

> > SC1: toc-svcmp.svg;

> > SC2: 127 SVG navigation pages named identically to the test cases, except with a "-cmpnav" suffix to the test case name;

> > SC3: files for making #SC2:

> - CreateSVGharnessCompare.xslt, generateNames.xslt, navigationBar-svgcmp.xslt
> - make-all-svgcmp.bat, make-1-svgcmp.bat

### View using HTML Navigation Pages

This method is one of two possible methods to be used if your SVG viewer is not a browser plugin.

1. View the file toc.html in a browser. You will see the chapter names of the SVG spec (20001102 draft), each linked to the first test of each chapter. When you view a test, you will see the PNG reference image, a navigation bar, and the Operator Script for the test -- description of the test purpose and intended results.
2. Simultaneously, you can direct an SVG viewer (or browser plug-in) to toc-sv.svg (in a second window). This is a table of contents written in SVG, linked identically to the HTML version. Each page in this linked set contains a navigation bar, and is otherwise empty except for an SVG 'image' element which references the actual SVG file for the test case.

If the SVG viewer supports this functionality, you should be able to navigate the suite in two windows side by side, with the reference image and description in one, and the rendered SVG content in the other.

#### Caveat about Viewer Limitations

If the viewer does not yet fully support the 'image' element, as is the case with some current viewers, then for each test case:

- navigate to the test case in the browser window;
- cut-paste the test case name (URL) from the browser location window to your SVG viewer's file selection window;
- change .html to .svg
- render and view.

#### Alternate Method for image-enabled SVG Viewers

If the SVG viewer fully supports the 'image' element, as is the case with some current viewers, then this alternative to the above two steps may be of interest. Instead of step #2, direct your SVG viewer to toc-svcmp.svg. This is a table of contents written in SVG, linked identically to all of the other navigation harness versions. It wil present the SVG rendering and the PNG reference image side-by-side. It will not display the Operator Script information. (If you want to see that, you would have to simultaneously do something like #1 above.)

### View using HTML Side-By-Side (PNG & SVG) Navigation Pages

This method may be used if your SVG viewer is a browser plugin.

View the file toc-ps.html in a browser. You will see the chapter names of the SVG spec (20001102 draft), each linked to the first test of each chapter.

When you view a test, you will see the PNG reference image on the left and the SVG image on the right (SVG-enabled browsers only). At the bottom, there is a navigation bar and the Operator Script for the test -- description of the test purpose and intended results.

Note. Your display should be operating with addressability of at least 1024x768 if you use this viewing method.

### Customizing the Harnesses and Navigation Pages

The navigation harness sets of H2, S2, PS2-PS4, and SC2 above are generated with the tools supplied in H3, S3, PS5, and SC3 respectively. These tools are included on "user beware" basis, and are not to be considered a supported part of this test suite release.

The key component are the stylesheets:

- CreateHTMLharness.xslt (plus generateNames.xslt, navigationBar-html.xslt)
- CreateSVGharness.xslt (plus generateNames.xslt, navigationBar-svg.xslt)
- harness-ps-create-frameset.xslt, harness-ps-create-top.xslt and harness-ps-create-bottom.xslt (plus generateNames.xslt, navigationBar-html.xslt)
- CreateSVGharnessCompare.xslt (plus generateNames.xslt, navigationBar-svgcmp.xslt)

If one uses an XSLT processor to apply these to the XML description file for a test case, the result is a set of HTML navigation pages (with operator script text included in some) and an SVG navigation page. The batch files (make-all-html.bat, make-all-svg.bat and make-all-ps.bat) use the XT tool (of James Clark) to generate the set of HTML navigation pages, and the Xalan processor (of the Apache project) to generate the SVG navigation pages.

## Comments and Contributions

Comments are welcome, and should be directed to: svg-testsuite-comments@w3.org.