aboutsummaryrefslogtreecommitdiff
path: root/freetype/docs/reference/ft2-tt_driver.html
diff options
context:
space:
mode:
Diffstat (limited to 'freetype/docs/reference/ft2-tt_driver.html')
-rw-r--r--freetype/docs/reference/ft2-tt_driver.html23
1 files changed, 18 insertions, 5 deletions
diff --git a/freetype/docs/reference/ft2-tt_driver.html b/freetype/docs/reference/ft2-tt_driver.html
index 0bf393df2..101828dfb 100644
--- a/freetype/docs/reference/ft2-tt_driver.html
+++ b/freetype/docs/reference/ft2-tt_driver.html
@@ -3,7 +3,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<title>FreeType-2.5.0 API Reference</title>
+<title>FreeType-2.5.3 API Reference</title>
<style type="text/css">
body { font-family: Verdana, Geneva, Arial, Helvetica, serif;
color: #000000;
@@ -35,7 +35,7 @@
<table align=center><tr><td><font size=-1>[<a href="ft2-index.html">Index</a>]</font></td>
<td width="100%"></td>
<td><font size=-1>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
-<center><h1>FreeType-2.5.0 API Reference</h1></center>
+<center><h1>FreeType-2.5.3 API Reference</h1></center>
<center><h1>
The TrueType driver
@@ -52,9 +52,9 @@ The TrueType driver
<table align=center width="75%"><tr><td>
<h4><a name="interpreter-version">interpreter-version</a></h4>
<table align=center width="87%"><tr><td>
-<p>Currently, two versions are available which represent the bytecode interpreter with and without subpixel hinting support, respectively. The default is subpixel support if TT_CONFIG_OPTION_SUBPIXEL_HINTING is defined, and no subpixel support otherwise (since it isn't available then).</p>
+<p>Currently, two versions are available, representing the bytecode interpreter with and without subpixel hinting support, respectively. The default is subpixel support if TT_CONFIG_OPTION_SUBPIXEL_HINTING is defined, and no subpixel support otherwise (since it isn't available then).</p>
<p>If subpixel hinting is on, many TrueType bytecode instructions behave differently compared to B/W or grayscale rendering. The main idea is to render at a much increased horizontal resolution, then sampling down the created output to subpixel precision. However, many older fonts are not suited to this and must be specially taken care of by applying (hardcoded) font-specific tweaks.</p>
-<p>Details on subpixel hinting and some of the necessary tweaks can be found in Greg Hitchcock's whitepaper at &lsquo;http://www.microsoft.com/typography/cleartype/truetypecleartype.aspx&rsquo;.</p>
+<p>Details on subpixel hinting and some of the necessary tweaks can be found in Greg Hitchcock's whitepaper at &lsquo;<a href="http://www.microsoft.com/typography/cleartype/truetypecleartype.aspx">http://www.microsoft.com/typography/cleartype/truetypecleartype.aspx</a>&rsquo;.</p>
<p>The following example code demonstrates how to activate subpixel hinting (omitting the error handling).</p>
<pre class="colored">
FT_Library library;
@@ -81,7 +81,7 @@ The TrueType driver
<table align=center width="75%"><tr><td>
<h4><a name="TT_INTERPRETER_VERSION_XXX">TT_INTERPRETER_VERSION_XXX</a></h4>
<table align=center width="87%"><tr><td>
-Defined in FT_TRUETYPE_DRIVER_H (freetype/ftttdrv.h).
+Defined in FT_TRUETYPE_DRIVER_H (ftttdrv.h).
</td></tr></table><br>
<table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
@@ -109,6 +109,19 @@ Defined in FT_TRUETYPE_DRIVER_H (freetype/ftttdrv.h).
<table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>note</b></em></td></tr><tr><td>
<p>This property controls the behaviour of the bytecode interpreter and thus how outlines get hinted. It does <b>not</b> control how glyph get rasterized! In particular, it does not control subpixel color filtering.</p>
<p>If FreeType has not been compiled with configuration option FT_CONFIG_OPTION_SUBPIXEL_HINTING, selecting version&nbsp;38 causes an &lsquo;FT_Err_Unimplemented_Feature&rsquo; error.</p>
+<p>Depending on the graphics framework, Microsoft uses different bytecode engines. As a consequence, the version numbers returned by a call to the &lsquo;GETINFO[1]&rsquo; bytecode instruction are more convoluted than desired.</p>
+<pre class="colored">
+ framework Windows version result of GETINFO[1]
+ ----------------------------------------------------
+ GDI before XP 35
+ GDI XP and later 37
+ GDI+ old before Vista 37
+ GDI+ old Vista, 7 38
+ GDI+ after 7 40
+ DWrite before 8 39
+ DWrite 8 and later 40
+</pre>
+<p>Since FreeType doesn't provide all capabilities of DWrite ClearType, using version&nbsp;38 seems justified.</p>
</td></tr></table>
</td></tr></table>
<hr width="75%">