news

Pango is a library for layout and rendering of text, with an emphasis on internationalization. Pang

Overview of changes between 1.19.4 and 1.20.0
==============================================
- New stable release!
- Bugs fixed in this release:
	Bug 518084 – Thai is not Virama language
		Patch from Theppitak Karoonboonyanan

Overview of changes between 1.19.3 and 1.19.4
==============================================
- Make Win32 backend be able to use Type1 fonts
- Fixed blocker bug with pango_layout_set_height() and positive height.
- Fixed small leak in ATSUI backend.
- Improved docs.
- Bugs fixed in this release:
	Bug 511172 – pango_layout_set_height() with positive height always
		shows at least two lines
	Bug 515484 – Uniscribe interface handles surrogate
		pairs incorrectly
	Bug 515484 – Pango on Windows is missing Type 1
		font support
		Patch from Adrian Johnson.
	Bug 517083 – pango modules: wrong fallback adding code?
	Bug 515484 – Variable is initialized twice
	Bug 504810 – Samvruthokaram (combination of U+0D41 and U+0D4D) is not
		rendered correctly
		Patch from Praveen A
	Bug 496244 – Don't use freetype-config, use pkg-config
	Bug 512566 – dont' use deprecated macro
		Patch from Christian Persch
	Bug 512473 – [patch] gtk-doc warnings

Overview of changes between 1.19.2 and 1.19.3
==============================================
- pango_layout_get_pixel_extents() and pango_layout_line_get_pixel_extents()
  now round extents to pixels inclusively.  That is, pass both ink_rect and
  logical_rect as first argument to pango_extents_to_pixels().

- Rename pango_extents_to_pixels() function arguments from @ink_rect and
  @logical_rect to @inclusive and @nearest.  Given that this API is a
  fairly new addition and not commonly used, language bindings are
  encouraged to update their argument names accordingly.  Moreover, they
  are encouraged to wrap this function as two different calls:
  extents_to_pixels_inclusive() and extents_to_pixels_nearest(), or
  similar conventions that best reflect their native language.

- HarfBuzz was relicensed to a more generous and simpler license.
  Adapt.  See pango/opentype/COPYING for the new license which is
  LGPL-compatible.

- New public API:

	pango_layout_set_height()

  This sets the height to which the #PangoLayout should be ellipsized at.
  There are two different behaviors, based on whether @height is positive or
  negative.

  If @height is positive, it will be the maximum height of the layout.  Only
  lines would be shown that would fit, and if there is any text ommitted, an
  ellipsis added.  At least one line is included in each paragraph regardless
  of how small the height value is.  A value of zero will render exactly one
  line for the entire layout.

  If @height is negative, it will be the (negative of) maximum number of lines
  per paragraph.  That is, the total number of lines shown may well be more
  than this value if the layout contains multiple paragraphs of text.  The
  default value of -1 means that first line of each paragraph is ellipsized.

  Height setting only has effect if a positive width is set on @layout and
  ellipsization mode of @layout is not %PANGO_ELLIPSIZE_NONE.
  The behavior is undefined if a height other than -1 is set and ellipsization
  mode is set to %PANGO_ELLIPSIZE_NONE, and may change in the future.

  There are still bugs remaining to be fixed, notably bug 511172 (which will
  be fixed before 1.20), and bug 511171 (which will be fixed in a future
  version).

- New command-line arguments to pango-view: --height and --single-par.

- Make the following symbols available to engines:

	PANGO_IS_OT_INFO
	PANGO_IS_OT_RULESET
	PANGO_OT_INFO
	PANGO_OT_RULESET
	PANGO_TYPE_OT_INFO
	PANGO_TYPE_OT_RULESET
	pango_ot_info_get_type
	pango_ot_ruleset_get_type

- Bugs fixed in this release:
	Bug 508002 – change pango_layout_pixel_extents() to round logical rect
		to be inclusive
	Bug 469313 – Add pango_layout_set_height()
	Bug 508179 – PangoGlyphUnit confusion
	Bug 508381 – indent and center alignment don't mix
	Bug 508007 – Add option for single-paragraph mode to pango-view
	Bug 506284 – docs typo for pango_coverage_unref
		Patch from Christian Persch
	Bug 504802 – build failure: No rule to make target
		`pango-querymodules.1', needed by `all-am'. Stop.
	Bug 504585 – pango-querymodules.1 syntax error
	Red Hat Bug 426178: gtkdoc-scan fails on pango

