Bug 798843 - Add README for generating fonts for SVG in OpenType reftests r=dbaron
authorEdwin Flores <eflores@mozilla.com>
Fri, 13 Sep 2013 07:08:56 +0100
changeset 147051 41c637af7de9669ffa191aa7afb1e51a3edeaa55
parent 147050 4f410931c167eaa7169c7d1d0eda2ea0d24b6ef9
child 147052 b2bb76571aa1851b2409ae5b0960991b94e501b5
push idunknown
push userunknown
push dateunknown
reviewersdbaron
bugs798843
milestone26.0a1
Bug 798843 - Add README for generating fonts for SVG in OpenType reftests r=dbaron
layout/reftests/text-svgglyphs/resources/README
--- a/layout/reftests/text-svgglyphs/resources/README
+++ b/layout/reftests/text-svgglyphs/resources/README
@@ -1,11 +1,37 @@
-Fonts in this directory:
+.woff files for SVG-in-OpenType testing
+=======================================
+
+There are three .woff files in this directory:
+ * nosvg.woff
+ * svg.woff
+ * rubbish.woff
 
-rubbish.woff contains an SVG table with the contents of rubbish.txt. This is
-not a valid SVG table so no SVG glyphs will be used.
+nosvg.woff
+----------
+This font is Liberation Serif with the addition of a glyph with a UVS selector
+(Liberation fonts do not come with UVS glyphs; one had to be added to test that
+SVG glyphs work with UVS selectors). It contains no 'SVG ' table.
+
+svg.woff
+--------
+This font is the same as nosvg.woff above, but with the glyphs-*.svg SVG
+documents from this directory embedded in it using the tools described below.
 
-nosvg.woff is derived from the "Liberation" font. It contains no SVG table.
+rubbish.woff
+------------
+This font is the same as nosvg.woff above, but with the addition of an 'SVG '
+table with the contents of rubbish.txt. Its purpose is to test that SVG tables
+without valid XML are ignored.
 
-svg.woff is nosvg.woff with an SVG table added. The
-table contains the glyph documents glyphs-base.svg, glyphs-invalid.svg,
-glyphs-objectcolor.svg, glyphs-objectopacity.svg, glyphs-objectstroke.svg,
-glyphs-paintservers.svg and glyphs-transforms.svg.
+Creating the Fonts
+------------------
+The tools used here are insertsvg.py from [1] and sfnt2woff from [2].
+
+svg.woff can be recreated with:
+
+woff2sfnt nosvg.woff > nosvg.ttf
+insertsvg.py nosvg.ttf svg.ttf glyphs-*.svg
+sfnt2woff svg.ttf
+
+[1] https://github.com/edf825/SVG-OpenType-Utils
+[2] http://people.mozilla.com/~jkew/woff/