f245576042
There are no API guarantees just yet, but I *expect* that no incompatible API changes to happen before 1.0.0. Update NEWS.
263 lines
6.9 KiB
Plaintext
263 lines
6.9 KiB
Plaintext
Overview of changes leading to 0.6.0
|
|
Friday, May 27, 2011
|
|
====================================
|
|
|
|
- Vertical text support in GPOS
|
|
- Almost all API entries have unit tests now, under test/
|
|
- All thread-safety issues are fixed
|
|
|
|
Summary of API changes follows.
|
|
|
|
|
|
* Simple Types API:
|
|
|
|
o New API:
|
|
HB_LANGUAGE_INVALID
|
|
hb_language_get_default()
|
|
hb_direction_to_string()
|
|
hb_direction_from_string()
|
|
hb_script_get_horizontal_direction()
|
|
HB_UNTAG()
|
|
|
|
o Renamed API:
|
|
hb_category_t renamed to hb_unicode_general_category_t
|
|
|
|
o Changed API:
|
|
hb_language_t is a typed pointers now
|
|
|
|
o Removed API:
|
|
HB_TAG_STR()
|
|
|
|
|
|
* Use ISO 15924 tags for hb_script_t:
|
|
|
|
o New API:
|
|
hb_script_from_iso15924_tag()
|
|
hb_script_to_iso15924_tag()
|
|
hb_script_from_string()
|
|
|
|
o Changed API:
|
|
HB_SCRIPT_* enum members changed value.
|
|
|
|
|
|
* Buffer API streamlined:
|
|
|
|
o New API:
|
|
hb_buffer_reset()
|
|
hb_buffer_set_length()
|
|
hb_buffer_allocation_successful()
|
|
|
|
o Renamed API:
|
|
hb_buffer_ensure() renamed to hb_buffer_pre_allocate()
|
|
hb_buffer_add_glyph() renamed to hb_buffer_add()
|
|
|
|
o Removed API:
|
|
hb_buffer_clear()
|
|
hb_buffer_clear_positions()
|
|
|
|
o Changed API:
|
|
hb_buffer_get_glyph_infos() takes an out length parameter now
|
|
hb_buffer_get_glyph_positions() takes an out length parameter now
|
|
|
|
|
|
* Blob API streamlined:
|
|
|
|
o New API:
|
|
hb_blob_get_data()
|
|
hb_blob_get_data_writable()
|
|
|
|
o Renamed API:
|
|
hb_blob_create_empty() renamed to hb_blob_get_empty()
|
|
|
|
o Removed API:
|
|
hb_blob_lock()
|
|
hb_blob_unlock()
|
|
hb_blob_is_writable()
|
|
hb_blob_try_writable()
|
|
|
|
o Changed API:
|
|
hb_blob_create() takes user_data before destroy now
|
|
|
|
|
|
* Unicode functions API:
|
|
|
|
o Unicode function vectors can subclass other unicode function vectors now.
|
|
Unimplemented callbacks in the subclass automatically chainup to the parent.
|
|
|
|
o All hb_unicode_funcs_t callbacks take a user_data now. Their setters
|
|
take a user_data and its respective destroy callback.
|
|
|
|
o New API:
|
|
hb_unicode_funcs_get_empty()
|
|
hb_unicode_funcs_get_default()
|
|
hb_unicode_funcs_get_parent()
|
|
|
|
o Changed API:
|
|
hb_unicode_funcs_create() now takes a parent_funcs.
|
|
|
|
o Removed func getter functions:
|
|
hb_unicode_funcs_get_mirroring_func()
|
|
hb_unicode_funcs_get_general_category_func()
|
|
hb_unicode_funcs_get_script_func()
|
|
hb_unicode_funcs_get_combining_class_func()
|
|
hb_unicode_funcs_get_eastasian_width_func()
|
|
|
|
|
|
* Face API:
|
|
|
|
o Renamed API:
|
|
hb_face_get_table() renamed to hb_face_reference_table()
|
|
hb_face_create_for_data() renamed to hb_face_create()
|
|
|
|
o Changed API:
|
|
hb_face_create_for_tables() takes user_data before destroy now
|
|
hb_face_reference_table() returns empty blob instead of NULL
|
|
hb_get_table_func_t accepts the face as first parameter now
|
|
|
|
* Font API:
|
|
|
|
o Fonts can subclass other fonts now. Unimplemented callbacks in the
|
|
subclass automatically chainup to the parent. When chaining up,
|
|
scale is adjusted if the parent font has a different scale.
|
|
|
|
o All hb_font_funcs_t callbacks take a user_data now. Their setters
|
|
take a user_data and its respective destroy callback.
|
|
|
|
o New API:
|
|
hb_font_get_parent()
|
|
hb_font_funcs_get_empty()
|
|
hb_font_create_sub_font()
|
|
|
|
o Removed API:
|
|
hb_font_funcs_copy()
|
|
hb_font_unset_funcs()
|
|
|
|
o Removed func getter functions:
|
|
hb_font_funcs_get_glyph_func()
|
|
hb_font_funcs_get_glyph_advance_func()
|
|
hb_font_funcs_get_glyph_extents_func()
|
|
hb_font_funcs_get_contour_point_func()
|
|
hb_font_funcs_get_kerning_func()
|
|
|
|
o Changed API:
|
|
hb_font_create() takes a face and references it now
|
|
hb_font_set_funcs() takes user_data before destroy now
|
|
hb_font_set_scale() accepts signed integers now
|
|
hb_font_get_contour_point_func_t now takes glyph first, then point_index
|
|
hb_font_get_glyph_func_t returns a success boolean now
|
|
|
|
|
|
* Changed object model:
|
|
|
|
o All object types have a _get_empty() now:
|
|
hb_blob_get_empty()
|
|
hb_buffer_get_empty()
|
|
hb_face_get_empty()
|
|
hb_font_get_empty()
|
|
hb_font_funcs_get_empty()
|
|
hb_unicode_funcs_get_empty()
|
|
|
|
o Added _set_user_data() and _get_user_data() for all object types:
|
|
hb_blob_get_user_data()
|
|
hb_blob_set_user_data()
|
|
hb_buffer_get_user_data()
|
|
hb_buffer_set_user_data()
|
|
hb_face_get_user_data()
|
|
hb_face_set_user_data()
|
|
hb_font_funcs_get_user_data()
|
|
hb_font_funcs_set_user_data()
|
|
hb_font_get_user_data()
|
|
hb_font_set_user_data()
|
|
hb_unicode_funcs_get_user_data()
|
|
hb_unicode_funcs_set_user_data()
|
|
|
|
o Removed the _get_reference_count() from all object types:
|
|
hb_blob_get_reference_count()
|
|
hb_buffer_get_reference_count()
|
|
hb_face_get_reference_count()
|
|
hb_font_funcs_get_reference_count()
|
|
hb_font_get_reference_count()
|
|
hb_unicode_funcs_get_reference_count()
|
|
|
|
o Added _make_immutable() and _is_immutable() for all object types except for buffer:
|
|
hb_blob_make_immutable()
|
|
hb_blob_is_immutable()
|
|
hb_face_make_immutable()
|
|
hb_face_is_immutable()
|
|
|
|
|
|
* Changed API for vertical text support
|
|
|
|
o The following callbacks where removed:
|
|
hb_font_get_glyph_advance_func_t
|
|
hb_font_get_kerning_func_t
|
|
|
|
o The following new callbacks added instead:
|
|
hb_font_get_glyph_h_advance_func_t
|
|
hb_font_get_glyph_v_advance_func_t
|
|
hb_font_get_glyph_h_origin_func_t
|
|
hb_font_get_glyph_v_origin_func_t
|
|
hb_font_get_glyph_h_kerning_func_t
|
|
hb_font_get_glyph_v_kerning_func_t
|
|
|
|
o The following API removed as such:
|
|
hb_font_funcs_set_glyph_advance_func()
|
|
hb_font_funcs_set_kerning_func()
|
|
hb_font_get_glyph_advance()
|
|
hb_font_get_kerning()
|
|
|
|
o New API added instead:
|
|
hb_font_funcs_set_glyph_h_advance_func()
|
|
hb_font_funcs_set_glyph_v_advance_func()
|
|
hb_font_funcs_set_glyph_h_origin_func()
|
|
hb_font_funcs_set_glyph_v_origin_func()
|
|
hb_font_funcs_set_glyph_h_kerning_func()
|
|
hb_font_funcs_set_glyph_v_kerning_func()
|
|
hb_font_get_glyph_h_advance()
|
|
hb_font_get_glyph_v_advance()
|
|
hb_font_get_glyph_h_origin()
|
|
hb_font_get_glyph_v_origin()
|
|
hb_font_get_glyph_h_kerning()
|
|
hb_font_get_glyph_v_kerning()
|
|
|
|
o The following higher-leve API added for convenience:
|
|
hb_font_get_glyph_advance_for_direction()
|
|
hb_font_get_glyph_origin_for_direction()
|
|
hb_font_add_glyph_origin_for_direction()
|
|
hb_font_subtract_glyph_origin_for_direction()
|
|
hb_font_get_glyph_kerning_for_direction()
|
|
hb_font_get_glyph_extents_for_origin()
|
|
hb_font_get_glyph_contour_point_for_origin()
|
|
|
|
|
|
* OpenType Layout API:
|
|
|
|
o New API:
|
|
hb_ot_layout_position_start()
|
|
hb_ot_layout_substitute_start()
|
|
hb_ot_layout_substitute_finish()
|
|
|
|
|
|
* Glue code:
|
|
|
|
o New API:
|
|
hb_glib_script_to_script()
|
|
hb_glib_script_from_script()
|
|
hb_icu_script_to_script()
|
|
hb_icu_script_from_script()
|
|
|
|
|
|
* Version API added:
|
|
|
|
o New API:
|
|
HB_VERSION_MAJOR
|
|
HB_VERSION_MINOR
|
|
HB_VERSION_MICRO
|
|
HB_VERSION_STRING
|
|
HB_VERSION_CHECK()
|
|
hb_version()
|
|
hb_version_string()
|
|
hb_version_check()
|
|
|
|
|