Overview of changes between 1.19.1 and 1.19.2
==============================================
- Render a crossed box for each invalid input byte to pango_layout_set_text().
  Previously we rendered an ASCII question mark instead.  The crossed box has
  a glyph of value of PANGO_GLYPH_INVALID_INPUT.
- Use pkg-config to detect cairo features [Benjamin Otte]
- Improved docs.  Particularly, examples/cairo*.c have inline docs now.
- New public macro:

	PANGO_GLYPH_INVALID_INPUT

- Bugs fixed in this release:
	Bug 502926 – pango-1.16.4 configure bug: can fail to accept cairo
	Bug 399573 – replace strtoul in pango-markup.c with pango_scan_int()
	Bug 478914 – Use something invalid instead of '?' when validating
		input text
	Bug 501938 – Arabic shaping broken with vertical layout with
		vertical-hint=line
	Bug 501575 – Compile errors
		Patch from Jens Granseuer

Overview of changes between 1.19.0 and 1.19.1
==============================================
- Various cleanup in the HarfBuzz code and merging with upstream/Qt changes.
- Built-in pango.aliases file for Win32 default aliases.
- Document cairo examples and misc documentation improvements.
- Bugs fixed in this release:
	Bug 485536 – underline_position can be zero
	Bug 500549 – pangocairo.h should include pango.h and cairo.h
	Bug 492517 – Built-in default aliases file
	Bug 495091 – pango-utils.c:variable is declared at middle of block

Overview of changes between 1.18.3 and 1.19.0
==============================================
- Update list of languages to that of fontconfig-2.4.91.
- Various optimizations, making rendering the same Pango layout using
  changing cairo matrices much faster.

- Make sure all boxed type copy/free functions accept NULL as legitimate
  input.  Previously most were g_return_[val_]if_fail()ing it.  This is
  mostly for convenience when writing code in C.

- Apply 'vkrn' GPOS feature in vertical writing.

- In pangofc, set "pangoversion" in pattern passed to fontconfig,
  such that font configuration can condition on being driven by Pango
  or not.

- Various optimizations and cleanups in the OpenType Layout engine,
  aka HarfBuzz.


- Changed APIs:

  * All PangoAttribute constructors are changed to initialize the
    attribute to the range [0..MAXUINT].  The range was undefined
    previously.  All custom attribute constructors are recommended
    to call the new pango_attribute_init() to do the same.

  * Public API chance: Mark the following types as abstract:

	PangoFont
	PangoFontFace
	PangoFontFamily
	PangoFontMap
	PangoFcFont
	PangoFcFontMap

    PangoContext may be marked so in the future too.

  * Make following macros public.  Previously they were only
    defined for backend/engine implementations.

	PANGO_GLYPH_EMPTY
	PANGO_GLYPH_UNKNOWN_FLAG
	PANGO_GET_UNKNOWN_GLYPH()


- New public API:
	
  * Convenience for initializing custom attributes:

	pango_attribute_init()

  * Adding boxed type for PangoGlyphItem:

	PANGO_TYPE_GLYPH_ITEM
	pango_glyph_item_copy()
	pango_glyph_item_get_type()

  * Add missing copy function for a boxed type in C:

	pango_layout_iter_copy()

  * Add missing getter:

	pango_layout_iter_get_layout()

  * Convenience for writing custom PangoRenderer's:

	pango_renderer_get_layout()
	pango_renderer_get_layout_line()

  * PangoFc extensions to fontconfig's pattern syntax:

	PANGO_FC_GRAVITY
	PANGO_FC_VERSION


