Table of contents

• Testing Suica
• Using Three.js

Testing-suica

There is a rudimentary automatic Suica tester. It runs predefined test cases and compares the produced images. It reports the percentage of match:

• A match of 90% or more is considered normal.
• A match between 70% and 90% is most likely due to some rendering fluctuations and a visual inspection is recommended.
• A match below 70% most likely indicates a problem and a visual inspection is required.

Because timings cannot be set absolutely, some test cases may not produce the expected result. In this case run the tester another time to check whether the result is consistent.

To test only part of the test cases, a string template is given as a parameter to the tester. The following code test.html?convex will test all test cases with the substring convex in their names.

Browsers have a standard way of reaction on non-standard web pages (e.g. missing closing tags, unregistered custom tags, etc). This is heavily used in all Suica examples. Tools that validate HTML pages may complain about Suica HTML code.

Using Three.js

This version of Suica is based on Three.js. Programs that use Suica should include suica.js. Apart from Suica itself, suica.js contains:

• The original Three.js file:
  • build/three.min.js
• Minified versions of original Three.js files:
  • examples/js/effects/StereoEffect.js
  • examples/js/exporters/GLTFExporter.js
  • examples/js/geometries/ConvexGeometry.js
  • examples/js/geometries/TextGeometry.js
  • examples/js/loaders/GLTFLoader.js
  • examples/js/loaders/FontLoader.js
  • examples/js/math/ConvexHull.js
• Modified and minified versions of Three.js files:
  • examples/js/effects/AnaglyphEffect.js – color matrices are set to color identities
  • examples/jsm/webxr/VRButton.js – converted to non-module
• Modified and minified versions of CSG.js files:
  • src/CSG/CSG.js – converted to non-module
  • src/CSG/components/BSPNode.js – converted to non-module
  • src/CSG/components/CSGCuttingPlane.js – converted to non-module
  • src/CSG/components/CSGPolygon.js – converted to non-module
  • src/CSG/components/CSGVertex.js – converted to non-module
• Modified and minified version of CCapture.js files:
  • build/CCapture.all.min.js – contains src/gif.worker.js; renamed to CCapture.all.worker.min.js