aboutsummaryrefslogtreecommitdiffhomepage
path: root/site
diff options
context:
space:
mode:
authorGravatar Mike Klein <mtklein@chromium.org>2017-11-03 12:25:19 -0400
committerGravatar Skia Commit-Bot <skia-commit-bot@chromium.org>2017-11-06 15:09:09 +0000
commit97f0bc6a1a0d14fd7b9041c39449966535f9f431 (patch)
tree0c2e5006c58bd843d44d628871d3f1150e224e44 /site
parent7a13d871ca54024474ebba9118766f87fac7b3d5 (diff)
clean up cruft about --portableFonts and --resourceFonts
--portableFonts exists but does nothing. --resourceFonts doesn't even exist. Change-Id: I7880208de4aaa9674ba720b9e70c34c145561ac0 Reviewed-on: https://skia-review.googlesource.com/67800 Commit-Queue: Ben Wagner <bungeman@google.com> Reviewed-by: Ben Wagner <bungeman@google.com>
Diffstat (limited to 'site')
-rw-r--r--site/dev/testing/fonts.md84
1 files changed, 0 insertions, 84 deletions
diff --git a/site/dev/testing/fonts.md b/site/dev/testing/fonts.md
index 5772f28f3a..15e7727041 100644
--- a/site/dev/testing/fonts.md
+++ b/site/dev/testing/fonts.md
@@ -11,58 +11,6 @@ been introduced.
The gm tests have a secondary purpose: they detect when rendering is different
across platforms and configurations.
-The dm \(Diamond Master\) tool supports flags that minimize or eliminate the
-differences introduced by the font scaler native to each platform.
-
-
-Portable fonts
---------------
-
-The most portable font format uses Skia to draw characters directly from paths,
-and contains a idealized set of font metrics. This does not exercise platform
-specific fonts at all, but does support specifying the font name, font size,
-font style, and attributes like fakeBold. The paths are generated on a reference
-platform \(currently a Mac\) and are stored as data in
-'tools/test_font_data.cpp' .
-
-To use portable fonts, pass '\-\-portableFonts' to dm.
-
-
-Resource fonts
---------------
-
-The '\-\-resourceFonts' flag directs dm to use font files present in the resources
-directory. By using the same font set on all buildbots, the generated gm images
-become more uniform across platforms.
-
-Today, the set of fonts used by gm, and present in my resources directory,
-include:
-
- * Courier New Bold Italic.ttf
- * Courier New Bold.ttf
- * Courier New Italic.ttf
- * Courier New.ttf
- * LiberationSans-Bold.ttf
- * LiberationSans-BoldItalic.ttf
- * LiberationSans-Italic.ttf
- * LiberationSans-Regular.ttf
- * Papyrus.ttc
- * Pro W4.otf
- * Times New Roman Bold Italic.ttf
- * Times New Roman Bold.ttf
- * Times New Roman Italic.ttf
- * Times New Roman.ttf
-
-
-System fonts
-------------
-
-If neither '\-\-portableFonts' nor '\-\-resourceFonts' is specified, dm uses the fonts
-present on the system. Also, if '\-\-portableFonts' or '\-\-resourceFonts' is specified
-and the desired font is not available, the native font lookup algorithm is
-invoked.
-
-
GM font selection
-----------------
@@ -84,35 +32,3 @@ SkFontStyle style);
Eventually, both 'set_portable_typeface()' and 'create_portable_typeface()' will be
removed. Instead, a test-wide 'SkFontMgr' will be selected to choose portable
fonts or resource fonts.
-
-
-Adding new fonts and glyphs to a GM
------------------------------------
-
-If a font is missing from the portable data or the resource directory, the
-system font is used instead. If a glyph is missing from the portable data, the
-first character, usually a space, is drawn instead.
-
-Running dm with '\-\-portableFonts' and '\-\-reportUsedChars' generates
-'tools/test_font_data_chars.cpp', which describes the fonts and characters used by
-all gm tests. Subsequently running the 'create_test_font' tool generates new paths
-and writes them into 'tools/test_font_data.cpp' .
-
-
-Future work
------------
-
-The font set used by gm tests today is arbitrary and not intended to be
-cross-platform. By choosing fonts without licensing issues, all bots can freely
-contain the same fonts. By narrowing the font selection, the size of the test
-font data will be more manageable.
-
-Adding support for selecting from multiple font managers at runtime permits
-removing manual typeface selection in the gm tests. Today, options to dm like
-'\-\-pipe' fail with '\-\-portableFonts' because we're hard-coded to using the default
-font manage when pictures are serialized.
-
-Some gm tests explicitly always want to use system fonts and system metrics;
-other gm tests use text only to label the drawing; yet other gm tests use text
-to generate paths for testing. Additional discrimination is needed to
-distinguish these cases.