[doc] Describe how to use composite glyph flag ROUND_XY_TO_GRID.
[ttfautohint.git] / NEWS
blobb2df5bee839cbf910e99b3d767114e57c21f1c23
1 Version 1.4.(2015-XXX-XX)
2 -------------------------
4 * Support for the Thai script.
7 Version 1.3 (2015-Jan-06)
8 -------------------------
10 * Keywords in control instruction files can be more verbose to increase
11   readability.  You can now use `left`, `right`, `nodir`, `point`, `touch`,
12   `xshift`, and `yshift` for `l`, `r`, `n`, `p`, `t, `x`, and `y`,
13   respectively.
15 * A new control instruction keyword `touch` was added to apply delta
16   instructions before the final IUP bytecode commands, also `touching' the
17   affected points (to use the TrueType instructions terminology).  Such
18   deltas *do* work even with ClearType if applied to the non-ClearType
19   direction.
21 * Support for the Telugu script.
23 * The amount of information about ttfautohint and its parameters that gets
24   added to the `name` table by default has been reduced.  A new option
25   `--detailed-info` restores the previous behaviour.
27 * ttfautohintGUI crashed if not used with a control instruction file.
29 * ttfautohintGUI now correctly switches to a horizontal two-column layout if
30   the standard one-column layout would exceed the screen height.
32 * A new option `--family-suffix` makes it possible to append a suffix to a
33   font's family name in the `name` table.  This can be useful during the
34   development process: It helps the operating system to simultaneously
35   display several instances of a font that are processed with different
36   ttfautohint parameters.
38 * The new library option `info-post-callback` helps in processing data from
39   the `name` table.
42 Version 1.2 (2014-Oct-06)
43 -------------------------
45 * It is now possible to control the hinting process at a very low level
46   using a 'control instructions' file.  Right now, two modes are supported:
48     - Adding segments and changing segment directions.
50     - Applying delta exceptions.  Note that this doesn't really work in
51       ClearType.
53   Please see the documentation for a description and a small tutorial.
55   In the TTY front-end, use option `--control-file` to load such a file.
57 * Support for input file watching in ttfautohintGUI: If the 'Watch Input
58   File' box is checked, the program automatically regenerates the output
59   file as soon as the input font or control instructions file gets modified.
61   The idea is to dock ttfautohintGUI to your favourite font and text editor
62   instead of adding a cheap text editor to ttfautohintGUI itself.
64 * With the new option `--fallback-stem-width` it is now possible to set a
65   default stem width for all scripts that lack proper standard characters in
66   the font.
68 * Add alias `--adjust-subglyphs` for option `--pre-hinting` to better
69   describe its functionality.  The short form `-p` stays unchanged.
71 * New option `--ttfa-table` to add an SFNT table `TTFA` to the output font,
72   containing an ASCII dump of all used ttfautohint parameters (including
73   control instructions).  Right now, this is mainly for archiving purposes. 
74   Forthcoming versions of ttfautohint will be able to re-use this data if a
75   font gets re-processed.
77 * A harmless buglet was fixed that made the `glyf` table too large by one
78   byte under some circumstances.
80 * A bug fix taken from FreeType, correcting a crash for unusual outlines.
82 * Better handling of TTC files.
84 * New library options `error-callback` and `error-callback-data` for
85   improved diagnostics.  [No change in the front-ends except better error
86   messages.]
88 * Many other, minor fixes and improvements.
91 Version 1.1 (2014-May-05)
92 -------------------------
94 * Support for the Devanagari script.
96 * Bug fixes in the computation of strong stem widths.  GDI hinting now gives
97   much more consistent results.
99 * Better recognition of script coverage: ttfautohint now properly scans
100   composite glyphs to cover components also.
102 * Improved glyph shape analysis: Non-flat local extrema are now recognized
103   more reliably, and stem detection works better.
106 Version 1.00 (2014-Mar-20)
107 --------------------------
109 * Much less memory consumption while handling fonts with complicated glyphs.
111 * Option `-s` was partially broken.
114 Version 1.00rc1 (2014-Feb-07)
115 -----------------------------
117 * OpenType feature support.  ttfautohint now uses the HarfBuzz library to
118   analyze data from the `GSUB` table.  This allows the hinting of glyphs
119   that don't have an entry in a font's `cmap` table, for example
120   superscripts or small caps.
122   Related to this, the new option `--default-script` controls the default
123   (fallback) script used for OpenType features.
125 * More than a single standard character is used.  For example, the 'latin'
126   script uses characters 'o', 'O', and digit '0'.  This improves the hinting
127   of fonts (and features) that have only a partial coverage of a script's
128   character repertoire.
130 * Much better GDI ClearType hinting in the range 30-80ppem (approx.),
131   avoiding overly flat tops and bottoms of round glyphs.
133 * Better handling of non-square pixels (this is, horizontal and vertical
134   resolutions differ) in the created TrueType bytecode.
137 Version 0.97 (2013-Nov-09)
138 --------------------------
140 * Improved script support.  Besides Cyrillic and Greek, which are now
141   handled separately from Latin, ttfautohint can handle Hebrew.
143 * Option `-f` now takes a parameter to specify the fallback script.  The
144   corresponding long option name has been renamed from `--latin-fallback` to
145   `--fallback-script`.
147 * Work around a bug in display environments that use FreeType 2.5.0 and
148   earlier for rendering: Sometimes, the 'strong' stem width routine was used
149   for DW ClearType (this is, subpixel hinting in FreeType is enabled) even
150   if 'smooth' was selected while generating the font with ttfautohint.
153 Version 0.96 (2013-Aug-06)
154 --------------------------
156 * Option `--components` has been replaced with `--composites`: By default,
157   the components of a composite glyph are now hinted separately, since tests
158   has shown that this gives good results in most cases.  If this option is
159   set, however, the composite glyph itself gets hinted (and the hints of the
160   components are ignored).
162   An unfortunate side effect is that ttfautohint's option `-c` (which stays
163   as a shorthand for `--composites`) now does exactly the opposite as in
164   previous releases.
166 * Older versions of Monotype's 'iType' bytecode interpreter have a serious
167   bug: The DIV instruction rounds the result, while the correct operation is
168   truncation.  This caused 'exploding characters' with fonts hinted by
169   ttfautohint.  Since many printers contain this rasterizer without any
170   possibility to update to a non-buggy version, ttfautohint now contains
171   work-arounds to circumvent the problem.
173 * Better support for glyphs where some points have almost the same position
174   (for example glyph 'Oslash' in font 'Roboto-Thin').
176 * Better support for glyphs that use explicit 'on' points around round
177   extrema.
180 Version 0.95 (2013-Mar-07)
181 --------------------------
183 * New option `--dehint` to strip off all hints without generating new hints.
184   This option is intended for testing purposes.
186 * Minor fixes to the created bytecode for compatibility.
188 * Minor GUI improvements.
191 Version 0.94 (2012-Nov-29)
192 --------------------------
194 * New option `--windows-compatibility` that adds two artificial blue zones
195   at vertical positions given by 'usWinAscent' and 'usWinDescent'.  This
196   helps ttfautohint's hinting algorithm reduce the possibility of clipping
197   if those two values are very tight.
199 * Implement option `--x-height-snapping-exceptions`, making ttfautohint
200   avoid x-height snapping for selected PPEM values.  Useful in combination
201   with `--windows-compatibility`.
203 * Minor fixes to the created bytecode for compatibility and robustness.
206 Version 0.93 (2012-Oct-09)
207 --------------------------
209 * New option `--components` to treat components of composite glyphs
210   separately.  This greatly reduces the bytecode size.
212   I'm waiting for reports whether this option works for most fonts; in case
213   this is true I'm inverting the option, making it the default (and the old
214   behaviour optional).
216 * Full support of TTCs, this is, all subfonts get auto-hinted now.
218 * The upper limit of the `--increase-x-height` option has been removed.
220 * Drag-and-drop support in the GUI.
222 * The TTY version of ttfautohint now acts like a (Unix) filter, this is, it
223   accepts stdin and stdout as input and output, respectively.
225 * Less memory consumption.
228 Version 0.92 (2012-Aug-07)
229 --------------------------
231 * A serious bug in the created bytecode has been fixed, causing incorrect
232   rounding.
235 Version 0.91 (2012-Jul-12)
236 --------------------------
238 * A new, 'strong' routine to handle stem widths and positions has been
239   added, to be selected with the `--strong-stem-width` command line option.
240   If it is active, stem widths and positions are snapped to the grid as much
241   as possible.  This algorithm is useful for GDI ClearType support.
243 * A new command line option `--debug` (not available for ttfautohintGUI) to
244   print very detailed debugging information.
247 Version 0.9 (2012-Jun-06)
248 -------------------------
250 * The created bytecode has been reduced in size, making it approx. 20%
251   smaller.
253 * New option `--symbol` to use standard stem height and width values instead
254   of using character 'o' (which may be missing).  Use this option for symbol
255   fonts or math glyphs.
257 * More documentation (in text, HTML, and PDF format).  It's still
258   incomplete, though.
260 * Option `--ignore-permissions` has been renamed to `--ignore-restrictions`.
261   The short form is still `-i`.
263 * Defaults for various parameters have been set to more sensible values:
265     - hinting-range-max: 50 (was 1000)
266     - hinting-limit: 200 (was 1000)
268 * Option `--increase-x-height` now has a mandatory argument (in the range
269   6-20 or value\ 0 to disable it, default value is 14).
272 Version 0.8 (2012-Mar-21)
273 -------------------------
275 * Implement option `-x` to increase the x height of the font for small PPEM
276   values by rounding up far more often then rounding down.
278 * Add option '`-G n`' to switch off hinting completely above value\ `n`.
280 * ttfautohint now appends version information and the used parameters to the
281   'Version' field(s) in the 'name' table.  This can be suppressed with
282   option `-n`.
285 Version 0.7 (2012-Feb-05)
286 -------------------------
288 * A GUI has been added, using the Qt framework.  The binary is called
289   'ttfautohintGUI'.
292 Version 0.6.1 (2012-Jan-02)
293 ---------------------------
295 * The improved handling of composite glyphs in 0.6 was buggy under certain
296   circumstances, making ttfautohint crash and FontValidator complain.
298 * Dropout handling has been activated.
301 Version 0.6 (2011-Dec-25)
302 -------------------------
304 * Improved handling of composite glyphs.
306 * Implement option `-p` to pre-hint glyphs with original hints before
307   conversion takes place.
309 * Don't add a `DSIG` table if there is none in the input font.
311 * Human-readable error messages instead of hexadecimal error codes.
313 * Better tests (both at runtime and compile time) to reject too old FreeType
314   versions.
317 Version 0.5 (2011-Nov-06)
318 -------------------------
320 * Rendering on iOS is now expected to give good results.
322 * No bad rendering at very large PPEM values.
325 Version 0.4 (2011-Oct-27)
326 -------------------------
328 * The bytecode has been changed to 'create' twilight points.  This should
329   avoid rendering artifacts on some platforms.
332 Version 0.3 (2011-Sep-09)
333 -------------------------
335 * Fix font generation; sometimes the `glyf` table was one byte too short,
336   making the font invalid.
339 Version 0.2 (2011-Jul-19)
340 -------------------------
342 * Fix bytecode bugs that prevented correct rendering on some platforms.
345 Version 0.1 (2011-Jun-30)
346 -------------------------
348 * First release.