Commit b8dd404d1342d435d207fb2377a7dc6e281f3b22

Werner Lemberg 2018-09-16T07:22:23

freetype.h: Add warning w.r.t. B/W hinting and rendering (#54589).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index 83c7f14..25db584 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -3091,6 +3091,12 @@ FT_BEGIN_HEADER
    *     output.  The result is probably unpleasant if the glyph is rendered
    *     in non-monochrome modes.
    *
+   *     Note that for outline fonts only the TrueType font driver has proper
+   *     monochrome hinting support, provided the TTFs contain hints for B/W
+   *     rendering (which most fonts no longer provide).  If these conditions
+   *     are not met it is very likely that you get ugly results at smaller
+   *     sizes.
+   *
    *   FT_LOAD_TARGET_LCD ::
    *     A variant of @FT_LOAD_TARGET_LIGHT optimized for horizontally
    *     decimated LCD displays.