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

6 years ago · b8dd404d13
parent de0aabcd0d
commit b8dd404d13
1 changed files with 6 additions and 0 deletions
--- 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.