third_party/harfbuzz-ng/NEWS

   1 Overview of changes leading to 1.0.2
   2 Wednesday, August 19, 2015
   3 ====================================
   4
   5 - Fix shaping with cluster-level > 0.
   6 - Fix Uniscribe backend font-size scaling.
   7 - Declare dependencies in harfbuzz.pc.
   8   FreeType is not declared though, to avoid bugs in pkg-config
   9   0.26 with recursive dependencies.
  10 - Slightly improved debug infrastructure.  More to come later.
  11 - Misc build fixes.
  12
  13
  14 Overview of changes leading to 1.0.1
  15 Monday, July 27, 2015
  16 ====================================
  17
  18 - Fix out-of-bounds access in USE shaper.
  19
  20
  21 Overview of changes leading to 1.0.0
  22 Sunday, July 26, 2015
  23 ====================================
  24
  25 - Implement Universal Shaping Engine:
  26   https://www.microsoft.com/typography/OpenTypeDev/USE/intro.htm
  27   http://blogs.windows.com/bloggingwindows/2015/02/23/windows-shapes-the-worlds-languages/
  28 - Bump version to 1.0.0.  The soname was NOT bumped.
  29
  30
  31 Overview of changes leading to 0.9.42
  32 Thursday, July 26, 2015
  33 =====================================
  34
  35 - New API to allow for retrieving finer-grained cluster
  36   mappings if the client desires to handle them.  Default
  37   behavior is unchanged.
  38 - Fix cluster merging when removing default-ignorables.
  39 - Update to Unicode 8.0
  40 - hb-graphite2 fixes.
  41 - Misc fixes.
  42 - Removed HB_NO_MERGE_CLUSTERS hack.
  43 - New API:
  44   hb_buffer_cluster_level_t enum
  45   hb_buffer_get_cluster_level()
  46   hb_buffer_set_cluster_level()
  47   hb-shape / hb-view --cluster-level
  48
  49
  50 Overview of changes leading to 0.9.41
  51 Thursday, June 18, 2015
  52 =====================================
  53
  54 - Fix hb-coretext with trailing whitespace in right-to-left.
  55 - New API: hb_buffer_reverse_range().
  56 - Allow implementing atomic ops in config.h.
  57 - Fix hb_language_t in language bindings.
  58 - Misc fixes.
  59
  60
  61 Overview of changes leading to 0.9.40
  62 Friday, March 20, 2015
  63 =====================================
  64
  65 - Another hb-coretext crasher fix.  Ouch!
  66 - Happy Norouz!
  67
  68
  69 Overview of changes leading to 0.9.39
  70 Wednesday, March 4, 2015
  71 =====================================
  72
  73 - Critical hb-coretext fixes.
  74 - Optimizations and refactoring; no functional change
  75   expected.
  76 - Misc build fixes.
  77
  78
  79 Overview of changes leading to 0.9.38
  80 Friday, January 23, 2015
  81 =====================================
  82
  83 - Fix minor out-of-bounds access in Indic shaper.
  84 - Change New Tai Lue shaping engine from South-East Asian to default,
  85   reflecting change in Unicode encoding model.
  86 - Add hb-shape --font-size.  Can take up to two numbers for separate
  87   x / y size.
  88 - Fix CoreText and FreeType scale issues with negative scales.
  89 - Reject blobs larger than 2GB.  This might break some icu-le-hb clients
  90   that need security fixes.  See:
  91   http://www.icu-project.org/trac/ticket/11450
  92 - Avoid accessing font tables during face destruction, in casce rogue
  93   clients released face data already.
  94 - Fix up gobject-introspection a bit.  Python bindings kinda working.
  95   See README.python.
  96 - Misc fixes.
  97 - API additions:
  98   hb_ft_face_create_referenced()
  99   hb_ft_font_create_referenced()
 100
 101
 102 Overview of changes leading to 0.9.37
 103 Wednesday, December 17, 2014
 104 =====================================
 105
 106 - Fix out-of-bounds access in Context lookup format 3.
 107 - Indic: Allow ZWJ/ZWNJ before syllable modifiers.
 108
 109
 110 Overview of changes leading to 0.9.36
 111 Thursday, November 20, 2014
 112 =====================================
 113
 114 - First time that three months went by without a release since
 115   0.9.2 was released on August 10, 2012!
 116 - Fix performance bug in hb_ot_collect_glyphs():
 117   https://bugzilla.mozilla.org/show_bug.cgi?id=1090869
 118 - Add basic vertical-text support to hb-ot-font.
 119 - Misc build fixes.
 120
 121
 122 Overview of changes leading to 0.9.35
 123 Saturday, August 13, 2014
 124 =====================================
 125
 126 - Fix major shape-plan caching bug when more than one shaper were
 127   provided to hb_shape_full() (as exercised by XeTeX).
 128   http://www.mail-archive.com/debian-bugs-dist@lists.debian.org/msg1246370.html
 129 - Fix Arabic fallback shaping regression.  This was broken in 0.9.32.
 130 - Major hb-coretext fixes.  That backend is complete now, including
 131   respecing buffer direction and language, down to vertical writing.
 132 - Build fixes for Windows CE.  Should build fine now.
 133 - Misc fixes:
 134   Use atexit() only if it's safe to call from shared library
 135   https://bugs.freedesktop.org/show_bug.cgi?id=82246
 136   Mandaic had errors in its Unicode Joining_Type
 137   https://bugs.freedesktop.org/show_bug.cgi?id=82306
 138 - API changes:
 139
 140   * hb_buffer_clear_contents() does not reset buffer flags now.
 141
 142     After 763e5466c0a03a7c27020e1e2598e488612529a7, one doesn't
 143     need to set flags for different pieces of text.  The flags now
 144     are something the client sets up once, depending on how it
 145     actually uses the buffer.  As such, don't clear it in
 146     clear_contents().
 147
 148     I don't expect any changes to be needed to any existing client.
 149
 150
 151 Overview of changes leading to 0.9.34
 152 Saturday, August 2, 2014
 153 =====================================
 154
 155 - hb_feature_from_string() now accepts CSS font-feature-settings format.
 156 - As a result, hb-shape / hb-view --features also accept CSS-style strings.
 157   Eg, "'liga' off" is accepted now.
 158 - Add old-spec Myanmar shaper:
 159   https://bugs.freedesktop.org/show_bug.cgi?id=81775
 160 - Don't apply 'calt' in Hangul shaper.
 161 - Fix mark advance zeroing for Hebrew shaper:
 162   https://bugs.freedesktop.org/show_bug.cgi?id=76767
 163 - Implement Windows-1256 custom Arabic shaping.  Only built on Windows,
 164   and requires help from get_glyph().  Used by Firefox.
 165   https://bugzilla.mozilla.org/show_bug.cgi?id=1045139
 166 - Disable 'liga' in vertical text.
 167 - Build fixes.
 168 - API changes:
 169
 170   * Make HB_BUFFER_FLAG_BOT/EOT easier to use.
 171
 172     Previously, we expected users to provide BOT/EOT flags when the
 173     text *segment* was at paragraph boundaries.  This meant that for
 174     clients that provide full paragraph to HarfBuzz (eg. Pango), they
 175     had code like this:
 176
 177       hb_buffer_set_flags (hb_buffer,
 178                            (item_offset == 0 ? HB_BUFFER_FLAG_BOT : 0) |
 179                            (item_offset + item_length == paragraph_length ?
 180                             HB_BUFFER_FLAG_EOT : 0));
 181
 182       hb_buffer_add_utf8 (hb_buffer,
 183                           paragraph_text, paragraph_length,
 184                           item_offset, item_length);
 185
 186     After this change such clients can simply say:
 187
 188       hb_buffer_set_flags (hb_buffer,
 189                            HB_BUFFER_FLAG_BOT | HB_BUFFER_FLAG_EOT);
 190
 191       hb_buffer_add_utf8 (hb_buffer,
 192                           paragraph_text, paragraph_length,
 193                           item_offset, item_length);
 194
 195     Ie, HarfBuzz itself checks whether the segment is at the beginning/end
 196     of the paragraph.  Clients that only pass item-at-a-time to HarfBuzz
 197     continue not setting any flags whatsoever.
 198
 199     Another way to put it is: if there's pre-context text in the buffer,
 200     HarfBuzz ignores the BOT flag.  If there's post-context, it ignores
 201     EOT flag.
 202
 203
 204 Overview of changes leading to 0.9.33
 205 Tuesday, July 22, 2014
 206 =====================================
 207
 208 - Turn off ARabic 'cswh' feature that was accidentally turned on.
 209 - Add HB_TAG_MAX_SIGNED.
 210 - Make hb_face_make_immutable() really make face immutable!
 211 - Windows build fixes.
 212
 213
 214 Overview of changes leading to 0.9.32
 215 Thursday, July 17, 2014
 216 =====================================
 217
 218 - Apply Arabic shaping features in spec order exactly.
 219 - Another fix for Mongolian free variation selectors.
 220 - For non-Arabic scripts in Arabic shaper apply 'rlig' and 'calt'
 221   together.
 222 - Minor adjustment to U+FFFD logic.
 223 - Fix hb-coretext build.
 224
 225
 226 Overview of changes leading to 0.9.31
 227 Wednesday, July 16, 2014
 228 =====================================
 229
 230 - Only accept valid UTF-8/16/32; we missed many cases before.
 231 - Better shaping of invalid UTF-8/16/32.  Falls back to
 232   U+FFFD REPLACEMENT CHARACTER now.
 233 - With all changes in this release, the buffer will contain fully
 234   valid Unicode after hb_buffer_add_utf8/16/32 no matter how
 235   broken the input is.  This can be overriden though.  See below.
 236 - Fix Mongolian Variation Selectors for fonts without GDEF.
 237 - Fix minor invalid buffer access.
 238 - Accept zh-Hant and zh-Hans language tags.  hb_ot_tag_to_language()
 239   now uses these instead of private tags.
 240 - Build fixes.
 241 - New API:
 242   * hb_buffer_add_codepoints().  This does what hb_buffer_add_utf32()
 243     used to do, ie. no validity check on the input at all.  add_utf32
 244     now replaces invalid Unicode codepoints with the replacement
 245     character (see below).
 246   * hb_buffer_set_replacement_codepoint()
 247   * hb_buffer_get_replacement_codepoint()
 248     Previously, in hb_buffer_add_utf8 and hb_buffer_add_utf16, when
 249     we detected broken input, we replaced that with (hb_codepoint_t)-1.
 250     This has changed to use U+FFFD now, but can be changed using these
 251     new API.
 252
 253
 254 Overview of changes leading to 0.9.30
 255 Wednesday, July 9, 2014
 256 =====================================
 257
 258 - Update to Unicode 7.0.0:
 259   * New scripts Manichaean and Psalter Pahlavi are shaped using
 260     Arabic shaper.
 261   * All the other new scripts to through the generic shaper for
 262     now.
 263 - Minor Indic improvements.
 264 - Fix graphite2 backend cluster mapping [crasher!]
 265 - API changes:
 266   * New HB_SCRIPT_* values for Unicode 7.0 scripts.
 267   * New function hb_ot_layout_language_get_required_feature().
 268 - Build fixes.
 269
 270
 271 Overview of changes leading to 0.9.29
 272 Thursday, May 29, 2014
 273 =====================================
 274
 275 - Implement cmap in hb-ot-font.h.  No variation-selectors yet.
 276 - Myanmar: Allow MedialYa+Asat.
 277 - Various Indic fixes:
 278   * Support most characters in Extended Devanagary and Vedic
 279     Unicode blocks.
 280   * Allow digits and a some punctuation as consonant placeholders.
 281 - Build fixes.
 282
 283
 284 Overview of changes leading to 0.9.28
 285 Monday, April 28, 2014
 286 =====================================
 287
 288 - Unbreak old-spec Indic shaping. (bug 76705)
 289 - Fix shaping of U+17DD and U+0FC6.
 290 - Add HB_NO_MERGE_CLUSTERS build option.  NOT to be enabled by default
 291   for shipping libraries.  It's an option for further experimentation
 292   right now.  When we are sure how to do it properly, we will add
 293   public run-time API for the functionality.
 294 - Build fixes.
 295
 296
 297 Overview of changes leading to 0.9.27
 298 Tuesday, March 18, 2014
 299 =====================================
 300
 301 - Don't use "register" storage class specifier
 302 - Wrap definition of free_langs() with HAVE_ATEXIT
 303 - Add coretext_aat shaper and hb_coretext_face_create() constructor
 304 - If HAVE_ICU_BUILTIN is defined, use hb-icu Unicode callbacks
 305 - Add Myanmar test case from OpenType Myanmar spec
 306 - Only do fallback Hebrew composition if no GPOS 'mark' available
 307 - Allow bootstrapping without gtk-doc
 308 - Use AM_MISSING_PROG for ragel and git
 309 - Typo in ucdn's Makefile.am
 310 - Improve MemoryBarrier() implementation
 311
 312
 313 Overview of changes leading to 0.9.26
 314 Thursday, January 30, 2014
 315 =====================================
 316
 317 - Misc fixes.
 318 - Fix application of 'rtlm' feature.
 319 - Automatically apply frac/numr/dnom around U+2044 FRACTION SLASH.
 320 - New header: hb-ot-shape.h
 321 - Uniscribe: fix scratch-buffer accounting.
 322 - Reorder Tai Tham SAKOT to after tone-marks.
 323 - Add Hangul shaper.
 324 - New files:
 325   hb-ot-shape-complex-hangul.cc
 326   hb-ot-shape-complex-hebrew.cc
 327   hb-ot-shape-complex-tibetan.cc
 328 - Disable 'cswh' feature in Arabic shaper.
 329 - Coretext: better handle surrogate pairs.
 330 - Add HB_TAG_MAX and _HB_SCRIPT_MAX_VALUE.
 331
 332
 333 Overview of changes leading to 0.9.25
 334 Wednesday, December 4, 2013
 335 =====================================
 336
 337 - Myanmar shaper improvements.
 338 - Avoid font fallback in CoreText backend.
 339 - Additional OpenType language tag mappiongs.
 340 - More aggressive shape-plan caching.
 341 - Build with / require automake 1.13.
 342 - Build with libtool 2.4.2.418 alpha to support ppc64le.
 343
 344
 345 Overview of changes leading to 0.9.24
 346 Tuesday, November 13, 2013
 347 =====================================
 348
 349 - Misc compiler warning fixes with clang.
 350 - No functional changes.
 351
 352
 353 Overview of changes leading to 0.9.23
 354 Monday, October 28, 2013
 355 =====================================
 356
 357 - "Udupi HarfBuzz Hackfest", Paris, October 14..18 2013.
 358 - Fix (Chain)Context recursion with non-monotone lookup positions.
 359 - Misc Indic bug fixes.
 360 - New Javanese / Buginese shaping, similar to Windows 8.1.
 361
 362
 363 Overview of changes leading to 0.9.22
 364 Thursday, October 3, 2013
 365 =====================================
 366
 367 - Fix use-after-end-of-scope in hb_language_from_string().
 368 - Fix hiding of default_ignorables if font doesn't have space glyph.
 369 - Protect against out-of-range lookup indices.
 370
 371 - API Changes:
 372
 373   * Added hb_ot_layout_table_get_lookup_count()
 374
 375
 376 Overview of changes leading to 0.9.21
 377 Monday, September 16, 2013
 378 =====================================
 379
 380 - Rename gobject-introspection library name from harfbuzz to HarfBuzz.
 381 - Remove (long disabled) hb-old and hb-icu-le test shapers.
 382 - Misc gtk-doc and gobject-introspection annotations.
 383 - Misc fixes.
 384 - API changes:
 385
 386   * Add HB_SET_VALUE_INVALID
 387
 388 Overview of changes leading to 0.9.20
 389 Thursday, August 29, 2013
 390 =====================================
 391
 392 General:
 393 - Misc substitute_closure() fixes.
 394 - Build fixes.
 395
 396 Documentation:
 397 - gtk-doc boilerplate integrated.  Docs are built now, but
 398   contain no contents.  By next release hopefully we have
 399   some content in.  Enable using --enable-gtk-doc.
 400
 401 GObject and Introspection:
 402 - Added harfbuzz-gobject library (hb-gobject.h) that has type
 403   bindings for all HarfBuzz objects and enums.  Enable using
 404   --with-gobject.
 405 - Added gobject-introspection boilerplate.  Nothing useful
 406   right now.  Work in progress.  Gets enabled automatically if
 407   --with-gobject is used.  Override with --disable-introspection.
 408
 409 OpenType shaper:
 410 - Apply 'mark' in Myanmar shaper.
 411 - Don't apply 'dlig' by default.
 412
 413 Uniscribe shaper:
 414 - Support user features.
 415 - Fix loading of fonts that are also installed on the system.
 416 - Fix shaping of Arabic Presentation Forms.
 417 - Fix build with wide chars.
 418
 419 CoreText shaper:
 420 - Support user features.
 421
 422 Source changes:
 423 - hb_face_t code moved to hb-face.h / hb-face.cc.
 424 - Added hb-deprecated.h.
 425
 426 API changes:
 427 - Added HB_DISABLE_DEPRECATED.
 428 - Deprecated HB_SCRIPT_CANADIAN_ABORIGINAL; replaced by
 429   HB_SCRIPT_CANADIAN_SYLLABICS.
 430 - Deprecated HB_BUFFER_FLAGS_DEFAULT; replaced by
 431   HB_BUFFER_FLAG_DEFAULT.
 432 - Deprecated HB_BUFFER_SERIALIZE_FLAGS_DEFAULT; replaced by
 433   HB_BUFFER_SERIALIZE_FLAG_DEFAULT.
 434
 435
 436 Overview of changes leading to 0.9.19
 437 Tuesday, July 16, 2013
 438 =====================================
 439
 440 - Build fixes.
 441 - Better handling of multiple variation selectors in a row.
 442 - Pass on variation selector to GSUB if not consumed by cmap.
 443 - Fix undefined memory access.
 444 - Add Javanese config to Indic shaper.
 445 - Misc bug fixes.
 446
 447 Overview of changes leading to 0.9.18
 448 Tuesday, May 28, 2013
 449 =====================================
 450
 451 New build system:
 452
 453 - All unneeded code is all disabled by default,
 454
 455 - Uniscribe and CoreText shapers can be enabled with their --with options,
 456
 457 - icu_le and old shapers cannot be enabled for now,
 458
 459 - glib, freetype, and cairo will be detected automatically.
 460   They can be force on/off'ed with their --with options,
 461
 462 - icu and graphite2 are default off, can be enabled with their --with
 463   options,
 464
 465 Moreover, ICU support is now build into a separate library:
 466 libharfbuzz-icu.so, and a new harfbuzz-icu.pc is shipped for it.
 467 Distros can enable ICU now without every application on earth
 468 getting linked to via libharfbuzz.so.
 469
 470 For distros I recommend that they make sure they are building --with-glib
 471 --with-freetype --with-cairo, --with-icu, and optionally --with-graphite2;
 472 And package harfbuzz and harfbuzz-icu separately.
 473
 474
 475 Overview of changes leading to 0.9.17
 476 Monday, May 20, 2013
 477 =====================================
 478
 479 - Build fixes.
 480 - Fix bug in hb_set_get_min().
 481 - Fix regression with Arabic mark positioning / width-zeroing.
 482
 483 Overview of changes leading to 0.9.16
 484 Friday, April 19, 2013
 485 =====================================
 486
 487 - Major speedup in OpenType lookup processing.  With the Amiri
 488   Arabic font, this release is over 3x faster than previous
 489   release.  All scripts / languages should see this speedup.
 490
 491 - New --num-iterations option for hb-shape / hb-view; useful for
 492   profiling.
 493
 494 Overview of changes leading to 0.9.15
 495 Friday, April 05, 2013
 496 =====================================
 497
 498 - Build fixes.
 499 - Fix crasher in graphite2 shaper.
 500 - Fix Arabic mark width zeroing regression.
 501 - Don't compose Hangul jamo into Unicode syllables.
 502
 503
 504 Overview of changes leading to 0.9.14
 505 Thursday, March 21, 2013
 506 =====================================
 507
 508 - Build fixes.
 509 - Fix time-consuming sanitize with malicious fonts.
 510 - Implement hb_buffer_deserialize_glyphs() for both json and text.
 511 - Do not ignore Hangul filler characters.
 512 - Indic fixes:
 513   * Fix Malayalam pre-base reordering interaction with post-forms.
 514   * Further adjust ZWJ handling.  Should fix known regressions from
 515     0.9.13.
 516
 517
 518 Overview of changes leading to 0.9.13
 519 Thursday, February 25, 2013
 520 =====================================
 521
 522 - Build fixes.
 523 - Ngapi HarfBuzz Hackfest in London (February 2013):
 524   * Fixed all known Indic bugs,
 525   * New Win8-style Myanmar shaper,
 526   * New South-East Asian shaper for Tai Tham, Cham, and New Tai Lue,
 527   * Smartly ignore Default_Ignorable characters (joiners, etc) wheb
 528     matching GSUB/GPOS lookups,
 529   * Fix 'Phags-Pa U+A872 shaping,
 530   * Fix partial disabling of default-on features,
 531   * Allow disabling of TrueType kerning.
 532 - Fix possible crasher with broken fonts with overlapping tables.
 533 - Removed generated files from git again.  So, one needs ragel to
 534   bootstrap from the git tree.
 535
 536 API changes:
 537 - hb_shape() and related APIs now abort if buffer direction is
 538   HB_DIRECTION_INVALID.  Previously, hb_shape() was calling
 539   hb_buffer_guess_segment_properties() on the buffer before
 540   shaping.  The heuristics in that function are fragile.  If the
 541   user really wants the old behvaior, they can call that function
 542   right before calling hb_shape() to get the old behavior.
 543 - hb_blob_create_sub_blob() always creates sub-blob with
 544   HB_MEMORY_MODE_READONLY.  See comments for the reason.
 545
 546
 547 Overview of changes leading to 0.9.12
 548 Thursday, January 18, 2013
 549 =====================================
 550
 551 - Build fixes for Sun compiler.
 552 - Minor bug fix.
 553
 554 Overview of changes leading to 0.9.11
 555 Thursday, January 10, 2013
 556 =====================================
 557
 558 - Build fixes.
 559 - Fix GPOS mark attachment with null Anchor offsets.
 560 - [Indic] Fix old-spec reordering of viramas if sequence ends in one.
 561 - Fix multi-threaded shaper data creation crash.
 562 - Add atomic ops for Solaris.
 563
 564 API changes:
 565 - Rename hb_buffer_clear() to hb_buffer_clear_contents().
 566
 567
 568 Overview of changes leading to 0.9.10
 569 Thursday, January 3, 2013
 570 =====================================
 571
 572 - [Indic] Fixed rendering of Malayalam dot-reph
 573 - Updated OT language tags.
 574 - Updated graphite2 backend.
 575 - Improved hb_ot_layout_get_size_params() logic.
 576 - Improve hb-shape/hb-view help output.
 577 - Fixed hb-set.h implementation to not crash.
 578 - Fixed various issues with hb_ot_layout_collect_lookups().
 579 - Various build fixes.
 580
 581 New API:
 582
 583 hb_graphite2_face_get_gr_face()
 584 hb_graphite2_font_get_gr_font()
 585 hb_coretext_face_get_cg_font()
 586
 587 Modified API:
 588
 589 hb_ot_layout_get_size_params()
 590
 591
 592 Overview of changes leading to 0.9.9
 593 Wednesday, December 5, 2012
 594 ====================================
 595
 596 - Fix build on Windows.
 597 - Minor improvements.
 598
 599
 600 Overview of changes leading to 0.9.8
 601 Tuesday, December 4, 2012
 602 ====================================
 603
 604
 605 - Actually implement hb_shape_plan_get_shaper ().
 606 - Make UCDB data tables const.
 607 - Lots of internal refactoring in OTLayout tables.
 608 - Flesh out hb_ot_layout_lookup_collect_glyphs().
 609
 610 New API:
 611
 612 hb_ot_layout_collect_lookups()
 613 hb_ot_layout_get_size_params()
 614
 615
 616 Overview of changes leading to 0.9.7
 617 Sunday, November 21, 2012
 618 ====================================
 619
 620
 621 HarfBuzz "All-You-Can-Eat-Sushi" (aka Vancouver) Hackfest and follow-on fixes.
 622
 623 - Fix Arabic contextual joining using pre-context text.
 624 - Fix Sinhala "split matra" mess.
 625 - Fix Khmer shaping with broken fonts.
 626 - Implement Thai "PUA" shaping for old fonts.
 627 - Do NOT route Kharoshthi script through the Indic shaper.
 628 - Disable fallback positioning for Indic and Thai shapers.
 629 - Misc fixes.
 630
 631
 632 hb-shape / hb-view changes:
 633
 634 - Add --text-before and --text-after
 635 - Add --bot / --eot / --preserve-default-ignorables
 636 - hb-shape --output-format=json
 637
 638
 639 New API:
 640
 641 hb_buffer_clear()
 642
 643 hb_buffer_flags_t
 644
 645 HB_BUFFER_FLAGS_DEFAULT
 646 HB_BUFFER_FLAG_BOT
 647 HB_BUFFER_FLAG_EOT
 648 HB_BUFFER_FLAG_PRESERVE_DEFAULT_IGNORABLES
 649
 650 hb_buffer_set_flags()
 651 hb_buffer_get_flags()
 652
 653 HB_BUFFER_SERIALIZE_FLAGS
 654 hb_buffer_serialize_glyphs()
 655 hb_buffer_deserialize_glyphs()
 656 hb_buffer_serialize_list_formats()
 657
 658 hb_set_add_range()
 659 hb_set_del_range()
 660 hb_set_get_population()
 661 hb_set_next_range()
 662
 663 hb_face_[sg]et_glyph_count()
 664
 665 hb_segment_properties_t
 666 HB_SEGMENT_PROPERTIES_DEFAULT
 667 hb_segment_properties_equal()
 668 hb_segment_properties_hash()
 669
 670 hb_buffer_set_segment_properties()
 671 hb_buffer_get_segment_properties()
 672
 673 hb_ot_layout_glyph_class_t
 674 hb_ot_layout_get_glyph_class()
 675 hb_ot_layout_get_glyphs_in_class()
 676
 677 hb_shape_plan_t
 678 hb_shape_plan_create()
 679 hb_shape_plan_create_cached()
 680 hb_shape_plan_get_empty()
 681 hb_shape_plan_reference()
 682 hb_shape_plan_destroy()
 683 hb_shape_plan_set_user_data()
 684 hb_shape_plan_get_user_data()
 685 hb_shape_plan_execute()
 686 hb_shape_plan_get_shaper()
 687
 688 hb_ot_shape_plan_collect_lookups()
 689
 690
 691 API changes:
 692
 693 - Remove "mask" parameter from hb_buffer_add().
 694 - Rename hb_ot_layout_would_substitute_lookup() and hb_ot_layout_substitute_closure_lookup().
 695 - hb-set.h API const correction.
 696 - Renamed hb_set_min/max() to hb_set_get_min/max().
 697 - Rename hb_ot_layout_feature_get_lookup_indexes() to hb_ot_layout_feature_get_lookups().
 698 - Rename hb_buffer_guess_properties() to hb_buffer_guess_segment_properties().
 699
 700
 701
 702 Overview of changes leading to 0.9.6
 703 Sunday, November 13, 2012
 704 ====================================
 705
 706 - Don't clear pre-context text if no new context is provided.
 707 - Fix ReverseChainingSubstLookup, which was totally borked.
 708 - Adjust output format of hb-shape a bit.
 709 - Include config.h.in in-tree.  Makes it easier for alternate build systems.
 710 - Fix hb_buffer_set_length(buffer, 0) invalid memory allocation.
 711 - Use ICU LayoutEngine's C API instead of C++.  Avoids much headache.
 712 - Drop glyphs for all of Unicode Default_Ignorable characters.
 713 - Misc build fixes.
 714
 715 Arabic shaper:
 716 - Enable 'dlig' and 'mset' features in Arabic shaper.
 717 - Implement 'Phags-pa shaping, improve Mongolian.
 718
 719 Indic shaper:
 720 - Decompose Sinhala split matras the way old HarfBuzz / Pango did.
 721 - Initial support for Consonant Medials.
 722 - Start adding new-style Myanmar shaping.
 723 - Make reph and 'pref' logic introspect the font.
 724 - Route Meetei-Mayek through the Indic shaper.
 725 - Don't apply 'liga' in Indic shaper.
 726 - Improve Malayalam pre-base reordering Ra interaction with Chillus.
 727
 728
 729
 730 Overview of changes leading to 0.9.5
 731 Sunday, October 14, 2012
 732 ====================================
 733
 734 - Synthetic-GSUB Arabic fallback shaping.
 735
 736 - Misc Indic improvements.
 737
 738 - Add build system support for pthread.
 739
 740 - Imported UCDN for in-tree Unicode callbacks implementation.
 741
 742 - Context-aware Arabic joining.
 743
 744 - Misc other fixes.
 745
 746 - New API:
 747
 748   hb_feature_to/from-string()
 749   hb_buffer_[sg]et_content_type()
 750
 751
 752
 753 Overview of changes leading to 0.9.4
 754 Tuesday, Sep 03, 2012
 755 ====================================
 756
 757 - Indic improvements with old-spec Malayalam.
 758
 759 - Better fallback glyph positioning, specially with Thai / Lao marks.
 760
 761 - Implement dotted-circle insertion.
 762
 763 - Better Arabic fallback shaping / ligation.
 764
 765 - Added ICU LayoutEngine backend for testing.  Call it by the 'icu_le' name.
 766
 767 - Misc fixes.
 768
 769
 770
 771 Overview of changes leading to 0.9.3
 772 Friday, Aug 18, 2012
 773 ====================================
 774
 775 - Fixed fallback mark positioning for left-to-right text.
 776
 777 - Improve mark positioning for the remaining combining classes.
 778
 779 - Unbreak Thai and fallback Arabic shaping.
 780
 781 - Port Arabic shaper to shape-plan caching.
 782
 783 - Use new ICU normalizer functions.
 784
 785
 786
 787 Overview of changes leading to 0.9.2
 788 Friday, Aug 10, 2012
 789 ====================================
 790
 791 - Over a thousand commits!  This is the first major release of HarfBuzz.
 792
 793 - HarfBuzz is feature-complete now!  It should be in par, or better, than
 794   both Pango's shapers and old HarfBuzz / Qt shapers.
 795
 796 - New Indic shaper, supporting main Indic scripts, Sinhala, and Khmer.
 797
 798 - Improved Arabic shaper, with fallback Arabic shaping, supporting Arabic,
 799   Sinhala, N'ko, Mongolian, and Mandaic.
 800
 801 - New Thai / Lao shaper.
 802
 803 - Tibetan / Hangul support in the generic shaper.
 804
 805 - Synthetic GDEF support for fonts without a GDEF table.
 806
 807 - Fallback mark positioning for fonts without a GPOS table.
 808
 809 - Unicode normalization shaping heuristic during glyph mapping.
 810
 811 - New experimental Graphite2 backend.
 812
 813 - New Uniscribe backend (primarily for testing).
 814
 815 - New CoreText backend (primarily for testing).
 816
 817 - Major optimization and speedup.
 818
 819 - Test suites and testing infrastructure (work in progress).
 820
 821 - Greatly improved hb-view cmdline tool.
 822
 823 - hb-shape cmdline tool.
 824
 825 - Unicode 6.1 support.
 826
 827 Summary of API changes:
 828
 829 o Changed API:
 830
 831   - Users are expected to only include main header files now (ie. hb.h,
 832     hb-glib.h, hb-ft.h, ...)
 833
 834   - All struct tag names had their initial underscore removed.
 835     Ie. "struct _hb_buffer_t" is "struct hb_buffer_t" now.
 836
 837   - All set_user_data() functions now take a "replace" boolean parameter.
 838
 839   - hb_buffer_create() takes zero arguments now.
 840     Use hb_buffer_pre_allocate() to pre-allocate.
 841
 842   - hb_buffer_add_utf*() now accept -1 for length parameteres,
 843     meaning "nul-terminated".
 844
 845   - hb_direction_t enum values changed.
 846
 847   - All *_from_string() APIs now take a length parameter to allow for
 848     non-nul-terminated strings. A -1 length means "nul-terminated".
 849
 850   - Typedef for hb_language_t changed.
 851
 852   - hb_get_table_func_t renamed to hb_reference_table_func_t.
 853
 854   - hb_ot_layout_table_choose_script()
 855
 856   - Various renames in hb-unicode.h.
 857
 858 o New API:
 859
 860   - hb_buffer_guess_properties()
 861     Automatically called by hb_shape().
 862
 863   - hb_buffer_normalize_glyphs()
 864
 865   - hb_tag_from_string()
 866
 867   - hb-coretext.h
 868
 869   - hb-uniscribe.h
 870
 871   - hb_face_reference_blob()
 872   - hb_face_[sg]et_index()
 873   - hb_face_set_upem()
 874
 875   - hb_font_get_glyph_name_func_t
 876     hb_font_get_glyph_from_name_func_t
 877     hb_font_funcs_set_glyph_name_func()
 878     hb_font_funcs_set_glyph_from_name_func()
 879     hb_font_get_glyph_name()
 880     hb_font_get_glyph_from_name()
 881     hb_font_glyph_to_string()
 882     hb_font_glyph_from_string()
 883
 884   - hb_font_set_funcs_data()
 885
 886   - hb_ft_font_set_funcs()
 887   - hb_ft_font_get_face()
 888
 889   - hb-gobject.h (work in progress)
 890
 891   - hb_ot_shape_glyphs_closure()
 892     hb_ot_layout_substitute_closure_lookup()
 893
 894   - hb-set.h
 895
 896   - hb_shape_full()
 897
 898   - hb_unicode_combining_class_t
 899
 900   - hb_unicode_compose_func_t
 901     hb_unicode_decompose_func_t
 902     hb_unicode_decompose_compatibility_func_t
 903     hb_unicode_funcs_set_compose_func()
 904     hb_unicode_funcs_set_decompose_func()
 905     hb_unicode_funcs_set_decompose_compatibility_func()
 906     hb_unicode_compose()
 907     hb_unicode_decompose()
 908     hb_unicode_decompose_compatibility()
 909
 910 o Removed API:
 911
 912   - hb_ft_get_font_funcs()
 913
 914   - hb_ot_layout_substitute_start()
 915     hb_ot_layout_substitute_lookup()
 916     hb_ot_layout_substitute_finish()
 917     hb_ot_layout_position_start()
 918     hb_ot_layout_position_lookup()
 919     hb_ot_layout_position_finish()
 920
 921
 922
 923 Overview of changes leading to 0.6.0
 924 Friday, May 27, 2011
 925 ====================================
 926
 927 - Vertical text support in GPOS
 928 - Almost all API entries have unit tests now, under test/
 929 - All thread-safety issues are fixed
 930
 931 Summary of API changes follows.
 932
 933
 934 * Simple Types API:
 935
 936   o New API:
 937     HB_LANGUAGE_INVALID
 938     hb_language_get_default()
 939     hb_direction_to_string()
 940     hb_direction_from_string()
 941     hb_script_get_horizontal_direction()
 942     HB_UNTAG()
 943
 944   o Renamed API:
 945     hb_category_t renamed to hb_unicode_general_category_t
 946
 947   o Changed API:
 948     hb_language_t is a typed pointers now
 949
 950   o Removed API:
 951     HB_TAG_STR()
 952
 953
 954 * Use ISO 15924 tags for hb_script_t:
 955
 956   o New API:
 957     hb_script_from_iso15924_tag()
 958     hb_script_to_iso15924_tag()
 959     hb_script_from_string()
 960
 961   o Changed API:
 962     HB_SCRIPT_* enum members changed value.
 963
 964
 965 * Buffer API streamlined:
 966
 967   o New API:
 968     hb_buffer_reset()
 969     hb_buffer_set_length()
 970     hb_buffer_allocation_successful()
 971
 972   o Renamed API:
 973     hb_buffer_ensure() renamed to hb_buffer_pre_allocate()
 974     hb_buffer_add_glyph() renamed to hb_buffer_add()
 975
 976   o Removed API:
 977     hb_buffer_clear()
 978     hb_buffer_clear_positions()
 979
 980   o Changed API:
 981     hb_buffer_get_glyph_infos() takes an out length parameter now
 982     hb_buffer_get_glyph_positions() takes an out length parameter now
 983
 984
 985 * Blob API streamlined:
 986
 987   o New API:
 988     hb_blob_get_data()
 989     hb_blob_get_data_writable()
 990
 991   o Renamed API:
 992     hb_blob_create_empty() renamed to hb_blob_get_empty()
 993
 994   o Removed API:
 995     hb_blob_lock()
 996     hb_blob_unlock()
 997     hb_blob_is_writable()
 998     hb_blob_try_writable()
 999
