WebCGM 2.0 Conformance Test Suite

Pre-release 0.9 -- 29 March 2006


Note. The contents of this document are not yet finished, and are being derived from the WebCGM 1.0 test suite version. The 1.0-to-2.0 TS upgrade is in progress. This document will be updated at the finish.



Copyright & License.The WebCGM 2.0 Conformance Test Suite (WebCGM20TS) is an extension of WebCGM10TS -- the latter forms the core of WebCGM20TS, comprising about 85% of the test cases. The WebCGM 1.0 Test Suite (WebCGM10TS) was developed by Lofton Henderson and NIST (National Institute of Standards and Technology). CGM Open has provided a Web location for free distribution of the WebCGM Test Suite since its first publication. Copyright for the WebCGM20TS, like the WebCGM10TS is held by Lofton Henderson. License terms for use and redistribution are free, subject to a no-modification restriction (to preserve the integrity of WebCGM20TS materials). See the WebCGM TS copyright & license document.

NIST Software Disclaimer.The WebCGM 1.0 Conformance Test Suite (WebCGM10TS) was developed under contract for the National Institute of Standards and Technology (NIST), an agency of the U.S. Department of Commerce, Gaithersburg MD 20899, USA. WebCGM10 TS bears no warranty, either express or implied. NIST does not assume legal liability nor responsibility for a User's use of WebCGM TS or the results of such use.


Introduction. This is the initial, pre-release version of the WebCGM 2.0 Conformance Test Suite (WebCGM20TS). This release covers all of the functionality of the WebCGM10TS, plus WebCGM DOM and XCF functionality, plus additional static and dynamic graphics functionality that was either not tested in WebCGM10TS, or has been added to the WebCGM 2.0 profile.

There will be future releases and further improvements. There will also be a more test cases, as well as bug fixes and improvements to some test cases.

Caveat 1. The Dynamic (hyperlinking) tests will not look very good if you are running on a small screen, or at less that 1024x768 resolution. (At higher resolutions, there may also be some frame-layout issues).

Caveat 2. In a some cases, production of reference images was problematical for WebCGM20TS (as well as WebCGM10TS), due to limited access to high-resolution systems and tools. This will be addressed in a future release, rather than delay the first public release of WebCGM20TS. This is not a critical criterion for the dynamic tests, in particular, and there is a caveat at the end of each Operator Script.


Installation Instructions. To view WebCGM20TS, all you have to do is unzip the delivery into a local directory. Be sure to pay attention to these details when un-zipping:

After you have successfully unzipped the contents:

  1. open "introPage.html" in a browser, or navigate there from this page (Overview.html)
  2. click the link to the dynamic module, the static-graphics module, or the new20tests
  3. If you select "Dynamic", this will display a Table of Contents of test cases. Select any one.

    If you select "new20tests", this will display a Table of Contents of new WebCGM 2.0 test cases. Select any one.

  4. You will need a WebCGM plug-in at this point (selecting tests from the TOCs).
  5. If you select "Static", then you will be taken to a Javascript page (this will not work in older versions of Netscape Navigator -- you may have to switch to Internet Explorer or another browser).
  6. You can navigate to any one of the 233 static tests, by one of several selection categories.
  7. The Operator Script will be displayed, plus a button to display the (raster) reference image. You will have to cause your viewer (plugin, or standalone, or...) to display the CGM.

Dynamic Contents. Test cases have names like: linking-basicH2C-BE-01. The first bit is the functional category, the second is the specific focus, the third is test type (all of these are BE, Basic Effectivity), the 4th is a sequence (within category): category-focus-BE-nn.. All of the tests are BE tests. They try to provide a complete coverage of V4 functionality at a basic level of detail -- no drill down or detailed testing (DT). There are perhaps 6-10 more that I will add before the next (second) public release.

When you select a test in the TOC, a 4-frame screen will come up.

For information (but not relevant to viewing and using the test suite), the test cases are each driven off of an XML test case description instance, and XSLT stylesheets generate the test harnesses.

There are many files associated with each test case. You don't need to worry much about most of them. But a couple of files might interest you. The test content root file will generally be named "category-focus-BE-nn" with extension .cgm or .html. If the test case has a target file for a link, it will be named something line "category-focus-BE-nn-target", with extension .cgm or .html. All of the files with bits like "-dyn" as a suffix to the name are associated with the harness, and you shouldn't need to worry about them.

New WebCGM 2.0 tests. [In progress, to be completed.] The majority of these are DOM and XCF tests, that each start with an HTML page. Typically there is a reference picture (PNG) on the right, a frame for display of the subject source metafile on the left, and an HTML table below, with interactive buttons for triggering DOM calls.


Download. You can download a ZIP file and install the test suite on a local computer.

View Intro Page. In the future, you will be able to browse the suite online. For now, you must download, install it per the above instructions, and initiate viewing at introPage.html. Either way, if you view the Intro page, it will have links that take you to the various parts of the suite. Please note viewer and browser requirements discussed above.

Feedback Welcome. We welcome specific critiques on individual tests, Your general comments and impressions are welcome as well. Contributions can be made with the enclosed contribution form. Please send comments and contributions to the WebCGM TS manager, or info@cgmopen.org.

Questions? Please write to WebCGM TS manager, or info@cgmopen.org.

Lofton Henderson
28 March 2006.