- Bugs fixed in this release:
	Bug 490661 – Pango Markup: Link to font_desc syntax explanation
		Based on patch from Chris Toshok
	Bug 489909 – pango_cairo_update_context() should ignore matrix
		translation
	Bug 488840 – harfbuzz: protect against ligid overflow
	Bug 486932 – Apply vkrn GPOS feature in vertical writing
	Bug 486951 – ChangeLog.pre-1-18
	Bug 485621 – Get rid of freetype memory allocator in harfbuzz
	Bug 485566 – Cache one OpenType Buffer
	Bug 485559 – Boston Summit HarfBuzz optimizations
	Bug 481537 – compiler warning fixes
		Patch from Kjartan Maraas
	Bug 478865 – Drastically reduce number of PangoFont objects created
		for rotating text
	Bug 472924 – Mark some classes abstract
	Bug 472629 – Add pango_renderer_get_layout(_line)
	Bug 472303 – Make PANGO_GLYPH_EMPTY and PANGO_GLYPH_UNKNOWN_FLAG public
	Bug 471601 – Pass pango version information to fontconfig
	Bug 471577 – GBoxed GType for PangoGlyphItem
	Bug 471571 – Add pango_layout_iter_get_layout()
	Bug 471568 – Optimizations in _pango_cairo_update_context()
	Bug 469641 – Initialize attribute start/end to [0..MAXUINT]


Overview of changes between 1.18.2 and 1.18.3
==============================================
- Two OpenType engine fixes.  Makes Nafees Nastaliq font
  work great, and avoids warnings with some other fonts.
- Fix minor leak in win32 backend.
- Bugs fixed in this release:
	Bug 483600 – Leak of font family name in
	pango_win32_font_description_from_logfont(w)
	Patch from Daniel Atallah

Overview of changes between 1.18.1 and 1.18.2
==============================================
- Require libthai >= 0.1.9 for enabling thai-lang module
- Misc bug fixes
- Bugs fixed in this release:
	Bug 474708 – pangocairo leaks memory
	Bug 472891 – Bad consistency check in pango_get_log_attrs
		Patch from Mathias Hasselmann
	Bug 302952 – The placement of a diacritic marks for an arabic ligature
		is not correct
	Bug 410152 – testboundaries test fails

Overview of changes between 1.18.0 and 1.18.1
==============================================
- Misc bug fixes, including fix for an infinite-loop bug.

- Bugs fixed in this release:
	Bug 470042 – missing Macedonian OT tag
		Patch from Denis Jacquerye
	Bug 468953 – pango-renderer.c: using function without prototype
	Bug 463430 – Gets stuck while "formatting message"

Overview of changes between 1.17.5 and 1.18.0
==============================================
- Make pango_script_for_unichar() just call g_unichar_get_script(),
  and document that PangoScript and GUnicodeScript are interchangeable
  enumerations.

- Misc bug fixes

- Bugs fixed in this release:
	Bug 348348 – Add a way to get the script name of a gunichar
	Bug 451682 – Cursor positioning for Sinhala is broken
		Based on patch from Harshula
	Bug 462137 – memory corruption in pango_default_break
	Bug 462420 – Clicking on pixbuf should move the cursor to the position
		nearest to the click point
	Bug 462630 – pango_cairo_context_set_font_options() and some others
		don't have a Since: tag
	Bug 464183 – Minimum tab width enforcement in pango-layout breaks
		TabArray positions
		Patch by David Trowbridge
	Bug 464270 – ellipsize doesn't work consistent
	Bug 465174 – TextView is ignoring multiple consecutive \t's
	Bug 466755 – pango hangul is crashing in gnome-about because it is
		failing to retrieve a font.
	Bug 467056 – Shape attribute handling is not consistent
	Bug 467077 – Remove special-case for shape attribute in
		pango_layout_line_index_to_x()

Overview of changes between 1.17.4 and 1.17.5
==============================================
- Export PangoCairoFont and cleanup various standard macros.

- Bugs fixed in this release:
	Bug 150883 – Unicode LRO defect
	Bug 449482 – Build error when xft not present
	Part of Bug 347236 – provide pango_cairo_font_get_scaled_font

Overview of changes between 1.17.3 and 1.17.4
==============================================
- Refactored the ATSUI font backend and install pangoatsui.h
  that has a single function pango_atsui_font_get_atsu_font_id() and
  a couple of types.

- Bugs fixed in this release:
	Bug 451547 – FAIL: runtests.sh
	Bug 449543 - Ship pangoatsui.h

Overview of changes between 1.17.2 and 1.17.3