1000   o Changed API:
1001     hb_blob_create() takes user_data before destroy now
1002
1003
1004 * Unicode functions API:
1005
1006   o Unicode function vectors can subclass other unicode function vectors now.
1007     Unimplemented callbacks in the subclass automatically chainup to the parent.
1008
1009   o All hb_unicode_funcs_t callbacks take a user_data now.  Their setters
1010     take a user_data and its respective destroy callback.
1011
1012   o New API:
1013     hb_unicode_funcs_get_empty()
1014     hb_unicode_funcs_get_default()
1015     hb_unicode_funcs_get_parent()
1016
1017   o Changed API:
1018     hb_unicode_funcs_create() now takes a parent_funcs.
1019
1020   o Removed func getter functions:
1021     hb_unicode_funcs_get_mirroring_func()
1022     hb_unicode_funcs_get_general_category_func()
1023     hb_unicode_funcs_get_script_func()
1024     hb_unicode_funcs_get_combining_class_func()
1025     hb_unicode_funcs_get_eastasian_width_func()
1026
1027
1028 * Face API:
1029
1030   o Renamed API:
1031     hb_face_get_table() renamed to hb_face_reference_table()
1032     hb_face_create_for_data() renamed to hb_face_create()
1033
1034   o Changed API:
1035     hb_face_create_for_tables() takes user_data before destroy now
1036     hb_face_reference_table() returns empty blob instead of NULL
1037     hb_get_table_func_t accepts the face as first parameter now
1038
1039 * Font API:
1040
1041   o Fonts can subclass other fonts now.  Unimplemented callbacks in the
1042     subclass automatically chainup to the parent.  When chaining up,
1043     scale is adjusted if the parent font has a different scale.
1044
1045   o All hb_font_funcs_t callbacks take a user_data now.  Their setters
1046     take a user_data and its respective destroy callback.
1047
1048   o New API:
1049     hb_font_get_parent()
1050     hb_font_funcs_get_empty()
1051     hb_font_create_sub_font()
1052
1053   o Removed API:
1054     hb_font_funcs_copy()
1055     hb_font_unset_funcs()
1056
1057   o Removed func getter functions:
1058     hb_font_funcs_get_glyph_func()
1059     hb_font_funcs_get_glyph_advance_func()
1060     hb_font_funcs_get_glyph_extents_func()
1061     hb_font_funcs_get_contour_point_func()
1062     hb_font_funcs_get_kerning_func()
1063
1064   o Changed API:
1065     hb_font_create() takes a face and references it now
1066     hb_font_set_funcs() takes user_data before destroy now
1067     hb_font_set_scale() accepts signed integers now
1068     hb_font_get_contour_point_func_t now takes glyph first, then point_index
1069     hb_font_get_glyph_func_t returns a success boolean now
1070
1071
1072 * Changed object model:
1073
1074   o All object types have a _get_empty() now:
1075     hb_blob_get_empty()
1076     hb_buffer_get_empty()
1077     hb_face_get_empty()
1078     hb_font_get_empty()
1079     hb_font_funcs_get_empty()
1080     hb_unicode_funcs_get_empty()
1081
1082   o Added _set_user_data() and _get_user_data() for all object types:
1083     hb_blob_get_user_data()
1084     hb_blob_set_user_data()
1085     hb_buffer_get_user_data()
1086     hb_buffer_set_user_data()
1087     hb_face_get_user_data()
1088     hb_face_set_user_data()
1089     hb_font_funcs_get_user_data()
1090     hb_font_funcs_set_user_data()
1091     hb_font_get_user_data()
1092     hb_font_set_user_data()
1093     hb_unicode_funcs_get_user_data()
1094     hb_unicode_funcs_set_user_data()
1095
1096   o Removed the _get_reference_count() from all object types:
1097     hb_blob_get_reference_count()
1098     hb_buffer_get_reference_count()
1099     hb_face_get_reference_count()
1100     hb_font_funcs_get_reference_count()
1101     hb_font_get_reference_count()
1102     hb_unicode_funcs_get_reference_count()
1103
1104   o Added _make_immutable() and _is_immutable() for all object types except for buffer:
1105     hb_blob_make_immutable()
1106     hb_blob_is_immutable()
1107     hb_face_make_immutable()
1108     hb_face_is_immutable()
1109
1110
1111 * Changed API for vertical text support
1112
1113   o The following callbacks where removed:
1114     hb_font_get_glyph_advance_func_t
1115     hb_font_get_kerning_func_t
1116
1117   o The following new callbacks added instead:
1118     hb_font_get_glyph_h_advance_func_t
1119     hb_font_get_glyph_v_advance_func_t
1120     hb_font_get_glyph_h_origin_func_t
1121     hb_font_get_glyph_v_origin_func_t
1122     hb_font_get_glyph_h_kerning_func_t
1123     hb_font_get_glyph_v_kerning_func_t
1124
1125   o The following API removed as such:
1126     hb_font_funcs_set_glyph_advance_func()
1127     hb_font_funcs_set_kerning_func()
1128     hb_font_get_glyph_advance()
1129     hb_font_get_kerning()
1130
1131   o New API added instead:
1132     hb_font_funcs_set_glyph_h_advance_func()
1133     hb_font_funcs_set_glyph_v_advance_func()
1134     hb_font_funcs_set_glyph_h_origin_func()
1135     hb_font_funcs_set_glyph_v_origin_func()
1136     hb_font_funcs_set_glyph_h_kerning_func()
1137     hb_font_funcs_set_glyph_v_kerning_func()
1138     hb_font_get_glyph_h_advance()
1139     hb_font_get_glyph_v_advance()
1140     hb_font_get_glyph_h_origin()
1141     hb_font_get_glyph_v_origin()
1142     hb_font_get_glyph_h_kerning()
1143     hb_font_get_glyph_v_kerning()
1144
1145   o The following higher-leve API added for convenience:
1146     hb_font_get_glyph_advance_for_direction()
1147     hb_font_get_glyph_origin_for_direction()
1148     hb_font_add_glyph_origin_for_direction()
1149     hb_font_subtract_glyph_origin_for_direction()
1150     hb_font_get_glyph_kerning_for_direction()
1151     hb_font_get_glyph_extents_for_origin()
1152     hb_font_get_glyph_contour_point_for_origin()
1153
1154
1155 * OpenType Layout API:
1156
1157   o New API:
1158     hb_ot_layout_position_start()
1159     hb_ot_layout_substitute_start()
1160     hb_ot_layout_substitute_finish()
1161
1162
1163 * Glue code:
1164
1165   o New API:
1166     hb_glib_script_to_script()
1167     hb_glib_script_from_script()
1168     hb_icu_script_to_script()
1169     hb_icu_script_from_script()
1170
1171
1172 * Version API added:
1173
1174   o New API:
1175     HB_VERSION_MAJOR
1176     HB_VERSION_MINOR
1177     HB_VERSION_MICRO
1178     HB_VERSION_STRING
1179     HB_VERSION_CHECK()
1180     hb_version()
1181     hb_version_string()
1182     hb_version_check()
1183
1184