<?xml version="1.0"?>
<!-- This file was automatically generated from C sources - DO NOT EDIT!
To affect the contents of this file, edit the original C definitions,
and/or use gtk-doc annotations.  -->
<repository xmlns="http://www.gtk.org/introspection/core/1.0" xmlns:c="http://www.gtk.org/introspection/c/1.0" xmlns:doc="http://www.gtk.org/introspection/doc/1.0" xmlns:glib="http://www.gtk.org/introspection/glib/1.0" version="1.2">
  <include name="GObject" version="2.0"/>
  <include name="freetype2" version="2.0"/>
  <package name="harfbuzz"/>
  <package name="harfbuzz-gobject"/>
  <c:include name="hb-gobject.h"/>
  <doc:format name="unknown"/>
  <namespace name="HarfBuzz" version="0.0" shared-library="libharfbuzz-gobject.so.0,libharfbuzz.so.0" c:identifier-prefixes="hb_" c:symbol-prefixes="hb,hb_gobject">
    <alias name="bool_t" c:type="hb_bool_t">
      <doc xml:space="preserve">Data type for booleans.</doc>
      <type name="gint" c:type="int"/>
    </alias>
    <alias name="codepoint_t" c:type="hb_codepoint_t">
      <doc xml:space="preserve">Data type for holding Unicode codepoints. Also
used to hold glyph IDs.</doc>
      <type name="guint32" c:type="uint32_t"/>
    </alias>
    <alias name="color_t" c:type="hb_color_t">
      <doc xml:space="preserve">Data type for holding color values. Colors are eight bits per
channel RGB plus alpha transparency.</doc>
      <type name="guint32" c:type="uint32_t"/>
    </alias>
    <alias name="font_get_font_h_extents_func_t" c:type="hb_font_get_font_h_extents_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the extents for a font, for horizontal-direction
text segments. Extents must be returned in an #hb_glyph_extents output
parameter.</doc>
      <type name="font_get_font_extents_func_t" c:type="hb_font_get_font_extents_func_t"/>
    </alias>
    <alias name="font_get_font_v_extents_func_t" c:type="hb_font_get_font_v_extents_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the extents for a font, for vertical-direction
text segments. Extents must be returned in an #hb_glyph_extents output
parameter.</doc>
      <type name="font_get_font_extents_func_t" c:type="hb_font_get_font_extents_func_t"/>
    </alias>
    <alias name="font_get_glyph_h_advance_func_t" c:type="hb_font_get_glyph_h_advance_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the advance for a specified glyph, in
horizontal-direction text segments. Advances must be returned in
an #hb_position_t output parameter.</doc>
      <type name="font_get_glyph_advance_func_t" c:type="hb_font_get_glyph_advance_func_t"/>
    </alias>
    <alias name="font_get_glyph_h_advances_func_t" c:type="hb_font_get_glyph_h_advances_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the advances for a sequence of glyphs, in
horizontal-direction text segments.</doc>
      <type name="font_get_glyph_advances_func_t" c:type="hb_font_get_glyph_advances_func_t"/>
    </alias>
    <alias name="font_get_glyph_h_kerning_func_t" c:type="hb_font_get_glyph_h_kerning_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the kerning-adjustment value for a glyph-pair in
the specified font, for horizontal text segments.</doc>
      <type name="font_get_glyph_kerning_func_t" c:type="hb_font_get_glyph_kerning_func_t"/>
    </alias>
    <alias name="font_get_glyph_h_origin_func_t" c:type="hb_font_get_glyph_h_origin_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the (X,Y) coordinates (in scaled units) of the
origin for a glyph, for horizontal-direction text segments. Each
coordinate must be returned in an #hb_position_t output parameter.</doc>
      <type name="font_get_glyph_origin_func_t" c:type="hb_font_get_glyph_origin_func_t"/>
    </alias>
    <alias name="font_get_glyph_h_origins_func_t" c:type="hb_font_get_glyph_h_origins_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the (X,Y) coordinates (in scaled units) of the
origin for requested glyph, for horizontal-direction text segments. Each
coordinate must be returned in a the x/y #hb_position_t output parameters.</doc>
      <type name="font_get_glyph_origins_func_t" c:type="hb_font_get_glyph_origins_func_t"/>
    </alias>
    <alias name="font_get_glyph_v_advance_func_t" c:type="hb_font_get_glyph_v_advance_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the advance for a specified glyph, in
vertical-direction text segments. Advances must be returned in
an #hb_position_t output parameter.</doc>
      <type name="font_get_glyph_advance_func_t" c:type="hb_font_get_glyph_advance_func_t"/>
    </alias>
    <alias name="font_get_glyph_v_advances_func_t" c:type="hb_font_get_glyph_v_advances_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the advances for a sequence of glyphs, in
vertical-direction text segments.</doc>
      <type name="font_get_glyph_advances_func_t" c:type="hb_font_get_glyph_advances_func_t"/>
    </alias>
    <alias name="font_get_glyph_v_kerning_func_t" c:type="hb_font_get_glyph_v_kerning_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the kerning-adjustment value for a glyph-pair in
the specified font, for vertical text segments.</doc>
      <type name="font_get_glyph_kerning_func_t" c:type="hb_font_get_glyph_kerning_func_t"/>
    </alias>
    <alias name="font_get_glyph_v_origin_func_t" c:type="hb_font_get_glyph_v_origin_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the (X,Y) coordinates (in scaled units) of the
origin for a glyph, for vertical-direction text segments. Each coordinate
must be returned in an #hb_position_t output parameter.</doc>
      <type name="font_get_glyph_origin_func_t" c:type="hb_font_get_glyph_origin_func_t"/>
    </alias>
    <alias name="font_get_glyph_v_origins_func_t" c:type="hb_font_get_glyph_v_origins_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the (X,Y) coordinates (in scaled units) of the
origin for requested glyph, for vertical-direction text segments. Each
coordinate must be returned in a the x/y #hb_position_t output parameters.</doc>
      <type name="font_get_glyph_origins_func_t" c:type="hb_font_get_glyph_origins_func_t"/>
    </alias>
    <alias name="mask_t" c:type="hb_mask_t">
      <doc xml:space="preserve">Data type for bitmasks.</doc>
      <type name="guint32" c:type="uint32_t"/>
    </alias>
    <alias name="ot_name_id_t" c:type="hb_ot_name_id_t">
      <doc xml:space="preserve">An integral type representing an OpenType 'name' table name identifier.
There are predefined name IDs, as well as name IDs return from other
API.  These can be used to fetch name strings from a font face.</doc>
      <type name="guint" c:type="unsigned int"/>
    </alias>
    <alias name="position_t" c:type="hb_position_t">
      <doc xml:space="preserve">Data type for holding a single coordinate value.
Contour points and other multi-dimensional data are
stored as tuples of #hb_position_t's.</doc>
      <type name="gint32" c:type="int32_t"/>
    </alias>
    <alias name="tag_t" c:type="hb_tag_t">
      <doc xml:space="preserve">Data type for tag identifiers. Tags are four
byte integers, each byte representing a character.

Tags are used to identify tables, design-variation axes,
scripts, languages, font features, and baselines with
human-readable names.</doc>
      <type name="guint32" c:type="uint32_t"/>
    </alias>
    <constant name="AAT_LAYOUT_NO_SELECTOR_INDEX" value="65535" c:type="HB_AAT_LAYOUT_NO_SELECTOR_INDEX">
      <doc xml:space="preserve">Used when getting or setting AAT feature selectors. Indicates that
there is no selector index corresponding to the selector of interest.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <function-macro name="BUFFER_CLUSTER_LEVEL_IS_CHARACTERS" c:identifier="HB_BUFFER_CLUSTER_LEVEL_IS_CHARACTERS" version="11.0.0" introspectable="0">
      <doc xml:space="preserve">Tests whether a cluster level does not group cluster values by graphemes.
Requires that the level be valid.</doc>
      <parameters>
        <parameter name="level">
          <doc xml:space="preserve">#hb_buffer_cluster_level_t to test</doc>
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="BUFFER_CLUSTER_LEVEL_IS_GRAPHEMES" c:identifier="HB_BUFFER_CLUSTER_LEVEL_IS_GRAPHEMES" version="11.0.0" introspectable="0">
      <doc xml:space="preserve">Tests whether a cluster level groups cluster values by graphemes. Requires
that the level be valid.</doc>
      <parameters>
        <parameter name="level">
          <doc xml:space="preserve">#hb_buffer_cluster_level_t to test</doc>
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="BUFFER_CLUSTER_LEVEL_IS_MONOTONE" c:identifier="HB_BUFFER_CLUSTER_LEVEL_IS_MONOTONE" version="11.0.0" introspectable="0">
      <doc xml:space="preserve">Tests whether a cluster level groups cluster values into monotone order.
Requires that the level be valid.</doc>
      <parameters>
        <parameter name="level">
          <doc xml:space="preserve">#hb_buffer_cluster_level_t to test</doc>
        </parameter>
      </parameters>
    </function-macro>
    <constant name="BUFFER_REPLACEMENT_CODEPOINT_DEFAULT" value="65533" c:type="HB_BUFFER_REPLACEMENT_CODEPOINT_DEFAULT" version="0.9.31">
      <doc xml:space="preserve">The default code point for replacing invalid characters in a given encoding.
Set to U+FFFD REPLACEMENT CHARACTER.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="CODEPOINT_INVALID" value="4294967295" c:type="HB_CODEPOINT_INVALID" version="8.0.0">
      <doc xml:space="preserve">Unused #hb_codepoint_t value.</doc>
      <type name="codepoint_t" c:type="hb_codepoint_t"/>
    </constant>
    <function-macro name="COLOR" c:identifier="HB_COLOR" version="2.1.0" introspectable="0">
      <doc xml:space="preserve">Constructs an #hb_color_t from four integers.</doc>
      <parameters>
        <parameter name="b">
          <doc xml:space="preserve">blue channel value</doc>
        </parameter>
        <parameter name="g">
          <doc xml:space="preserve">green channel value</doc>
        </parameter>
        <parameter name="r">
          <doc xml:space="preserve">red channel value</doc>
        </parameter>
        <parameter name="a">
          <doc xml:space="preserve">alpha channel value</doc>
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="DEPRECATED_FOR" c:identifier="HB_DEPRECATED_FOR" introspectable="0">
      <parameters>
        <parameter name="f">
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="DIRECTION_IS_BACKWARD" c:identifier="HB_DIRECTION_IS_BACKWARD" introspectable="0">
      <doc xml:space="preserve">Tests whether a text direction moves backward (from right to left, or from
bottom to top). Requires that the direction be valid.</doc>
      <parameters>
        <parameter name="dir">
          <doc xml:space="preserve">#hb_direction_t to test</doc>
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="DIRECTION_IS_FORWARD" c:identifier="HB_DIRECTION_IS_FORWARD" introspectable="0">
      <doc xml:space="preserve">Tests whether a text direction moves forward (from left to right, or from
top to bottom). Requires that the direction be valid.</doc>
      <parameters>
        <parameter name="dir">
          <doc xml:space="preserve">#hb_direction_t to test</doc>
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="DIRECTION_IS_HORIZONTAL" c:identifier="HB_DIRECTION_IS_HORIZONTAL" introspectable="0">
      <doc xml:space="preserve">Tests whether a text direction is horizontal. Requires
that the direction be valid.</doc>
      <parameters>
        <parameter name="dir">
          <doc xml:space="preserve">#hb_direction_t to test</doc>
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="DIRECTION_IS_VALID" c:identifier="HB_DIRECTION_IS_VALID" introspectable="0">
      <doc xml:space="preserve">Tests whether a text direction is valid.</doc>
      <parameters>
        <parameter name="dir">
          <doc xml:space="preserve">#hb_direction_t to test</doc>
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="DIRECTION_IS_VERTICAL" c:identifier="HB_DIRECTION_IS_VERTICAL" introspectable="0">
      <doc xml:space="preserve">Tests whether a text direction is vertical. Requires
that the direction be valid.</doc>
      <parameters>
        <parameter name="dir">
          <doc xml:space="preserve">#hb_direction_t to test</doc>
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="DIRECTION_REVERSE" c:identifier="HB_DIRECTION_REVERSE" introspectable="0">
      <doc xml:space="preserve">Reverses a text direction. Requires that the direction
be valid.</doc>
      <parameters>
        <parameter name="dir">
          <doc xml:space="preserve">#hb_direction_t to reverse</doc>
        </parameter>
      </parameters>
    </function-macro>
    <constant name="FEATURE_GLOBAL_START" value="0" c:type="HB_FEATURE_GLOBAL_START" version="2.0.0">
      <doc xml:space="preserve">Special setting for #hb_feature_t.start to apply the feature from the start
of the buffer.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="FONT_NO_VAR_NAMED_INSTANCE" value="4294967295" c:type="HB_FONT_NO_VAR_NAMED_INSTANCE" version="7.0.0">
      <doc xml:space="preserve">Constant signifying that a font does not have any
named-instance index set.  This is the default of
a font.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="LANGUAGE_INVALID" value="0" c:type="HB_LANGUAGE_INVALID" version="0.6.0">
      <doc xml:space="preserve">An unset #hb_language_t.</doc>
      <type name="language_t" c:type="hb_language_t"/>
    </constant>
    <constant name="OT_LAYOUT_DEFAULT_LANGUAGE_INDEX" value="65535" c:type="HB_OT_LAYOUT_DEFAULT_LANGUAGE_INDEX">
      <doc xml:space="preserve">Special value for language index indicating default or unsupported language.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="OT_LAYOUT_NO_FEATURE_INDEX" value="65535" c:type="HB_OT_LAYOUT_NO_FEATURE_INDEX">
      <doc xml:space="preserve">Special value for feature index indicating unsupported feature.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="OT_LAYOUT_NO_SCRIPT_INDEX" value="65535" c:type="HB_OT_LAYOUT_NO_SCRIPT_INDEX">
      <doc xml:space="preserve">Special value for script index indicating unsupported script.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="OT_LAYOUT_NO_VARIATIONS_INDEX" value="4294967295" c:type="HB_OT_LAYOUT_NO_VARIATIONS_INDEX">
      <doc xml:space="preserve">Special value for variations index indicating unsupported variation.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="OT_MAX_TAGS_PER_LANGUAGE" value="3" c:type="HB_OT_MAX_TAGS_PER_LANGUAGE" version="2.0.0">
      <doc xml:space="preserve">Maximum number of OpenType tags that can correspond to a give #hb_language_t.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="OT_MAX_TAGS_PER_SCRIPT" value="3" c:type="HB_OT_MAX_TAGS_PER_SCRIPT" version="2.0.0">
      <doc xml:space="preserve">Maximum number of OpenType tags that can correspond to a give #hb_script_t.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="OT_VAR_NO_AXIS_INDEX" value="4294967295" c:type="HB_OT_VAR_NO_AXIS_INDEX" version="1.4.2" deprecated="1" deprecated-version="2.2.0">
      <doc xml:space="preserve">Do not use.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <function-macro name="TAG" c:identifier="HB_TAG" introspectable="0">
      <doc xml:space="preserve">Constructs an #hb_tag_t from four character literals.</doc>
      <parameters>
        <parameter name="c1">
          <doc xml:space="preserve">1st character of the tag</doc>
        </parameter>
        <parameter name="c2">
          <doc xml:space="preserve">2nd character of the tag</doc>
        </parameter>
        <parameter name="c3">
          <doc xml:space="preserve">3rd character of the tag</doc>
        </parameter>
        <parameter name="c4">
          <doc xml:space="preserve">4th character of the tag</doc>
        </parameter>
      </parameters>
    </function-macro>
    <constant name="UNICODE_COMBINING_CLASS_CCC133" value="133" c:type="HB_UNICODE_COMBINING_CLASS_CCC133" deprecated="1" deprecated-version="7.2.0">
      <doc xml:space="preserve">[Tibetan]</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="UNICODE_MAX" value="1114111" c:type="HB_UNICODE_MAX" version="1.9.0">
      <doc xml:space="preserve">Maximum valid Unicode code point.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="UNICODE_MAX_DECOMPOSITION_LEN" value="19" c:type="HB_UNICODE_MAX_DECOMPOSITION_LEN" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">See Unicode 6.1 for details on the maximum decomposition length.</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <function-macro name="UNTAG" c:identifier="HB_UNTAG" version="0.6.0" introspectable="0">
      <doc xml:space="preserve">Extracts four character literals from an #hb_tag_t.</doc>
      <parameters>
        <parameter name="tag">
          <doc xml:space="preserve">an #hb_tag_t</doc>
        </parameter>
      </parameters>
    </function-macro>
    <function-macro name="VERSION_ATLEAST" c:identifier="HB_VERSION_ATLEAST" introspectable="0">
      <parameters>
        <parameter name="major">
        </parameter>
        <parameter name="minor">
        </parameter>
        <parameter name="micro">
        </parameter>
      </parameters>
    </function-macro>
    <constant name="VERSION_MAJOR" value="12" c:type="HB_VERSION_MAJOR">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="VERSION_MICRO" value="0" c:type="HB_VERSION_MICRO">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="VERSION_MINOR" value="3" c:type="HB_VERSION_MINOR">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="VERSION_STRING" value="12.3.0" c:type="HB_VERSION_STRING">
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <record name="aat_layout_feature_selector_info_t" c:type="hb_aat_layout_feature_selector_info_t">
      <doc xml:space="preserve">Structure representing a setting for an #hb_aat_layout_feature_type_t.</doc>
      <field name="name_id" writable="1">
        <doc xml:space="preserve">The selector's name identifier</doc>
        <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
      </field>
      <field name="enable" writable="1">
        <doc xml:space="preserve">The value to turn the selector on</doc>
        <type name="aat_layout_feature_selector_t" c:type="hb_aat_layout_feature_selector_t"/>
      </field>
      <field name="disable" writable="1">
        <doc xml:space="preserve">The value to turn the selector off</doc>
        <type name="aat_layout_feature_selector_t" c:type="hb_aat_layout_feature_selector_t"/>
      </field>
      <field name="reserved" readable="0" private="1">
        <type name="guint" c:type="unsigned int"/>
      </field>
    </record>
    <bitfield name="aat_layout_feature_selector_t" version="2.2.0" c:type="hb_aat_layout_feature_selector_t">
      <doc xml:space="preserve">The selectors defined for specifying AAT feature settings.</doc>
      <member name="b_aat_layout_feature_selector_invalid" value="65535" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INVALID">
        <doc xml:space="preserve">Initial, unset feature selector</doc>
      </member>
      <member name="b_aat_layout_feature_selector_all_type_features_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALL_TYPE_FEATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ALL_TYPOGRAPHIC</doc>
      </member>
      <member name="b_aat_layout_feature_selector_all_type_features_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALL_TYPE_FEATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ALL_TYPOGRAPHIC</doc>
      </member>
      <member name="b_aat_layout_feature_selector_required_ligatures_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_REQUIRED_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_required_ligatures_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_REQUIRED_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_common_ligatures_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_COMMON_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_common_ligatures_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_COMMON_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_rare_ligatures_on" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_RARE_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_rare_ligatures_off" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_RARE_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_logos_on" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LOGOS_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_logos_off" value="7" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LOGOS_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_rebus_pictures_on" value="8" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_REBUS_PICTURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_rebus_pictures_off" value="9" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_REBUS_PICTURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_diphthong_ligatures_on" value="10" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DIPHTHONG_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_diphthong_ligatures_off" value="11" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DIPHTHONG_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_squared_ligatures_on" value="12" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SQUARED_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_squared_ligatures_off" value="13" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SQUARED_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_abbrev_squared_ligatures_on" value="14" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ABBREV_SQUARED_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_abbrev_squared_ligatures_off" value="15" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ABBREV_SQUARED_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_symbol_ligatures_on" value="16" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SYMBOL_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_symbol_ligatures_off" value="17" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SYMBOL_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_contextual_ligatures_on" value="18" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CONTEXTUAL_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_contextual_ligatures_off" value="19" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CONTEXTUAL_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_historical_ligatures_on" value="20" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HISTORICAL_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_historical_ligatures_off" value="21" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HISTORICAL_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_unconnected" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_UNCONNECTED">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_partially_connected" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PARTIALLY_CONNECTED">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cursive" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CURSIVE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_upper_and_lower_case" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_UPPER_AND_LOWER_CASE">
        <doc xml:space="preserve">Deprecated</doc>
      </member>
      <member name="b_aat_layout_feature_selector_all_caps" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALL_CAPS">
        <doc xml:space="preserve">Deprecated</doc>
      </member>
      <member name="b_aat_layout_feature_selector_all_lower_case" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALL_LOWER_CASE">
        <doc xml:space="preserve">Deprecated</doc>
      </member>
      <member name="b_aat_layout_feature_selector_small_caps" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SMALL_CAPS">
        <doc xml:space="preserve">Deprecated</doc>
      </member>
      <member name="b_aat_layout_feature_selector_initial_caps" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INITIAL_CAPS">
        <doc xml:space="preserve">Deprecated</doc>
      </member>
      <member name="b_aat_layout_feature_selector_initial_caps_and_small_caps" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INITIAL_CAPS_AND_SMALL_CAPS">
        <doc xml:space="preserve">Deprecated</doc>
      </member>
      <member name="b_aat_layout_feature_selector_substitute_vertical_forms_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SUBSTITUTE_VERTICAL_FORMS_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_VERTICAL_SUBSTITUTION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_substitute_vertical_forms_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SUBSTITUTE_VERTICAL_FORMS_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_VERTICAL_SUBSTITUTION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_linguistic_rearrangement_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LINGUISTIC_REARRANGEMENT_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LINGUISTIC_REARRANGEMENT</doc>
      </member>
      <member name="b_aat_layout_feature_selector_linguistic_rearrangement_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LINGUISTIC_REARRANGEMENT_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LINGUISTIC_REARRANGEMENT</doc>
      </member>
      <member name="b_aat_layout_feature_selector_monospaced_numbers" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_MONOSPACED_NUMBERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_NUMBER_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_proportional_numbers" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PROPORTIONAL_NUMBERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_NUMBER_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_third_width_numbers" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_THIRD_WIDTH_NUMBERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_NUMBER_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_quarter_width_numbers" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_QUARTER_WIDTH_NUMBERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_NUMBER_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_word_initial_swashes_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_WORD_INITIAL_SWASHES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_word_initial_swashes_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_WORD_INITIAL_SWASHES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_word_final_swashes_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_WORD_FINAL_SWASHES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_word_final_swashes_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_WORD_FINAL_SWASHES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_line_initial_swashes_on" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LINE_INITIAL_SWASHES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_line_initial_swashes_off" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LINE_INITIAL_SWASHES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_line_final_swashes_on" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LINE_FINAL_SWASHES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_line_final_swashes_off" value="7" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LINE_FINAL_SWASHES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_non_final_swashes_on" value="8" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NON_FINAL_SWASHES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_non_final_swashes_off" value="9" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NON_FINAL_SWASHES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_show_diacritics" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SHOW_DIACRITICS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_DIACRITICS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hide_diacritics" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HIDE_DIACRITICS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_DIACRITICS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_decompose_diacritics" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DECOMPOSE_DIACRITICS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_DIACRITICS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_normal_position" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NORMAL_POSITION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_VERTICAL_POSITION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_superiors" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SUPERIORS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_VERTICAL_POSITION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_inferiors" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INFERIORS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_VERTICAL_POSITION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_ordinals" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ORDINALS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_VERTICAL_POSITION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_scientific_inferiors" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SCIENTIFIC_INFERIORS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_VERTICAL_POSITION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_fractions" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_FRACTIONS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_FRACTIONS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_vertical_fractions" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_VERTICAL_FRACTIONS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_FRACTIONS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_diagonal_fractions" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DIAGONAL_FRACTIONS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_FRACTIONS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_prevent_overlap_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PREVENT_OVERLAP_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_OVERLAPPING_CHARACTERS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_prevent_overlap_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PREVENT_OVERLAP_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_OVERLAPPING_CHARACTERS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hyphens_to_em_dash_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HYPHENS_TO_EM_DASH_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hyphens_to_em_dash_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HYPHENS_TO_EM_DASH_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hyphen_to_en_dash_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HYPHEN_TO_EN_DASH_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hyphen_to_en_dash_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HYPHEN_TO_EN_DASH_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_slashed_zero_on" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SLASHED_ZERO_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_slashed_zero_off" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SLASHED_ZERO_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_form_interrobang_on" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_FORM_INTERROBANG_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_form_interrobang_off" value="7" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_FORM_INTERROBANG_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_smart_quotes_on" value="8" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SMART_QUOTES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_smart_quotes_off" value="9" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SMART_QUOTES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_periods_to_ellipsis_on" value="10" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PERIODS_TO_ELLIPSIS_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_periods_to_ellipsis_off" value="11" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PERIODS_TO_ELLIPSIS_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hyphen_to_minus_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HYPHEN_TO_MINUS_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hyphen_to_minus_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HYPHEN_TO_MINUS_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_asterisk_to_multiply_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ASTERISK_TO_MULTIPLY_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_asterisk_to_multiply_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ASTERISK_TO_MULTIPLY_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_slash_to_divide_on" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SLASH_TO_DIVIDE_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_slash_to_divide_off" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SLASH_TO_DIVIDE_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_inequality_ligatures_on" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INEQUALITY_LIGATURES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_inequality_ligatures_off" value="7" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INEQUALITY_LIGATURES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_exponents_on" value="8" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_EXPONENTS_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_exponents_off" value="9" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_EXPONENTS_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_mathematical_greek_on" value="10" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_MATHEMATICAL_GREEK_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_mathematical_greek_off" value="11" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_MATHEMATICAL_GREEK_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_ornaments" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_ORNAMENTS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ORNAMENT_SETS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_dingbats" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DINGBATS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ORNAMENT_SETS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_pi_characters" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PI_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ORNAMENT_SETS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_fleurons" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_FLEURONS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ORNAMENT_SETS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_decorative_borders" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DECORATIVE_BORDERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ORNAMENT_SETS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_international_symbols" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INTERNATIONAL_SYMBOLS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ORNAMENT_SETS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_math_symbols" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_MATH_SYMBOLS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ORNAMENT_SETS_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_alternates" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_ALTERNATES">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_design_level1" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DESIGN_LEVEL1">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_DESIGN_COMPLEXITY_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_design_level2" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DESIGN_LEVEL2">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_DESIGN_COMPLEXITY_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_design_level3" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DESIGN_LEVEL3">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_DESIGN_COMPLEXITY_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_design_level4" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DESIGN_LEVEL4">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_DESIGN_COMPLEXITY_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_design_level5" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DESIGN_LEVEL5">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_DESIGN_COMPLEXITY_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_style_options" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_STYLE_OPTIONS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLE_OPTIONS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_display_text" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DISPLAY_TEXT">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLE_OPTIONS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_engraved_text" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ENGRAVED_TEXT">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLE_OPTIONS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_illuminated_caps" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ILLUMINATED_CAPS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLE_OPTIONS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_titling_caps" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TITLING_CAPS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLE_OPTIONS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_tall_caps" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TALL_CAPS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLE_OPTIONS</doc>
      </member>
      <member name="b_aat_layout_feature_selector_traditional_characters" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TRADITIONAL_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_simplified_characters" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SIMPLIFIED_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_jis1978_characters" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_JIS1978_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_jis1983_characters" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_JIS1983_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_jis1990_characters" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_JIS1990_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_traditional_alt_one" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TRADITIONAL_ALT_ONE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_traditional_alt_two" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TRADITIONAL_ALT_TWO">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_traditional_alt_three" value="7" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TRADITIONAL_ALT_THREE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_traditional_alt_four" value="8" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TRADITIONAL_ALT_FOUR">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_traditional_alt_five" value="9" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TRADITIONAL_ALT_FIVE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_expert_characters" value="10" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_EXPERT_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_jis2004_characters" value="11" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_JIS2004_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hojo_characters" value="12" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HOJO_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_nlccharacters" value="13" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NLCCHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_traditional_names_characters" value="14" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TRADITIONAL_NAMES_CHARACTERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_lower_case_numbers" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LOWER_CASE_NUMBERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_NUMBER_CASE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_upper_case_numbers" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_UPPER_CASE_NUMBERS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_NUMBER_CASE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_proportional_text" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PROPORTIONAL_TEXT">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TEXT_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_monospaced_text" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_MONOSPACED_TEXT">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TEXT_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_half_width_text" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HALF_WIDTH_TEXT">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TEXT_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_third_width_text" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_THIRD_WIDTH_TEXT">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TEXT_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_quarter_width_text" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_QUARTER_WIDTH_TEXT">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TEXT_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_alt_proportional_text" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALT_PROPORTIONAL_TEXT">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TEXT_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_alt_half_width_text" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALT_HALF_WIDTH_TEXT">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TEXT_SPACING</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_transliteration" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_TRANSLITERATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hanja_to_hangul" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HANJA_TO_HANGUL">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hiragana_to_katakana" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HIRAGANA_TO_KATAKANA">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_katakana_to_hiragana" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_KATAKANA_TO_HIRAGANA">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_kana_to_romanization" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_KANA_TO_ROMANIZATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_romanization_to_hiragana" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ROMANIZATION_TO_HIRAGANA">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_romanization_to_katakana" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ROMANIZATION_TO_KATAKANA">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hanja_to_hangul_alt_one" value="7" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HANJA_TO_HANGUL_ALT_ONE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hanja_to_hangul_alt_two" value="8" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HANJA_TO_HANGUL_ALT_TWO">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_hanja_to_hangul_alt_three" value="9" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HANJA_TO_HANGUL_ALT_THREE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_annotation" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_box_annotation" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_BOX_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_rounded_box_annotation" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ROUNDED_BOX_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_circle_annotation" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CIRCLE_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_inverted_circle_annotation" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INVERTED_CIRCLE_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_parenthesis_annotation" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PARENTHESIS_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_period_annotation" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PERIOD_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_roman_numeral_annotation" value="7" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ROMAN_NUMERAL_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_diamond_annotation" value="8" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DIAMOND_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_inverted_box_annotation" value="9" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INVERTED_BOX_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_inverted_rounded_box_annotation" value="10" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_INVERTED_ROUNDED_BOX_ANNOTATION">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_full_width_kana" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_FULL_WIDTH_KANA">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_KANA_SPACING_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_proportional_kana" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PROPORTIONAL_KANA">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_KANA_SPACING_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_full_width_ideographs" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_FULL_WIDTH_IDEOGRAPHS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_SPACING_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_proportional_ideographs" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PROPORTIONAL_IDEOGRAPHS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_SPACING_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_half_width_ideographs" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HALF_WIDTH_IDEOGRAPHS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_SPACING_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_canonical_composition_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CANONICAL_COMPOSITION_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_UNICODE_DECOMPOSITION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_canonical_composition_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CANONICAL_COMPOSITION_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_UNICODE_DECOMPOSITION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_compatibility_composition_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_COMPATIBILITY_COMPOSITION_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_UNICODE_DECOMPOSITION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_compatibility_composition_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_COMPATIBILITY_COMPOSITION_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_UNICODE_DECOMPOSITION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_transcoding_composition_on" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TRANSCODING_COMPOSITION_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_UNICODE_DECOMPOSITION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_transcoding_composition_off" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_TRANSCODING_COMPOSITION_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_UNICODE_DECOMPOSITION_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_ruby_kana" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_RUBY_KANA">
        <doc xml:space="preserve">Deprecated; use #HB_AAT_LAYOUT_FEATURE_SELECTOR_RUBY_KANA_OFF instead</doc>
      </member>
      <member name="b_aat_layout_feature_selector_ruby_kana" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_RUBY_KANA">
        <doc xml:space="preserve">Deprecated; use #HB_AAT_LAYOUT_FEATURE_SELECTOR_RUBY_KANA_ON instead</doc>
      </member>
      <member name="b_aat_layout_feature_selector_ruby_kana_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_RUBY_KANA_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_RUBY_KANA</doc>
      </member>
      <member name="b_aat_layout_feature_selector_ruby_kana_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_RUBY_KANA_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_RUBY_KANA</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_cjk_symbol_alternatives" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_CJK_SYMBOL_ALTERNATIVES">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_SYMBOL_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_symbol_alt_one" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_SYMBOL_ALT_ONE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_SYMBOL_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_symbol_alt_two" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_SYMBOL_ALT_TWO">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_SYMBOL_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_symbol_alt_three" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_SYMBOL_ALT_THREE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_SYMBOL_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_symbol_alt_four" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_SYMBOL_ALT_FOUR">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_SYMBOL_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_symbol_alt_five" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_SYMBOL_ALT_FIVE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_SYMBOL_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_ideographic_alternatives" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_IDEOGRAPHIC_ALTERNATIVES">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_ideographic_alt_one" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_IDEOGRAPHIC_ALT_ONE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_ideographic_alt_two" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_IDEOGRAPHIC_ALT_TWO">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_ideographic_alt_three" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_IDEOGRAPHIC_ALT_THREE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_ideographic_alt_four" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_IDEOGRAPHIC_ALT_FOUR">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_ideographic_alt_five" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_IDEOGRAPHIC_ALT_FIVE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_ALTERNATIVES_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_vertical_roman_centered" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_VERTICAL_ROMAN_CENTERED">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_VERTICAL_ROMAN_PLACEMENT_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_vertical_roman_hbaseline" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_VERTICAL_ROMAN_HBASELINE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_VERTICAL_ROMAN_PLACEMENT_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_cjk_italic_roman" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_CJK_ITALIC_ROMAN">
        <doc xml:space="preserve">Deprecated; use #HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_ITALIC_ROMAN_OFF instead</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_italic_roman" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_ITALIC_ROMAN">
        <doc xml:space="preserve">Deprecated; use #HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_ITALIC_ROMAN_ON instead</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_italic_roman_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_ITALIC_ROMAN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ITALIC_CJK_ROMAN</doc>
      </member>
      <member name="b_aat_layout_feature_selector_cjk_italic_roman_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CJK_ITALIC_ROMAN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ITALIC_CJK_ROMAN</doc>
      </member>
      <member name="b_aat_layout_feature_selector_case_sensitive_layout_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CASE_SENSITIVE_LAYOUT_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CASE_SENSITIVE_LAYOUT</doc>
      </member>
      <member name="b_aat_layout_feature_selector_case_sensitive_layout_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CASE_SENSITIVE_LAYOUT_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CASE_SENSITIVE_LAYOUT</doc>
      </member>
      <member name="b_aat_layout_feature_selector_case_sensitive_spacing_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CASE_SENSITIVE_SPACING_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CASE_SENSITIVE_LAYOUT</doc>
      </member>
      <member name="b_aat_layout_feature_selector_case_sensitive_spacing_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CASE_SENSITIVE_SPACING_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CASE_SENSITIVE_LAYOUT</doc>
      </member>
      <member name="b_aat_layout_feature_selector_alternate_horiz_kana_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALTERNATE_HORIZ_KANA_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ALTERNATE_KANA</doc>
      </member>
      <member name="b_aat_layout_feature_selector_alternate_horiz_kana_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALTERNATE_HORIZ_KANA_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ALTERNATE_KANA</doc>
      </member>
      <member name="b_aat_layout_feature_selector_alternate_vert_kana_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALTERNATE_VERT_KANA_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ALTERNATE_KANA</doc>
      </member>
      <member name="b_aat_layout_feature_selector_alternate_vert_kana_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_ALTERNATE_VERT_KANA_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_ALTERNATE_KANA</doc>
      </member>
      <member name="b_aat_layout_feature_selector_no_stylistic_alternates" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_NO_STYLISTIC_ALTERNATES">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_one_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_ONE_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_one_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_ONE_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_two_on" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_TWO_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_two_off" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_TWO_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_three_on" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_THREE_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_three_off" value="7" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_THREE_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_four_on" value="8" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_FOUR_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_four_off" value="9" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_FOUR_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_five_on" value="10" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_FIVE_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_five_off" value="11" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_FIVE_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_six_on" value="12" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_SIX_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_six_off" value="13" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_SIX_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_seven_on" value="14" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_SEVEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_seven_off" value="15" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_SEVEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_eight_on" value="16" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_EIGHT_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_eight_off" value="17" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_EIGHT_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_nine_on" value="18" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_NINE_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_nine_off" value="19" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_NINE_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_ten_on" value="20" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_TEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_ten_off" value="21" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_TEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_eleven_on" value="22" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_ELEVEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_eleven_off" value="23" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_ELEVEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_twelve_on" value="24" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_TWELVE_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_twelve_off" value="25" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_TWELVE_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_thirteen_on" value="26" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_THIRTEEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_thirteen_off" value="27" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_THIRTEEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_fourteen_on" value="28" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_FOURTEEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_fourteen_off" value="29" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_FOURTEEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_fifteen_on" value="30" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_FIFTEEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_fifteen_off" value="31" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_FIFTEEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_sixteen_on" value="32" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_SIXTEEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_sixteen_off" value="33" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_SIXTEEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_seventeen_on" value="34" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_SEVENTEEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_seventeen_off" value="35" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_SEVENTEEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_eighteen_on" value="36" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_EIGHTEEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_eighteen_off" value="37" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_EIGHTEEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_nineteen_on" value="38" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_NINETEEN_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_nineteen_off" value="39" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_NINETEEN_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_twenty_on" value="40" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_TWENTY_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_stylistic_alt_twenty_off" value="41" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_STYLISTIC_ALT_TWENTY_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_contextual_alternates_on" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CONTEXTUAL_ALTERNATES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CONTEXTUAL_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_contextual_alternates_off" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CONTEXTUAL_ALTERNATES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CONTEXTUAL_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_swash_alternates_on" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SWASH_ALTERNATES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CONTEXTUAL_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_swash_alternates_off" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_SWASH_ALTERNATES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CONTEXTUAL_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_contextual_swash_alternates_on" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CONTEXTUAL_SWASH_ALTERNATES_ON">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CONTEXTUAL_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_contextual_swash_alternates_off" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_CONTEXTUAL_SWASH_ALTERNATES_OFF">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CONTEXTUAL_ALTERNATIVES</doc>
      </member>
      <member name="b_aat_layout_feature_selector_default_lower_case" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DEFAULT_LOWER_CASE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LOWER_CASE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_lower_case_small_caps" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LOWER_CASE_SMALL_CAPS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LOWER_CASE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_lower_case_petite_caps" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_LOWER_CASE_PETITE_CAPS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_LOWER_CASE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_default_upper_case" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DEFAULT_UPPER_CASE">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_UPPER_CASE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_upper_case_small_caps" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_UPPER_CASE_SMALL_CAPS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_UPPER_CASE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_upper_case_petite_caps" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_UPPER_CASE_PETITE_CAPS">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_UPPER_CASE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_half_width_cjk_roman" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_HALF_WIDTH_CJK_ROMAN">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_ROMAN_SPACING_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_proportional_cjk_roman" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_PROPORTIONAL_CJK_ROMAN">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_ROMAN_SPACING_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_default_cjk_roman" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_DEFAULT_CJK_ROMAN">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_ROMAN_SPACING_TYPE</doc>
      </member>
      <member name="b_aat_layout_feature_selector_full_width_cjk_roman" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_SELECTOR_FULL_WIDTH_CJK_ROMAN">
        <doc xml:space="preserve">for #HB_AAT_LAYOUT_FEATURE_TYPE_CJK_ROMAN_SPACING_TYPE</doc>
      </member>
    </bitfield>
    <function name="aat_layout_feature_type_get_name_id" c:identifier="hb_aat_layout_feature_type_get_name_id" version="2.2.0">
      <doc xml:space="preserve">Fetches the name identifier of the specified feature type in the face's `name` table.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Name identifier of the requested feature type</doc>
        <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="feature_type" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_aat_layout_feature_type_t of the requested feature type</doc>
          <type name="aat_layout_feature_type_t" c:type="hb_aat_layout_feature_type_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="aat_layout_feature_type_get_selector_infos" c:identifier="hb_aat_layout_feature_type_get_selector_infos" version="2.2.0">
      <doc xml:space="preserve">Fetches a list of the selectors available for the specified feature in the given face.

If upon return, @default_index is set to #HB_AAT_LAYOUT_NO_SELECTOR_INDEX, then
the feature type is non-exclusive.  Otherwise, @default_index is the index of
the selector that is selected by default.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Number of all available feature selectors</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="feature_type" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_aat_layout_feature_type_t of the requested feature type</doc>
          <type name="aat_layout_feature_type_t" c:type="hb_aat_layout_feature_type_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first feature type to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="selector_count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of selectors to return;
                 Output = the actual number of selectors returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="selectors" direction="out" caller-allocates="1" transfer-ownership="none" optional="1" allow-none="1">
          <doc xml:space="preserve">
            A buffer pointer. The selectors available for the feature type queries.</doc>
          <array length="3" zero-terminated="0" c:type="hb_aat_layout_feature_selector_info_t*">
            <type name="aat_layout_feature_selector_info_t" c:type="hb_aat_layout_feature_selector_info_t"/>
          </array>
        </parameter>
        <parameter name="default_index" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">The index of the feature's default selector, if any</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="aat_layout_feature_type_t" version="2.2.0" c:type="hb_aat_layout_feature_type_t">
      <doc xml:space="preserve">The possible feature types defined for AAT shaping, from Apple [Font Feature Registry](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html).</doc>
      <member name="b_aat_layout_feature_type_invalid" value="65535" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_INVALID">
        <doc xml:space="preserve">Initial, unset feature type</doc>
      </member>
      <member name="b_aat_layout_feature_type_all_typographic" value="0" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_ALL_TYPOGRAPHIC">
        <doc xml:space="preserve">[All Typographic Features](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type0)</doc>
      </member>
      <member name="b_aat_layout_feature_type_ligatures" value="1" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_LIGATURES">
        <doc xml:space="preserve">[Ligatures](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type1)</doc>
      </member>
      <member name="b_aat_layout_feature_type_cursive_connection" value="2" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_CURSIVE_CONNECTION">
        <doc xml:space="preserve">[Cursive Connection](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type2)</doc>
      </member>
      <member name="b_aat_layout_feature_type_letter_case" value="3" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_LETTER_CASE">
        <doc xml:space="preserve">[Letter Case](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type3)</doc>
      </member>
      <member name="b_aat_layout_feature_type_vertical_substitution" value="4" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_VERTICAL_SUBSTITUTION">
        <doc xml:space="preserve">[Vertical Substitution](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type4)</doc>
      </member>
      <member name="b_aat_layout_feature_type_linguistic_rearrangement" value="5" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_LINGUISTIC_REARRANGEMENT">
        <doc xml:space="preserve">[Linguistic Rearrangement](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type5)</doc>
      </member>
      <member name="b_aat_layout_feature_type_number_spacing" value="6" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_NUMBER_SPACING">
        <doc xml:space="preserve">[Number Spacing](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type6)</doc>
      </member>
      <member name="b_aat_layout_feature_type_smart_swash_type" value="8" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_SMART_SWASH_TYPE">
        <doc xml:space="preserve">[Smart Swash](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type8)</doc>
      </member>
      <member name="b_aat_layout_feature_type_diacritics_type" value="9" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_DIACRITICS_TYPE">
        <doc xml:space="preserve">[Diacritics](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type9)</doc>
      </member>
      <member name="b_aat_layout_feature_type_vertical_position" value="10" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_VERTICAL_POSITION">
        <doc xml:space="preserve">[Vertical Position](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type10)</doc>
      </member>
      <member name="b_aat_layout_feature_type_fractions" value="11" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_FRACTIONS">
        <doc xml:space="preserve">[Fractions](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type11)</doc>
      </member>
      <member name="b_aat_layout_feature_type_overlapping_characters_type" value="13" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_OVERLAPPING_CHARACTERS_TYPE">
        <doc xml:space="preserve">[Overlapping Characters](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type13)</doc>
      </member>
      <member name="b_aat_layout_feature_type_typographic_extras" value="14" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_TYPOGRAPHIC_EXTRAS">
        <doc xml:space="preserve">[Typographic Extras](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type14)</doc>
      </member>
      <member name="b_aat_layout_feature_type_mathematical_extras" value="15" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_MATHEMATICAL_EXTRAS">
        <doc xml:space="preserve">[Mathematical Extras](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type15)</doc>
      </member>
      <member name="b_aat_layout_feature_type_ornament_sets_type" value="16" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_ORNAMENT_SETS_TYPE">
        <doc xml:space="preserve">[Ornament Sets](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type16)</doc>
      </member>
      <member name="b_aat_layout_feature_type_character_alternatives" value="17" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_ALTERNATIVES">
        <doc xml:space="preserve">[Character Alternatives](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type17)</doc>
      </member>
      <member name="b_aat_layout_feature_type_design_complexity_type" value="18" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_DESIGN_COMPLEXITY_TYPE">
        <doc xml:space="preserve">[Design Complexity](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type18)</doc>
      </member>
      <member name="b_aat_layout_feature_type_style_options" value="19" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_STYLE_OPTIONS">
        <doc xml:space="preserve">[Style Options](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type19)</doc>
      </member>
      <member name="b_aat_layout_feature_type_character_shape" value="20" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_CHARACTER_SHAPE">
        <doc xml:space="preserve">[Character Shape](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type20)</doc>
      </member>
      <member name="b_aat_layout_feature_type_number_case" value="21" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_NUMBER_CASE">
        <doc xml:space="preserve">[Number Case](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type21)</doc>
      </member>
      <member name="b_aat_layout_feature_type_text_spacing" value="22" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_TEXT_SPACING">
        <doc xml:space="preserve">[Text Spacing](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type22)</doc>
      </member>
      <member name="b_aat_layout_feature_type_transliteration" value="23" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_TRANSLITERATION">
        <doc xml:space="preserve">[Transliteration](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type23)</doc>
      </member>
      <member name="b_aat_layout_feature_type_annotation_type" value="24" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_ANNOTATION_TYPE">
        <doc xml:space="preserve">[Annotation](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type24)</doc>
      </member>
      <member name="b_aat_layout_feature_type_kana_spacing_type" value="25" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_KANA_SPACING_TYPE">
        <doc xml:space="preserve">[Kana Spacing](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type25)</doc>
      </member>
      <member name="b_aat_layout_feature_type_ideographic_spacing_type" value="26" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_SPACING_TYPE">
        <doc xml:space="preserve">[Ideographic Spacing](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type26)</doc>
      </member>
      <member name="b_aat_layout_feature_type_unicode_decomposition_type" value="27" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_UNICODE_DECOMPOSITION_TYPE">
        <doc xml:space="preserve">[Unicode Decomposition](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type27)</doc>
      </member>
      <member name="b_aat_layout_feature_type_ruby_kana" value="28" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_RUBY_KANA">
        <doc xml:space="preserve">[Ruby Kana](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type28)</doc>
      </member>
      <member name="b_aat_layout_feature_type_cjk_symbol_alternatives_type" value="29" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_CJK_SYMBOL_ALTERNATIVES_TYPE">
        <doc xml:space="preserve">[CJK Symbol Alternatives](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type29)</doc>
      </member>
      <member name="b_aat_layout_feature_type_ideographic_alternatives_type" value="30" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_IDEOGRAPHIC_ALTERNATIVES_TYPE">
        <doc xml:space="preserve">[Ideographic Alternatives](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type30)</doc>
      </member>
      <member name="b_aat_layout_feature_type_cjk_vertical_roman_placement_type" value="31" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_CJK_VERTICAL_ROMAN_PLACEMENT_TYPE">
        <doc xml:space="preserve">[CJK Vertical Roman Placement](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type31)</doc>
      </member>
      <member name="b_aat_layout_feature_type_italic_cjk_roman" value="32" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_ITALIC_CJK_ROMAN">
        <doc xml:space="preserve">[Italic CJK Roman](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type32)</doc>
      </member>
      <member name="b_aat_layout_feature_type_case_sensitive_layout" value="33" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_CASE_SENSITIVE_LAYOUT">
        <doc xml:space="preserve">[Case Sensitive Layout](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type33)</doc>
      </member>
      <member name="b_aat_layout_feature_type_alternate_kana" value="34" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_ALTERNATE_KANA">
        <doc xml:space="preserve">[Alternate Kana](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type34)</doc>
      </member>
      <member name="b_aat_layout_feature_type_stylistic_alternatives" value="35" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_STYLISTIC_ALTERNATIVES">
        <doc xml:space="preserve">[Stylistic Alternatives](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type35)</doc>
      </member>
      <member name="b_aat_layout_feature_type_contextual_alternatives" value="36" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_CONTEXTUAL_ALTERNATIVES">
        <doc xml:space="preserve">[Contextual Alternatives](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type36)</doc>
      </member>
      <member name="b_aat_layout_feature_type_lower_case" value="37" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_LOWER_CASE">
        <doc xml:space="preserve">[Lower Case](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type37)</doc>
      </member>
      <member name="b_aat_layout_feature_type_upper_case" value="38" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_UPPER_CASE">
        <doc xml:space="preserve">[Upper Case](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type38)</doc>
      </member>
      <member name="b_aat_layout_feature_type_language_tag_type" value="39" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_LANGUAGE_TAG_TYPE">
        <doc xml:space="preserve">[Language Tag](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type39)</doc>
      </member>
      <member name="b_aat_layout_feature_type_cjk_roman_spacing_type" value="103" c:identifier="HB_AAT_LAYOUT_FEATURE_TYPE_CJK_ROMAN_SPACING_TYPE">
        <doc xml:space="preserve">[CJK Roman Spacing](https://developer.apple.com/fonts/TrueType-Reference-Manual/RM09/AppendixF.html#Type103)</doc>
      </member>
    </bitfield>
    <function name="aat_layout_get_feature_types" c:identifier="hb_aat_layout_get_feature_types" version="2.2.0">
      <doc xml:space="preserve">Fetches a list of the AAT feature types included in the specified face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Number of all available feature types.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first feature type to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="feature_count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of feature types to return;
                Output = the actual number of feature types returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="features" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">Array of feature types found</doc>
          <array length="2" zero-terminated="0" c:type="hb_aat_layout_feature_type_t*">
            <type name="aat_layout_feature_type_t" c:type="hb_aat_layout_feature_type_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="aat_layout_has_positioning" c:identifier="hb_aat_layout_has_positioning" version="2.3.0">
      <doc xml:space="preserve">Tests whether the specified face includes any positioning information
in the `kerx` table.

&lt;note&gt;Note: does not examine the `GPOS` table.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="aat_layout_has_substitution" c:identifier="hb_aat_layout_has_substitution" version="2.3.0">
      <doc xml:space="preserve">Tests whether the specified face includes any substitutions in the
`morx` or `mort` tables.

&lt;note&gt;Note: does not examine the `GSUB` table.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="aat_layout_has_tracking" c:identifier="hb_aat_layout_has_tracking" version="2.3.0">
      <doc xml:space="preserve">Tests whether the specified face includes any tracking information
in the `trak` table.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_copy_writable_or_fail" c:identifier="hb_blob_copy_writable_or_fail" version="1.8.0">
      <doc xml:space="preserve">Makes a writable copy of @blob.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new blob, or nullptr if allocation failed</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">A blob.</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_create" c:identifier="hb_blob_create" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Creates a new "blob" object wrapping @data.  The @mode parameter is used
to negotiate ownership and lifecycle of @data.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">New blob, or the empty blob if something failed or if @length is
zero.  Destroy with hb_blob_destroy().</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:space="preserve">Pointer to blob data.</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
        <parameter name="length" transfer-ownership="none">
          <doc xml:space="preserve">Length of @data in bytes.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="mode" transfer-ownership="none">
          <doc xml:space="preserve">Memory mode for @data.</doc>
          <type name="memory_mode_t" c:type="hb_memory_mode_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data parameter to pass to @destroy.</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Callback to call when @data is not needed anymore.</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_create_from_file" c:identifier="hb_blob_create_from_file" version="1.7.7">
      <doc xml:space="preserve">Creates a new blob containing the data from the
specified binary font file.

The filename is passed directly to the system on all platforms,
except on Windows, where the filename is interpreted as UTF-8.
Only if the filename is not valid UTF-8, it will be interpreted
according to the system codepage.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">An #hb_blob_t pointer with the content of the file,
or hb_blob_get_empty() if failed.</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="file_name" transfer-ownership="none">
          <doc xml:space="preserve">A font filename</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_create_from_file_or_fail" c:identifier="hb_blob_create_from_file_or_fail" version="2.8.2">
      <doc xml:space="preserve">Creates a new blob containing the data from the specified file.

The filename is passed directly to the system on all platforms,
except on Windows, where the filename is interpreted as UTF-8.
Only if the filename is not valid UTF-8, it will be interpreted
according to the system codepage.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">An #hb_blob_t pointer with the content of the file,
or `NULL` if failed.</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="file_name" transfer-ownership="none">
          <doc xml:space="preserve">A filename</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_create_or_fail" c:identifier="hb_blob_create_or_fail" version="2.8.2" introspectable="0">
      <doc xml:space="preserve">Creates a new "blob" object wrapping @data.  The @mode parameter is used
to negotiate ownership and lifecycle of @data.

Note that this function returns a freshly-allocated empty blob even if @length
is zero. This is in contrast to hb_blob_create(), which returns the singleton
empty blob (as returned by hb_blob_get_empty()) if @length is zero.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">New blob, or `NULL` if failed.  Destroy with hb_blob_destroy().</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:space="preserve">Pointer to blob data.</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
        <parameter name="length" transfer-ownership="none">
          <doc xml:space="preserve">Length of @data in bytes.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="mode" transfer-ownership="none">
          <doc xml:space="preserve">Memory mode for @data.</doc>
          <type name="memory_mode_t" c:type="hb_memory_mode_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data parameter to pass to @destroy.</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Callback to call when @data is not needed anymore.</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_create_sub_blob" c:identifier="hb_blob_create_sub_blob" version="0.9.2">
      <doc xml:space="preserve">Returns a blob that represents a range of bytes in @parent.  The new
blob is always created with #HB_MEMORY_MODE_READONLY, meaning that it
will never modify data in the parent blob.  The parent data is not
expected to be modified, and will result in undefined behavior if it
is.

Makes @parent immutable.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">New blob, or the empty blob if something failed or if
@length is zero or @offset is beyond the end of @parent's data.  Destroy
with hb_blob_destroy().</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="parent" transfer-ownership="none">
          <doc xml:space="preserve">Parent blob.</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="offset" transfer-ownership="none">
          <doc xml:space="preserve">Start offset of sub-blob within @parent, in bytes.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="length" transfer-ownership="none">
          <doc xml:space="preserve">Length of sub-blob.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_destroy" c:identifier="hb_blob_destroy" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Decreases the reference count on @blob, and if it reaches zero, destroys
@blob, freeing all memory, possibly calling the destroy-callback the blob
was created for if it has not been called already.

See TODO:link object types for more information.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">a blob.</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_get_data" c:identifier="hb_blob_get_data" version="0.9.2">
      <doc xml:space="preserve">Fetches the data from a blob.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">the byte data of @blob.</doc>
        <array length="1" zero-terminated="0" c:type="const char*">
          <type name="utf8" c:type="char"/>
        </array>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">a blob.</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The length in bytes of the data retrieved</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_get_data_writable" c:identifier="hb_blob_get_data_writable" version="0.9.2">
      <doc xml:space="preserve">Tries to make blob data writable (possibly copying it) and
return pointer to data.

Fails if blob has been made immutable, or if memory allocation
fails.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Writable blob data,
or `NULL` if failed.</doc>
        <array length="1" zero-terminated="0" c:type="char*">
          <type name="utf8" c:type="char"/>
        </array>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">a blob.</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">output length of the writable data.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_get_empty" c:identifier="hb_blob_get_empty" version="0.9.2">
      <doc xml:space="preserve">Returns the singleton empty blob.

See TODO:link object types for more information.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty blob.</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
    </function>
    <function name="blob_get_length" c:identifier="hb_blob_get_length" version="0.9.2">
      <doc xml:space="preserve">Fetches the length of a blob's data.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the length of @blob data in bytes.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">a blob.</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_get_user_data" c:identifier="hb_blob_get_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Fetches the user data associated with the specified key,
attached to the specified font-functions structure.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">a blob</doc>
          <type name="blob_t" c:type="const hb_blob_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_is_immutable" c:identifier="hb_blob_is_immutable" version="0.9.2">
      <doc xml:space="preserve">Tests whether a blob is immutable.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @blob is immutable, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">a blob.</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_make_immutable" c:identifier="hb_blob_make_immutable" version="0.9.2">
      <doc xml:space="preserve">Makes a blob immutable.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">a blob</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_reference" c:identifier="hb_blob_reference" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on @blob.

See TODO:link object types for more information.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">@blob.</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">a blob.</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="blob_set_user_data" c:identifier="hb_blob_set_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the specified blob.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_blob_t</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to set</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data to set</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="blob_t" c:type="hb_blob_t" opaque="1" glib:type-name="hb_blob_t" glib:get-type="hb_gobject_blob_get_type" c:symbol-prefix="gobject_blob">
      <doc xml:space="preserve">Data type for blobs. A blob wraps a chunk of binary
data and facilitates its lifecycle management between
a client program and HarfBuzz.</doc>
    </record>
    <function name="buffer_add" c:identifier="hb_buffer_add" version="0.9.7">
      <doc xml:space="preserve">Appends a character with the Unicode value of @codepoint to @buffer, and
gives it the initial cluster value of @cluster. Clusters can be any thing
the client wants, they are usually used to refer to the index of the
character in the input text stream and are output in
#hb_glyph_info_t.cluster field.

This function does not check the validity of @codepoint, it is up to the
caller to ensure it is a valid Unicode code point.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="codepoint" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode code point.</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="cluster" transfer-ownership="none">
          <doc xml:space="preserve">The cluster value of @codepoint.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_add_codepoints" c:identifier="hb_buffer_add_codepoints" version="0.9.31">
      <doc xml:space="preserve">Appends characters from @text array to @buffer. The @item_offset is the
position of the first character from @text that will be appended, and
@item_length is the number of character. When shaping part of a larger text
(e.g. a run of text from a paragraph), instead of passing just the substring
corresponding to the run, it is preferable to pass the whole
paragraph and specify the run start and length as @item_offset and
@item_length, respectively, to give HarfBuzz the full context to be able,
for example, to do cross-run Arabic shaping or properly handle combining
marks at stat of run.

This function does not check the validity of @text, it is up to the caller
to ensure it contains a valid Unicode scalar values.  In contrast,
hb_buffer_add_utf32() can be used that takes similar input but performs
sanity-check on the input.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">a #hb_buffer_t to append characters to.</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="text" transfer-ownership="none">
          <doc xml:space="preserve">an array of Unicode code points to append.</doc>
          <array length="2" zero-terminated="0" c:type="const hb_codepoint_t*">
            <type name="codepoint_t" c:type="hb_codepoint_t"/>
          </array>
        </parameter>
        <parameter name="text_length" transfer-ownership="none">
          <doc xml:space="preserve">the length of the @text, or -1 if it is `NULL` terminated.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="item_offset" transfer-ownership="none">
          <doc xml:space="preserve">the offset of the first code point to add to the @buffer.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="item_length" transfer-ownership="none">
          <doc xml:space="preserve">the number of code points to add to the @buffer, or -1 for the
              end of @text (assuming it is `NULL` terminated).</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_add_latin1" c:identifier="hb_buffer_add_latin1" version="0.9.39">
      <doc xml:space="preserve">Similar to hb_buffer_add_codepoints(), but allows only access to first 256
Unicode code points that can fit in 8-bit strings.

&lt;note&gt;Has nothing to do with non-Unicode Latin-1 encoding.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="text" transfer-ownership="none">
          <doc xml:space="preserve">an array of UTF-8
              characters to append</doc>
          <array length="2" zero-terminated="0" c:type="const uint8_t*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="text_length" transfer-ownership="none">
          <doc xml:space="preserve">the length of the @text, or -1 if it is `NULL` terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="item_offset" transfer-ownership="none">
          <doc xml:space="preserve">the offset of the first character to add to the @buffer</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="item_length" transfer-ownership="none">
          <doc xml:space="preserve">the number of characters to add to the @buffer, or -1 for the
              end of @text (assuming it is `NULL` terminated)</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_add_utf16" c:identifier="hb_buffer_add_utf16" version="0.9.2">
      <doc xml:space="preserve">See hb_buffer_add_codepoints().

Replaces invalid UTF-16 characters with the @buffer replacement code point,
see hb_buffer_set_replacement_codepoint().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="text" transfer-ownership="none">
          <doc xml:space="preserve">An array of UTF-16 characters to append</doc>
          <array length="2" zero-terminated="0" c:type="const uint16_t*">
            <type name="guint16" c:type="uint16_t"/>
          </array>
        </parameter>
        <parameter name="text_length" transfer-ownership="none">
          <doc xml:space="preserve">The length of the @text, or -1 if it is `NULL` terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="item_offset" transfer-ownership="none">
          <doc xml:space="preserve">The offset of the first character to add to the @buffer</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="item_length" transfer-ownership="none">
          <doc xml:space="preserve">The number of characters to add to the @buffer, or -1 for the
              end of @text (assuming it is `NULL` terminated)</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_add_utf32" c:identifier="hb_buffer_add_utf32" version="0.9.2">
      <doc xml:space="preserve">See hb_buffer_add_codepoints().

Replaces invalid UTF-32 characters with the @buffer replacement code point,
see hb_buffer_set_replacement_codepoint().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="text" transfer-ownership="none">
          <doc xml:space="preserve">An array of UTF-32 characters to append</doc>
          <array length="2" zero-terminated="0" c:type="const uint32_t*">
            <type name="guint32" c:type="uint32_t"/>
          </array>
        </parameter>
        <parameter name="text_length" transfer-ownership="none">
          <doc xml:space="preserve">The length of the @text, or -1 if it is `NULL` terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="item_offset" transfer-ownership="none">
          <doc xml:space="preserve">The offset of the first character to add to the @buffer</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="item_length" transfer-ownership="none">
          <doc xml:space="preserve">The number of characters to add to the @buffer, or -1 for the
              end of @text (assuming it is `NULL` terminated)</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_add_utf8" c:identifier="hb_buffer_add_utf8" version="0.9.2">
      <doc xml:space="preserve">See hb_buffer_add_codepoints().

Replaces invalid UTF-8 characters with the @buffer replacement code point,
see hb_buffer_set_replacement_codepoint().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="text" transfer-ownership="none">
          <doc xml:space="preserve">An array of UTF-8
              characters to append.</doc>
          <array length="2" zero-terminated="0" c:type="const char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="text_length" transfer-ownership="none">
          <doc xml:space="preserve">The length of the @text, or -1 if it is `NULL` terminated.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="item_offset" transfer-ownership="none">
          <doc xml:space="preserve">The offset of the first character to add to the @buffer.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="item_length" transfer-ownership="none">
          <doc xml:space="preserve">The number of characters to add to the @buffer, or -1 for the
              end of @text (assuming it is `NULL` terminated).</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_allocation_successful" c:identifier="hb_buffer_allocation_successful" version="0.9.2">
      <doc xml:space="preserve">Check if allocating memory for the buffer succeeded.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @buffer memory allocation succeeded, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_append" c:identifier="hb_buffer_append" version="1.5.0">
      <doc xml:space="preserve">Append (part of) contents of another buffer to this buffer.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="source" transfer-ownership="none">
          <doc xml:space="preserve">source #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
        <parameter name="start" transfer-ownership="none">
          <doc xml:space="preserve">start index into source buffer to copy.  Use 0 to copy from start of buffer.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="end" transfer-ownership="none">
          <doc xml:space="preserve">end index into source buffer to copy.  Use @UINT_MAX (or ((unsigned int) -1)) to copy to end of buffer.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_clear_contents" c:identifier="hb_buffer_clear_contents" version="0.9.11">
      <doc xml:space="preserve">Similar to hb_buffer_reset(), but does not clear the Unicode functions and
the replacement code point.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <enumeration name="buffer_cluster_level_t" version="0.9.42" c:type="hb_buffer_cluster_level_t">
      <doc xml:space="preserve">Data type for holding HarfBuzz's clustering behavior options. The cluster level
dictates one aspect of how HarfBuzz will treat non-base characters
during shaping.

In @HB_BUFFER_CLUSTER_LEVEL_MONOTONE_GRAPHEMES, non-base
characters are merged into the cluster of the base character that precedes them.
There is also cluster merging every time the clusters will otherwise become non-monotone.

In @HB_BUFFER_CLUSTER_LEVEL_MONOTONE_CHARACTERS, non-base characters are initially
assigned their own cluster values, which are not merged into preceding base
clusters. This allows HarfBuzz to perform additional operations like reorder
sequences of adjacent marks. The output is still monotone, but the cluster
values are more granular.

In @HB_BUFFER_CLUSTER_LEVEL_CHARACTERS, non-base characters are assigned their
own cluster values, which are not merged into preceding base clusters. Moreover,
the cluster values are not merged into monotone order. This is the most granular
cluster level, and it is useful for clients that need to know the exact cluster
values of each character, but is harder to use for clients, since clusters
might appear in any order.

In @HB_BUFFER_CLUSTER_LEVEL_GRAPHEMES, non-base characters are merged into the
cluster of the base character that precedes them. This is similar to the Unicode
Grapheme Cluster algorithm, but it is not exactly the same. The output is
not forced to be monotone. This is useful for clients that want to use HarfBuzz
as a cheap implementation of the Unicode Grapheme Cluster algorithm.

@HB_BUFFER_CLUSTER_LEVEL_MONOTONE_GRAPHEMES is the default, because it maintains
backward compatibility with older versions of HarfBuzz. New client programs that
do not need to maintain such backward compatibility are recommended to use
@HB_BUFFER_CLUSTER_LEVEL_MONOTONE_CHARACTERS instead of the default.</doc>
      <member name="monotone_graphemes" value="0" c:identifier="HB_BUFFER_CLUSTER_LEVEL_MONOTONE_GRAPHEMES">
        <doc xml:space="preserve">Return cluster values grouped by graphemes into
  monotone order.</doc>
      </member>
      <member name="monotone_characters" value="1" c:identifier="HB_BUFFER_CLUSTER_LEVEL_MONOTONE_CHARACTERS">
        <doc xml:space="preserve">Return cluster values grouped into monotone order.</doc>
      </member>
      <member name="characters" value="2" c:identifier="HB_BUFFER_CLUSTER_LEVEL_CHARACTERS">
        <doc xml:space="preserve">Don't group cluster values.</doc>
      </member>
      <member name="graphemes" value="3" c:identifier="HB_BUFFER_CLUSTER_LEVEL_GRAPHEMES">
        <doc xml:space="preserve">Only group clusters, but don't enforce monotone order.</doc>
      </member>
      <member name="default" value="0" c:identifier="HB_BUFFER_CLUSTER_LEVEL_DEFAULT">
        <doc xml:space="preserve">Default cluster level,
  equal to @HB_BUFFER_CLUSTER_LEVEL_MONOTONE_GRAPHEMES.</doc>
      </member>
    </enumeration>
    <enumeration name="buffer_content_type_t" c:type="hb_buffer_content_type_t">
      <doc xml:space="preserve">The type of #hb_buffer_t contents.</doc>
      <member name="invalid" value="0" c:identifier="HB_BUFFER_CONTENT_TYPE_INVALID">
        <doc xml:space="preserve">Initial value for new buffer.</doc>
      </member>
      <member name="unicode" value="1" c:identifier="HB_BUFFER_CONTENT_TYPE_UNICODE">
        <doc xml:space="preserve">The buffer contains input characters (before shaping).</doc>
      </member>
      <member name="glyphs" value="2" c:identifier="HB_BUFFER_CONTENT_TYPE_GLYPHS">
        <doc xml:space="preserve">The buffer contains output glyphs (after shaping).</doc>
      </member>
    </enumeration>
    <function name="buffer_create" c:identifier="hb_buffer_create" version="0.9.2">
      <doc xml:space="preserve">Creates a new #hb_buffer_t with all properties to defaults.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">
A newly allocated #hb_buffer_t with a reference count of 1. The initial
reference count should be released with hb_buffer_destroy() when you are done
using the #hb_buffer_t. This function never returns `NULL`. If memory cannot
be allocated, a special #hb_buffer_t object will be returned on which
hb_buffer_allocation_successful() returns `false`.</doc>
        <type name="buffer_t" c:type="hb_buffer_t*"/>
      </return-value>
    </function>
    <function name="buffer_create_similar" c:identifier="hb_buffer_create_similar" version="3.3.0">
      <doc xml:space="preserve">Creates a new #hb_buffer_t, similar to hb_buffer_create(). The only
difference is that the buffer is configured similarly to @src.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">
A newly allocated #hb_buffer_t, similar to hb_buffer_create().</doc>
        <type name="buffer_t" c:type="hb_buffer_t*"/>
      </return-value>
      <parameters>
        <parameter name="src" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_deserialize_glyphs" c:identifier="hb_buffer_deserialize_glyphs" version="0.9.7">
      <doc xml:space="preserve">Deserializes glyphs @buffer from textual representation in the format
produced by hb_buffer_serialize_glyphs().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the full string was parsed, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_buffer_t buffer.</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="buf" transfer-ownership="none">
          <doc xml:space="preserve">string to deserialize</doc>
          <array length="2" zero-terminated="0" c:type="const char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
        <parameter name="buf_len" transfer-ownership="none">
          <doc xml:space="preserve">the size of @buf, or -1 if it is `NULL`-terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="end_ptr" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">output pointer to the character after last
                              consumed one.</doc>
          <type name="utf8" c:type="const char**"/>
        </parameter>
        <parameter name="font" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">font for getting glyph IDs</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="format" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_buffer_serialize_format_t of the input @buf</doc>
          <type name="buffer_serialize_format_t" c:type="hb_buffer_serialize_format_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_deserialize_unicode" c:identifier="hb_buffer_deserialize_unicode" version="2.7.3">
      <doc xml:space="preserve">Deserializes Unicode @buffer from textual representation in the format
produced by hb_buffer_serialize_unicode().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the full string was parsed, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_buffer_t buffer.</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="buf" transfer-ownership="none">
          <doc xml:space="preserve">string to deserialize</doc>
          <array length="2" zero-terminated="0" c:type="const char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
        <parameter name="buf_len" transfer-ownership="none">
          <doc xml:space="preserve">the size of @buf, or -1 if it is `NULL`-terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="end_ptr" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">output pointer to the character after last
                              consumed one.</doc>
          <type name="utf8" c:type="const char**"/>
        </parameter>
        <parameter name="format" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_buffer_serialize_format_t of the input @buf</doc>
          <type name="buffer_serialize_format_t" c:type="hb_buffer_serialize_format_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_destroy" c:identifier="hb_buffer_destroy" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Deallocate the @buffer.
Decreases the reference count on @buffer by one. If the result is zero, then
@buffer and all associated resources are freed. See hb_buffer_reference().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_diff" c:identifier="hb_buffer_diff" version="1.5.0">
      <doc xml:space="preserve">If dottedcircle_glyph is (hb_codepoint_t) -1 then #HB_BUFFER_DIFF_FLAG_DOTTED_CIRCLE_PRESENT
and #HB_BUFFER_DIFF_FLAG_NOTDEF_PRESENT are never returned.  This should be used by most
callers if just comparing two buffers is needed.</doc>
      <return-value transfer-ownership="none">
        <type name="buffer_diff_flags_t" c:type="hb_buffer_diff_flags_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">a buffer.</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="reference" transfer-ownership="none">
          <doc xml:space="preserve">other buffer to compare to.</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="dottedcircle_glyph" transfer-ownership="none">
          <doc xml:space="preserve">glyph id of U+25CC DOTTED CIRCLE, or (hb_codepoint_t) -1.</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="position_fuzz" transfer-ownership="none">
          <doc xml:space="preserve">allowed absolute difference in position values.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="buffer_diff_flags_t" version="1.5.0" c:type="hb_buffer_diff_flags_t">
      <doc xml:space="preserve">Flags from comparing two #hb_buffer_t's.

Buffer with different #hb_buffer_content_type_t cannot be meaningfully
compared in any further detail.

For buffers with differing length, the per-glyph comparison is not
attempted, though we do still scan reference buffer for dotted circle and
`.notdef` glyphs.

If the buffers have the same length, we compare them glyph-by-glyph and
report which aspect(s) of the glyph info/position are different.</doc>
      <member name="equal" value="0" c:identifier="HB_BUFFER_DIFF_FLAG_EQUAL">
        <doc xml:space="preserve">equal buffers.</doc>
      </member>
      <member name="content_type_mismatch" value="1" c:identifier="HB_BUFFER_DIFF_FLAG_CONTENT_TYPE_MISMATCH">
        <doc xml:space="preserve">buffers with different
    #hb_buffer_content_type_t.</doc>
      </member>
      <member name="length_mismatch" value="2" c:identifier="HB_BUFFER_DIFF_FLAG_LENGTH_MISMATCH">
        <doc xml:space="preserve">buffers with differing length.</doc>
      </member>
      <member name="notdef_present" value="4" c:identifier="HB_BUFFER_DIFF_FLAG_NOTDEF_PRESENT">
        <doc xml:space="preserve">`.notdef` glyph is present in the
    reference buffer.</doc>
      </member>
      <member name="dotted_circle_present" value="8" c:identifier="HB_BUFFER_DIFF_FLAG_DOTTED_CIRCLE_PRESENT">
        <doc xml:space="preserve">dotted circle glyph is present
    in the reference buffer.</doc>
      </member>
      <member name="codepoint_mismatch" value="16" c:identifier="HB_BUFFER_DIFF_FLAG_CODEPOINT_MISMATCH">
        <doc xml:space="preserve">difference in #hb_glyph_info_t.codepoint</doc>
      </member>
      <member name="cluster_mismatch" value="32" c:identifier="HB_BUFFER_DIFF_FLAG_CLUSTER_MISMATCH">
        <doc xml:space="preserve">difference in #hb_glyph_info_t.cluster</doc>
      </member>
      <member name="glyph_flags_mismatch" value="64" c:identifier="HB_BUFFER_DIFF_FLAG_GLYPH_FLAGS_MISMATCH">
        <doc xml:space="preserve">difference in #hb_glyph_flags_t.</doc>
      </member>
      <member name="position_mismatch" value="128" c:identifier="HB_BUFFER_DIFF_FLAG_POSITION_MISMATCH">
        <doc xml:space="preserve">difference in #hb_glyph_position_t.</doc>
      </member>
    </bitfield>
    <bitfield name="buffer_flags_t" version="0.9.20" c:type="hb_buffer_flags_t">
      <doc xml:space="preserve">Flags for #hb_buffer_t.</doc>
      <member name="default" value="0" c:identifier="HB_BUFFER_FLAG_DEFAULT">
        <doc xml:space="preserve">the default buffer flag.</doc>
      </member>
      <member name="bot" value="1" c:identifier="HB_BUFFER_FLAG_BOT">
        <doc xml:space="preserve">flag indicating that special handling of the beginning
                     of text paragraph can be applied to this buffer. Should usually
                     be set, unless you are passing to the buffer only part
                     of the text without the full context.</doc>
      </member>
      <member name="eot" value="2" c:identifier="HB_BUFFER_FLAG_EOT">
        <doc xml:space="preserve">flag indicating that special handling of the end of text
                     paragraph can be applied to this buffer, similar to
                     @HB_BUFFER_FLAG_BOT.</doc>
      </member>
      <member name="preserve_default_ignorables" value="4" c:identifier="HB_BUFFER_FLAG_PRESERVE_DEFAULT_IGNORABLES">
        <doc xml:space="preserve">flag indication that character with Default_Ignorable
                     Unicode property should use the corresponding glyph
                     from the font, instead of hiding them (done by
                     replacing them with the space glyph and zeroing the
                     advance width.)  This flag takes precedence over
                     @HB_BUFFER_FLAG_REMOVE_DEFAULT_IGNORABLES.</doc>
      </member>
      <member name="remove_default_ignorables" value="8" c:identifier="HB_BUFFER_FLAG_REMOVE_DEFAULT_IGNORABLES">
        <doc xml:space="preserve">flag indication that character with Default_Ignorable
                     Unicode property should be removed from glyph string
                     instead of hiding them (done by replacing them with the
                     space glyph and zeroing the advance width.)
                     @HB_BUFFER_FLAG_PRESERVE_DEFAULT_IGNORABLES takes
                     precedence over this flag. Since: 1.8.0</doc>
      </member>
      <member name="do_not_insert_dotted_circle" value="16" c:identifier="HB_BUFFER_FLAG_DO_NOT_INSERT_DOTTED_CIRCLE">
        <doc xml:space="preserve">flag indicating that a dotted circle should
                     not be inserted in the rendering of incorrect
                     character sequences (such at &lt;0905 093E&gt;). Since: 2.4.0</doc>
      </member>
      <member name="verify" value="32" c:identifier="HB_BUFFER_FLAG_VERIFY">
        <doc xml:space="preserve">flag indicating that the hb_shape() call and its variants
                     should perform various verification processes on the results
                     of the shaping operation on the buffer.  If the verification
                     fails, then either a buffer message is sent, if a message
                     handler is installed on the buffer, or a message is written
                     to standard error.  In either case, the shaping result might
                     be modified to show the failed output. Since: 3.4.0</doc>
      </member>
      <member name="produce_unsafe_to_concat" value="64" c:identifier="HB_BUFFER_FLAG_PRODUCE_UNSAFE_TO_CONCAT">
        <doc xml:space="preserve">flag indicating that the @HB_GLYPH_FLAG_UNSAFE_TO_CONCAT
                     glyph-flag should be produced by the shaper. By default
                     it will not be produced since it incurs a cost. Since: 4.0.0</doc>
      </member>
      <member name="produce_safe_to_insert_tatweel" value="128" c:identifier="HB_BUFFER_FLAG_PRODUCE_SAFE_TO_INSERT_TATWEEL">
        <doc xml:space="preserve">flag indicating that the @HB_GLYPH_FLAG_SAFE_TO_INSERT_TATWEEL
                     glyph-flag should be produced by the shaper. By default
                     it will not be produced. Since: 5.1.0</doc>
      </member>
      <member name="defined" value="255" c:identifier="HB_BUFFER_FLAG_DEFINED">
        <doc xml:space="preserve">All currently defined flags: Since: 4.4.0</doc>
      </member>
    </bitfield>
    <function name="buffer_get_cluster_level" c:identifier="hb_buffer_get_cluster_level" version="0.9.42">
      <doc xml:space="preserve">Fetches the cluster level of a buffer. The #hb_buffer_cluster_level_t
dictates one aspect of how HarfBuzz will treat non-base characters
during shaping.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The cluster level of @buffer</doc>
        <type name="buffer_cluster_level_t" c:type="hb_buffer_cluster_level_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_content_type" c:identifier="hb_buffer_get_content_type" version="0.9.5">
      <doc xml:space="preserve">Fetches the type of @buffer contents. Buffers are either empty, contain
characters (before shaping), or contain glyphs (the result of shaping).</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The type of @buffer contents</doc>
        <type name="buffer_content_type_t" c:type="hb_buffer_content_type_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_direction" c:identifier="hb_buffer_get_direction" version="0.9.2">
      <doc xml:space="preserve">See hb_buffer_set_direction()</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The direction of the @buffer.</doc>
        <type name="direction_t" c:type="hb_direction_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_empty" c:identifier="hb_buffer_get_empty" version="0.9.2">
      <doc xml:space="preserve">Fetches an empty #hb_buffer_t.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty buffer</doc>
        <type name="buffer_t" c:type="hb_buffer_t*"/>
      </return-value>
    </function>
    <function name="buffer_get_flags" c:identifier="hb_buffer_get_flags" version="0.9.7">
      <doc xml:space="preserve">Fetches the #hb_buffer_flags_t of @buffer.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The @buffer flags</doc>
        <type name="buffer_flags_t" c:type="hb_buffer_flags_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_glyph_infos" c:identifier="hb_buffer_get_glyph_infos" version="0.9.2">
      <doc xml:space="preserve">Returns @buffer glyph information array.  Returned pointer
is valid as long as @buffer contents are not modified.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">
The @buffer glyph information array.
The value valid as long as buffer has not been modified.</doc>
        <array length="1" zero-terminated="0" c:type="hb_glyph_info_t*">
          <type name="glyph_info_t" c:type="hb_glyph_info_t"/>
        </array>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The output-array length.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_glyph_positions" c:identifier="hb_buffer_get_glyph_positions" version="0.9.2">
      <doc xml:space="preserve">Returns @buffer glyph position array.  Returned pointer
is valid as long as @buffer contents are not modified.

If buffer did not have positions before, the positions will be
initialized to zeros, unless this function is called from
within a buffer message callback (see hb_buffer_set_message_func()),
in which case `NULL` is returned.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">
The @buffer glyph position array.
The value valid as long as buffer has not been modified.</doc>
        <array length="1" zero-terminated="0" c:type="hb_glyph_position_t*">
          <type name="glyph_position_t" c:type="hb_glyph_position_t"/>
        </array>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The output length</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_invisible_glyph" c:identifier="hb_buffer_get_invisible_glyph" version="2.0.0">
      <doc xml:space="preserve">See hb_buffer_set_invisible_glyph().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The @buffer invisible #hb_codepoint_t</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_language" c:identifier="hb_buffer_get_language" version="0.9.2">
      <doc xml:space="preserve">See hb_buffer_set_language().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">
The #hb_language_t of the buffer. Must not be freed by the caller.</doc>
        <type name="language_t" c:type="hb_language_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_length" c:identifier="hb_buffer_get_length" version="0.9.2">
      <doc xml:space="preserve">Returns the number of items in the buffer.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The @buffer length.
The value valid as long as buffer has not been modified.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_not_found_glyph" c:identifier="hb_buffer_get_not_found_glyph" version="3.1.0">
      <doc xml:space="preserve">See hb_buffer_set_not_found_glyph().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The @buffer not-found #hb_codepoint_t</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_not_found_variation_selector_glyph" c:identifier="hb_buffer_get_not_found_variation_selector_glyph" version="10.0.0">
      <doc xml:space="preserve">See hb_buffer_set_not_found_variation_selector_glyph().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The @buffer not-found-variation-selector #hb_codepoint_t</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_random_state" c:identifier="hb_buffer_get_random_state" version="8.4.0">
      <doc xml:space="preserve">See hb_buffer_set_random_state().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The @buffer random state</doc>
        <type name="guint" c:type="unsigned"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_replacement_codepoint" c:identifier="hb_buffer_get_replacement_codepoint" version="0.9.31">
      <doc xml:space="preserve">Fetches the #hb_codepoint_t that replaces invalid entries for a given encoding
when adding text to @buffer.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The @buffer replacement #hb_codepoint_t</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_script" c:identifier="hb_buffer_get_script" version="0.9.2">
      <doc xml:space="preserve">Fetches the script of @buffer.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_script_t of the @buffer</doc>
        <type name="script_t" c:type="hb_script_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_segment_properties" c:identifier="hb_buffer_get_segment_properties" version="0.9.7">
      <doc xml:space="preserve">Sets @props to the #hb_segment_properties_t of @buffer.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
        <parameter name="props" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The output #hb_segment_properties_t</doc>
          <type name="segment_properties_t" c:type="hb_segment_properties_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_unicode_funcs" c:identifier="hb_buffer_get_unicode_funcs" version="0.9.2">
      <doc xml:space="preserve">Fetches the Unicode-functions structure of a buffer.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The Unicode-functions structure</doc>
        <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_get_user_data" c:identifier="hb_buffer_get_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Fetches the user data associated with the specified key,
attached to the specified buffer.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="const hb_buffer_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_guess_segment_properties" c:identifier="hb_buffer_guess_segment_properties" version="0.9.7">
      <doc xml:space="preserve">Sets unset buffer segment properties based on buffer Unicode
contents.  If buffer is not empty, it must have content type
#HB_BUFFER_CONTENT_TYPE_UNICODE.

If buffer script is not set (ie. is #HB_SCRIPT_INVALID), it
will be set to the Unicode script of the first character in
the buffer that has a script other than #HB_SCRIPT_COMMON,
#HB_SCRIPT_INHERITED, and #HB_SCRIPT_UNKNOWN.

Next, if buffer direction is not set (ie. is #HB_DIRECTION_INVALID),
it will be set to the natural horizontal direction of the
buffer script as returned by hb_script_get_horizontal_direction().
If hb_script_get_horizontal_direction() returns #HB_DIRECTION_INVALID,
then #HB_DIRECTION_LTR is used.

Finally, if buffer language is not set (ie. is #HB_LANGUAGE_INVALID),
it will be set to the process's default language as returned by
hb_language_get_default().  This may change in the future by
taking buffer script into consideration when choosing a language.
Note that hb_language_get_default() is NOT threadsafe the first time
it is called.  See documentation for that function for details.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_has_positions" c:identifier="hb_buffer_has_positions" version="2.7.3">
      <doc xml:space="preserve">Returns whether @buffer has glyph position data.
A buffer gains position data when hb_buffer_get_glyph_positions() is called on it,
and cleared of position data when hb_buffer_clear_contents() is called.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the @buffer has position array, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_buffer_t.</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="buffer_message_func_t" c:type="hb_buffer_message_func_t" version="1.1.3">
      <doc xml:space="preserve">A callback method for #hb_buffer_t. The method gets called with the
#hb_buffer_t it was set on, the #hb_font_t the buffer is shaped with and a
message describing what step of the shaping process will be performed.
Returning `false` from this method will skip this shaping step and move to
the next one.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` to perform the shaping step, `false` to skip it.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t to work upon</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_font_t the @buffer is shaped with</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="message" transfer-ownership="none">
          <doc xml:space="preserve">`NULL`-terminated message passed to the function</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="buffer_normalize_glyphs" c:identifier="hb_buffer_normalize_glyphs" version="0.9.2">
      <doc xml:space="preserve">Reorders a glyph buffer to have canonical in-cluster glyph order / position.
The resulting clusters should behave identical to pre-reordering clusters.

&lt;note&gt;This has nothing to do with Unicode normalization.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_pre_allocate" c:identifier="hb_buffer_pre_allocate" version="0.9.2">
      <doc xml:space="preserve">Pre allocates memory for @buffer to fit at least @size number of items.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @buffer memory allocation succeeded, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="size" transfer-ownership="none">
          <doc xml:space="preserve">Number of items to pre allocate.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_reference" c:identifier="hb_buffer_reference" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on @buffer by one. This prevents @buffer from
being destroyed until a matching call to hb_buffer_destroy() is made.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">
The referenced #hb_buffer_t.</doc>
        <type name="buffer_t" c:type="hb_buffer_t*"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_reset" c:identifier="hb_buffer_reset" version="0.9.2">
      <doc xml:space="preserve">Resets the buffer to its initial status, as if it was just newly created
with hb_buffer_create().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_reverse" c:identifier="hb_buffer_reverse" version="0.9.2">
      <doc xml:space="preserve">Reverses buffer contents.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_reverse_clusters" c:identifier="hb_buffer_reverse_clusters" version="0.9.2">
      <doc xml:space="preserve">Reverses buffer clusters.  That is, the buffer contents are
reversed, then each cluster (consecutive items having the
same cluster number) are reversed again.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_reverse_range" c:identifier="hb_buffer_reverse_range" version="0.9.41">
      <doc xml:space="preserve">Reverses buffer contents between @start and @end.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="start" transfer-ownership="none">
          <doc xml:space="preserve">start index</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="end" transfer-ownership="none">
          <doc xml:space="preserve">end index</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_serialize" c:identifier="hb_buffer_serialize" version="2.7.3">
      <doc xml:space="preserve">Serializes @buffer into a textual representation of its content, whether
Unicode codepoints or glyph identifiers and positioning information. This is
useful for showing the contents of the buffer, for example during debugging.
See the documentation of hb_buffer_serialize_unicode() and
hb_buffer_serialize_glyphs() for a description of the output format.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The number of serialized items.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_buffer_t buffer.</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="start" transfer-ownership="none">
          <doc xml:space="preserve">the first item in @buffer to serialize.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="end" transfer-ownership="none">
          <doc xml:space="preserve">the last item in @buffer to serialize.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="buf" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">output string to
      write serialized buffer into.</doc>
          <array length="4" zero-terminated="0" c:type="char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="buf_size" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">the size of @buf.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="buf_consumed" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">if not `NULL`, will be set to the number of bytes written into @buf.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="font" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">the #hb_font_t used to shape this buffer, needed to
       read glyph names and extents. If `NULL`, an empty font will be used.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="format" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_buffer_serialize_format_t to use for formatting the output.</doc>
          <type name="buffer_serialize_format_t" c:type="hb_buffer_serialize_format_t"/>
        </parameter>
        <parameter name="flags" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_buffer_serialize_flags_t that control what glyph properties
        to serialize.</doc>
          <type name="buffer_serialize_flags_t" c:type="hb_buffer_serialize_flags_t"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="buffer_serialize_flags_t" version="0.9.20" c:type="hb_buffer_serialize_flags_t">
      <doc xml:space="preserve">Flags that control what glyph information are serialized in hb_buffer_serialize_glyphs().</doc>
      <member name="default" value="0" c:identifier="HB_BUFFER_SERIALIZE_FLAG_DEFAULT">
        <doc xml:space="preserve">serialize glyph names, clusters and positions.</doc>
      </member>
      <member name="no_clusters" value="1" c:identifier="HB_BUFFER_SERIALIZE_FLAG_NO_CLUSTERS">
        <doc xml:space="preserve">do not serialize glyph cluster.</doc>
      </member>
      <member name="no_positions" value="2" c:identifier="HB_BUFFER_SERIALIZE_FLAG_NO_POSITIONS">
        <doc xml:space="preserve">do not serialize glyph position information.</doc>
      </member>
      <member name="no_glyph_names" value="4" c:identifier="HB_BUFFER_SERIALIZE_FLAG_NO_GLYPH_NAMES">
        <doc xml:space="preserve">do no serialize glyph name.</doc>
      </member>
      <member name="glyph_extents" value="8" c:identifier="HB_BUFFER_SERIALIZE_FLAG_GLYPH_EXTENTS">
        <doc xml:space="preserve">serialize glyph extents.</doc>
      </member>
      <member name="glyph_flags" value="16" c:identifier="HB_BUFFER_SERIALIZE_FLAG_GLYPH_FLAGS">
        <doc xml:space="preserve">serialize glyph flags. Since: 1.5.0</doc>
      </member>
      <member name="no_advances" value="32" c:identifier="HB_BUFFER_SERIALIZE_FLAG_NO_ADVANCES">
        <doc xml:space="preserve">do not serialize glyph advances,
 glyph offsets will reflect absolute glyph positions. Since: 1.8.0</doc>
      </member>
      <member name="defined" value="63" c:identifier="HB_BUFFER_SERIALIZE_FLAG_DEFINED">
        <doc xml:space="preserve">All currently defined flags. Since: 4.4.0</doc>
      </member>
    </bitfield>
    <function name="buffer_serialize_format_from_string" c:identifier="hb_buffer_serialize_format_from_string" version="0.9.7">
      <doc xml:space="preserve">Parses a string into an #hb_buffer_serialize_format_t. Does not check if
@str is a valid buffer serialization format, use
hb_buffer_serialize_list_formats() to get the list of supported formats.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The parsed #hb_buffer_serialize_format_t.</doc>
        <type name="buffer_serialize_format_t" c:type="hb_buffer_serialize_format_t"/>
      </return-value>
      <parameters>
        <parameter name="str" transfer-ownership="none">
          <doc xml:space="preserve">a string to parse</doc>
          <array length="1" zero-terminated="0" c:type="const char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">length of @str, or -1 if string is `NULL` terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="buffer_serialize_format_t" version="0.9.2" c:type="hb_buffer_serialize_format_t">
      <doc xml:space="preserve">The buffer serialization and de-serialization format used in
hb_buffer_serialize_glyphs() and hb_buffer_deserialize_glyphs().</doc>
      <member name="text" value="1413830740" c:identifier="HB_BUFFER_SERIALIZE_FORMAT_TEXT">
        <doc xml:space="preserve">a human-readable, plain text format.</doc>
      </member>
      <member name="json" value="1246973774" c:identifier="HB_BUFFER_SERIALIZE_FORMAT_JSON">
        <doc xml:space="preserve">a machine-readable JSON format.</doc>
      </member>
      <member name="invalid" value="0" c:identifier="HB_BUFFER_SERIALIZE_FORMAT_INVALID">
        <doc xml:space="preserve">invalid format.</doc>
      </member>
    </bitfield>
    <function name="buffer_serialize_format_to_string" c:identifier="hb_buffer_serialize_format_to_string" version="0.9.7">
      <doc xml:space="preserve">Converts @format to the string corresponding it, or `NULL` if it is not a valid
#hb_buffer_serialize_format_t.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">
A `NULL` terminated string corresponding to @format. Should not be freed.</doc>
        <type name="utf8" c:type="const char*"/>
      </return-value>
      <parameters>
        <parameter name="format" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_buffer_serialize_format_t to convert.</doc>
          <type name="buffer_serialize_format_t" c:type="hb_buffer_serialize_format_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_serialize_glyphs" c:identifier="hb_buffer_serialize_glyphs" version="0.9.7">
      <doc xml:space="preserve">Serializes @buffer into a textual representation of its glyph content,
useful for showing the contents of the buffer, for example during debugging.
There are currently two supported serialization formats:

## text
A human-readable, plain text format.
The serialized glyphs will look something like:

```
[uni0651=0@518,0+0|uni0628=0+1897]
```

- The serialized glyphs are delimited with `[` and `]`.
- Glyphs are separated with `|`
- Each glyph starts with glyph name, or glyph index if
  #HB_BUFFER_SERIALIZE_FLAG_NO_GLYPH_NAMES flag is set. Then,
  - If #HB_BUFFER_SERIALIZE_FLAG_NO_CLUSTERS is not set, `=` then #hb_glyph_info_t.cluster.
  - If #HB_BUFFER_SERIALIZE_FLAG_NO_POSITIONS is not set, the #hb_glyph_position_t in the format:
    - If #hb_glyph_position_t.x_offset and #hb_glyph_position_t.y_offset are not both 0, `@x_offset,y_offset`. Then,
    - `+x_advance`, then `,y_advance` if #hb_glyph_position_t.y_advance is not 0. Then,
  - If #HB_BUFFER_SERIALIZE_FLAG_GLYPH_EXTENTS is set, the #hb_glyph_extents_t in the format `&lt;x_bearing,y_bearing,width,height&gt;`

## json
A machine-readable, structured format.
The serialized glyphs will look something like:

```
[{"g":"uni0651","cl":0,"dx":518,"dy":0,"ax":0,"ay":0},
{"g":"uni0628","cl":0,"dx":0,"dy":0,"ax":1897,"ay":0}]
```

Each glyph is a JSON object, with the following properties:
- `g`: the glyph name or glyph index if
  #HB_BUFFER_SERIALIZE_FLAG_NO_GLYPH_NAMES flag is set.
- `cl`: #hb_glyph_info_t.cluster if
  #HB_BUFFER_SERIALIZE_FLAG_NO_CLUSTERS is not set.
- `dx`,`dy`,`ax`,`ay`: #hb_glyph_position_t.x_offset, #hb_glyph_position_t.y_offset,
   #hb_glyph_position_t.x_advance and #hb_glyph_position_t.y_advance
   respectively, if #HB_BUFFER_SERIALIZE_FLAG_NO_POSITIONS is not set.
- `xb`,`yb`,`w`,`h`: #hb_glyph_extents_t.x_bearing, #hb_glyph_extents_t.y_bearing,
   #hb_glyph_extents_t.width and #hb_glyph_extents_t.height respectively if
   #HB_BUFFER_SERIALIZE_FLAG_GLYPH_EXTENTS is set.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The number of serialized items.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_buffer_t buffer.</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="start" transfer-ownership="none">
          <doc xml:space="preserve">the first item in @buffer to serialize.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="end" transfer-ownership="none">
          <doc xml:space="preserve">the last item in @buffer to serialize.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="buf" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">output string to
      write serialized buffer into.</doc>
          <array length="4" zero-terminated="0" c:type="char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="buf_size" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">the size of @buf.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="buf_consumed" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">if not `NULL`, will be set to the number of bytes written into @buf.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="font" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">the #hb_font_t used to shape this buffer, needed to
       read glyph names and extents. If `NULL`, an empty font will be used.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="format" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_buffer_serialize_format_t to use for formatting the output.</doc>
          <type name="buffer_serialize_format_t" c:type="hb_buffer_serialize_format_t"/>
        </parameter>
        <parameter name="flags" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_buffer_serialize_flags_t that control what glyph properties
        to serialize.</doc>
          <type name="buffer_serialize_flags_t" c:type="hb_buffer_serialize_flags_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_serialize_list_formats" c:identifier="hb_buffer_serialize_list_formats" version="0.9.7">
      <doc xml:space="preserve">Returns a list of supported buffer serialization formats.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">
A string array of buffer serialization formats. Should not be freed.</doc>
        <array c:type="const char**">
          <type name="utf8"/>
        </array>
      </return-value>
    </function>
    <function name="buffer_serialize_unicode" c:identifier="hb_buffer_serialize_unicode" version="2.7.3">
      <doc xml:space="preserve">Serializes @buffer into a textual representation of its content,
when the buffer contains Unicode codepoints (i.e., before shaping). This is
useful for showing the contents of the buffer, for example during debugging.
There are currently two supported serialization formats:

## text
A human-readable, plain text format.
The serialized codepoints will look something like:

```
&#xA0;&lt;U+0651=0|U+0628=1&gt;
```

- Glyphs are separated with `|`
- Unicode codepoints are expressed as zero-padded four (or more)
  digit hexadecimal numbers preceded by `U+`
- If #HB_BUFFER_SERIALIZE_FLAG_NO_CLUSTERS is not set, the cluster
  will be indicated with a `=` then #hb_glyph_info_t.cluster.

## json
A machine-readable, structured format.
The serialized codepoints will be a list of objects with the following
properties:
- `u`: the Unicode codepoint as a decimal integer
- `cl`: #hb_glyph_info_t.cluster if
  #HB_BUFFER_SERIALIZE_FLAG_NO_CLUSTERS is not set.

For example:

```
[{u:1617,cl:0},{u:1576,cl:1}]
```</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The number of serialized items.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_buffer_t buffer.</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="start" transfer-ownership="none">
          <doc xml:space="preserve">the first item in @buffer to serialize.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="end" transfer-ownership="none">
          <doc xml:space="preserve">the last item in @buffer to serialize.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="buf" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">output string to
      write serialized buffer into.</doc>
          <array length="4" zero-terminated="0" c:type="char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="buf_size" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">the size of @buf.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="buf_consumed" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">if not `NULL`, will be set to the number of bytes written into @buf.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="format" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_buffer_serialize_format_t to use for formatting the output.</doc>
          <type name="buffer_serialize_format_t" c:type="hb_buffer_serialize_format_t"/>
        </parameter>
        <parameter name="flags" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_buffer_serialize_flags_t that control what glyph properties
        to serialize.</doc>
          <type name="buffer_serialize_flags_t" c:type="hb_buffer_serialize_flags_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_cluster_level" c:identifier="hb_buffer_set_cluster_level" version="0.9.42">
      <doc xml:space="preserve">Sets the cluster level of a buffer. The #hb_buffer_cluster_level_t
dictates one aspect of how HarfBuzz will treat non-base characters
during shaping.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="cluster_level" transfer-ownership="none">
          <doc xml:space="preserve">The cluster level to set on the buffer</doc>
          <type name="buffer_cluster_level_t" c:type="hb_buffer_cluster_level_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_content_type" c:identifier="hb_buffer_set_content_type" version="0.9.5">
      <doc xml:space="preserve">Sets the type of @buffer contents. Buffers are either empty, contain
characters (before shaping), or contain glyphs (the result of shaping).

You rarely need to call this function, since a number of other
functions transition the content type for you. Namely:

- A newly created buffer starts with content type
  %HB_BUFFER_CONTENT_TYPE_INVALID. Calling hb_buffer_reset(),
  hb_buffer_clear_contents(), as well as calling hb_buffer_set_length()
  with an argument of zero all set the buffer content type to invalid
  as well.

- Calling hb_buffer_add_utf8(), hb_buffer_add_utf16(),
  hb_buffer_add_utf32(), hb_buffer_add_codepoints() and
  hb_buffer_add_latin1() expect that buffer is either empty and
  have a content type of invalid, or that buffer content type is
  %HB_BUFFER_CONTENT_TYPE_UNICODE, and they also set the content
  type to Unicode if they added anything to an empty buffer.

- Finally hb_shape() and hb_shape_full() expect that the buffer
  is either empty and have content type of invalid, or that buffer
  content type is %HB_BUFFER_CONTENT_TYPE_UNICODE, and upon
  success they set the buffer content type to
  %HB_BUFFER_CONTENT_TYPE_GLYPHS.

The above transitions are designed such that one can use a buffer
in a loop of "reset : add-text : shape" without needing to ever
modify the content type manually.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="content_type" transfer-ownership="none">
          <doc xml:space="preserve">The type of buffer contents to set</doc>
          <type name="buffer_content_type_t" c:type="hb_buffer_content_type_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_direction" c:identifier="hb_buffer_set_direction" version="0.9.2">
      <doc xml:space="preserve">Set the text flow direction of the buffer. No shaping can happen without
setting @buffer direction, and it controls the visual direction for the
output glyphs; for RTL direction the glyphs will be reversed. Many layout
features depend on the proper setting of the direction, for example,
reversing RTL text before shaping, then shaping with LTR direction is not
the same as keeping the text in logical order and shaping with RTL
direction.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_direction_t of the @buffer</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_flags" c:identifier="hb_buffer_set_flags" version="0.9.7">
      <doc xml:space="preserve">Sets @buffer flags to @flags. See #hb_buffer_flags_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="flags" transfer-ownership="none">
          <doc xml:space="preserve">The buffer flags to set</doc>
          <type name="buffer_flags_t" c:type="hb_buffer_flags_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_invisible_glyph" c:identifier="hb_buffer_set_invisible_glyph" version="2.0.0">
      <doc xml:space="preserve">Sets the #hb_codepoint_t that replaces invisible characters in
the shaping result.  If set to zero (default), the glyph for the
U+0020 SPACE character is used.  Otherwise, this value is used
verbatim.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="invisible" transfer-ownership="none">
          <doc xml:space="preserve">the invisible #hb_codepoint_t</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_language" c:identifier="hb_buffer_set_language" version="0.9.2">
      <doc xml:space="preserve">Sets the language of @buffer to @language.

Languages are crucial for selecting which OpenType feature to apply to the
buffer which can result in applying language-specific behaviour. Languages
are orthogonal to the scripts, and though they are related, they are
different concepts and should not be confused with each other.

Use hb_language_from_string() to convert from BCP 47 language tags to
#hb_language_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="language" transfer-ownership="none">
          <doc xml:space="preserve">An hb_language_t to set</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_length" c:identifier="hb_buffer_set_length" version="0.9.2">
      <doc xml:space="preserve">Similar to hb_buffer_pre_allocate(), but clears any new items added at the
end.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @buffer memory allocation succeeded, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="length" transfer-ownership="none">
          <doc xml:space="preserve">The new length of @buffer</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_message_func" c:identifier="hb_buffer_set_message_func" version="1.1.3">
      <doc xml:space="preserve">Sets the implementation function for #hb_buffer_message_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">Callback function</doc>
          <type name="buffer_message_func_t" c:type="hb_buffer_message_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_not_found_glyph" c:identifier="hb_buffer_set_not_found_glyph" version="3.1.0">
      <doc xml:space="preserve">Sets the #hb_codepoint_t that replaces characters not found in
the font during shaping.

The not-found glyph defaults to zero, sometimes known as the
".notdef" glyph.  This API allows for differentiating the two.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="not_found" transfer-ownership="none">
          <doc xml:space="preserve">the not-found #hb_codepoint_t</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_not_found_variation_selector_glyph" c:identifier="hb_buffer_set_not_found_variation_selector_glyph" version="10.0.0">
      <doc xml:space="preserve">Sets the #hb_codepoint_t that replaces variation-selector characters not resolved
in the font during shaping.

The not-found-variation-selector glyph defaults to #HB_CODEPOINT_INVALID,
in which case an unresolved variation-selector will be removed from the glyph
string during shaping. This API allows for changing that and retaining a glyph,
such that the situation can be detected by the client and handled accordingly
(e.g. by using a different font).</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="not_found_variation_selector" transfer-ownership="none">
          <doc xml:space="preserve">the not-found-variation-selector #hb_codepoint_t</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_random_state" c:identifier="hb_buffer_set_random_state" version="8.4.0">
      <doc xml:space="preserve">Sets the random state of the buffer. The state changes
every time a glyph uses randomness (eg. the `rand`
OpenType feature). This function together with
hb_buffer_get_random_state() allow for transferring
the current random state to a subsequent buffer, to
get better randomness distribution.

Defaults to 1 and when buffer contents are cleared.
A value of 0 disables randomness during shaping.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="state" transfer-ownership="none">
          <doc xml:space="preserve">the new random state</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_replacement_codepoint" c:identifier="hb_buffer_set_replacement_codepoint" version="0.9.31">
      <doc xml:space="preserve">Sets the #hb_codepoint_t that replaces invalid entries for a given encoding
when adding text to @buffer.

Default is #HB_BUFFER_REPLACEMENT_CODEPOINT_DEFAULT.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="replacement" transfer-ownership="none">
          <doc xml:space="preserve">the replacement #hb_codepoint_t</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_script" c:identifier="hb_buffer_set_script" version="0.9.2">
      <doc xml:space="preserve">Sets the script of @buffer to @script.

Script is crucial for choosing the proper shaping behaviour for scripts that
require it (e.g. Arabic) and the which OpenType features defined in the font
to be applied.

You can pass one of the predefined #hb_script_t values, or use
hb_script_from_string() or hb_script_from_iso15924_tag() to get the
corresponding script from an ISO 15924 script tag.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_script_t to set.</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_segment_properties" c:identifier="hb_buffer_set_segment_properties" version="0.9.7">
      <doc xml:space="preserve">Sets the segment properties of the buffer, a shortcut for calling
hb_buffer_set_direction(), hb_buffer_set_script() and
hb_buffer_set_language() individually.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="props" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_segment_properties_t to use</doc>
          <type name="segment_properties_t" c:type="const hb_segment_properties_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_unicode_funcs" c:identifier="hb_buffer_set_unicode_funcs" version="0.9.2">
      <doc xml:space="preserve">Sets the Unicode-functions structure of a buffer to
@unicode_funcs.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="unicode_funcs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="buffer_set_user_data" c:identifier="hb_buffer_set_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the specified buffer.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">An #hb_buffer_t</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="buffer_t" c:type="hb_buffer_t" opaque="1" glib:type-name="hb_buffer_t" glib:get-type="hb_gobject_buffer_get_type" c:symbol-prefix="gobject_buffer">
      <doc xml:space="preserve">The main structure holding the input text and its properties before shaping,
and output glyphs and their information after shaping.</doc>
    </record>
    <function name="calloc" c:identifier="hb_calloc" version="11.0.0">
      <doc xml:space="preserve">Allocates @nmemb elements of @size bytes each, initialized to zero,
using the allocator set at compile-time. Typically just calloc().</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the allocated memory.</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="nmemb" transfer-ownership="none">
          <doc xml:space="preserve">The number of elements to allocate.</doc>
          <type name="gsize" c:type="size_t"/>
        </parameter>
        <parameter name="size" transfer-ownership="none">
          <doc xml:space="preserve">The size of each element.</doc>
          <type name="gsize" c:type="size_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_get_alpha" c:identifier="hb_color_get_alpha" version="2.1.0">
      <doc xml:space="preserve">Fetches the alpha channel of the given @color.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Alpha channel value</doc>
        <type name="guint8" c:type="uint8_t"/>
      </return-value>
      <parameters>
        <parameter name="color" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_color_t we are interested in its channels.</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_get_blue" c:identifier="hb_color_get_blue" version="2.1.0">
      <doc xml:space="preserve">Fetches the blue channel of the given @color.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Blue channel value</doc>
        <type name="guint8" c:type="uint8_t"/>
      </return-value>
      <parameters>
        <parameter name="color" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_color_t we are interested in its channels.</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_get_green" c:identifier="hb_color_get_green" version="2.1.0">
      <doc xml:space="preserve">Fetches the green channel of the given @color.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Green channel value</doc>
        <type name="guint8" c:type="uint8_t"/>
      </return-value>
      <parameters>
        <parameter name="color" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_color_t we are interested in its channels.</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_get_red" c:identifier="hb_color_get_red" version="2.1.0">
      <doc xml:space="preserve">Fetches the red channel of the given @color.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Red channel value</doc>
        <type name="guint8" c:type="uint8_t"/>
      </return-value>
      <parameters>
        <parameter name="color" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_color_t we are interested in its channels.</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_line_get_color_stops" c:identifier="hb_color_line_get_color_stops" version="7.0.0">
      <doc xml:space="preserve">Fetches a list of color stops from the given color line object.

Note that due to variations being applied, the returned color stops
may be out of order. It is the callers responsibility to ensure that
color stops are sorted by their offset before they are used.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the total number of color stops in @color_line</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">a #hb_color_line_t object</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
        <parameter name="start" transfer-ownership="none">
          <doc xml:space="preserve">the index of the first color stop to return</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of feature tags to return;
    Output = the actual number of feature tags returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="color_stops" direction="out" caller-allocates="1" transfer-ownership="none" optional="1" allow-none="1">
          <doc xml:space="preserve">Array of #hb_color_stop_t to populate</doc>
          <array length="2" zero-terminated="0" c:type="hb_color_stop_t*">
            <type name="color_stop_t" c:type="hb_color_stop_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <callback name="color_line_get_color_stops_func_t" c:type="hb_color_line_get_color_stops_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_color_line_t to fetch color stops.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the total number of color stops in @color_line</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">a #hb_color_line_t object</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
        <parameter name="color_line_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">the data accompanying @color_line</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="start" transfer-ownership="none">
          <doc xml:space="preserve">the index of the first color stop to return</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of feature tags to return;
    Output = the actual number of feature tags returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="color_stops" direction="out" caller-allocates="1" transfer-ownership="none" optional="1" allow-none="1">
          <doc xml:space="preserve">Array of #hb_color_stop_t to populate</doc>
          <array length="3" zero-terminated="0" c:type="hb_color_stop_t*">
            <type name="color_stop_t" c:type="hb_color_stop_t"/>
          </array>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">the data accompanying this method</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="color_line_get_extend" c:identifier="hb_color_line_get_extend" version="7.0.0">
      <doc xml:space="preserve">Fetches the extend mode of the color line object.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the extend mode of @color_line</doc>
        <type name="paint_extend_t" c:type="hb_paint_extend_t"/>
      </return-value>
      <parameters>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">a #hb_color_line_t object</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="color_line_get_extend_func_t" c:type="hb_color_line_get_extend_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the @hb_color_line_t to fetches the extend mode.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the extend mode of @color_line</doc>
        <type name="paint_extend_t" c:type="hb_paint_extend_t"/>
      </return-value>
      <parameters>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">a #hb_color_line_t object</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
        <parameter name="color_line_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">the data accompanying @color_line</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">the data accompanying this method</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <record name="color_line_t" c:type="hb_color_line_t" version="7.0.0" glib:type-name="hb_color_line_t" glib:get-type="hb_gobject_color_line_get_type" c:symbol-prefix="gobject_color_line">
      <doc xml:space="preserve">A struct containing color information for a gradient.</doc>
      <field name="data" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="get_color_stops" writable="1">
        <type name="color_line_get_color_stops_func_t" c:type="hb_color_line_get_color_stops_func_t"/>
      </field>
      <field name="get_color_stops_user_data" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="get_extend" writable="1">
        <type name="color_line_get_extend_func_t" c:type="hb_color_line_get_extend_func_t"/>
      </field>
      <field name="get_extend_user_data" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="reserved0" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="reserved1" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="reserved2" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="reserved3" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="reserved5" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="reserved6" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="reserved7" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="reserved8" writable="1">
        <type name="gpointer" c:type="void*"/>
      </field>
    </record>
    <record name="color_stop_t" c:type="hb_color_stop_t" version="7.0.0" glib:type-name="hb_color_stop_t" glib:get-type="hb_gobject_color_stop_get_type" c:symbol-prefix="gobject_color_stop">
      <doc xml:space="preserve">Information about a color stop on a color line.

Color lines typically have offsets ranging between 0 and 1,
but that is not required.

Note: despite @color being unpremultiplied here, interpolation in
gradients shall happen in premultiplied space. See the OpenType spec
[COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr)
section for details.</doc>
      <field name="offset" writable="1">
        <doc xml:space="preserve">the offset of the color stop</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="is_foreground" writable="1">
        <doc xml:space="preserve">whether the color is the foreground</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </field>
      <field name="color" writable="1">
        <doc xml:space="preserve">the color, unpremultiplied</doc>
        <type name="color_t" c:type="hb_color_t"/>
      </field>
    </record>
    <callback name="destroy_func_t" c:type="hb_destroy_func_t">
      <doc xml:space="preserve">A virtual method for destroy user-data callbacks.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="0">
          <doc xml:space="preserve">the data to be destroyed</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="direction_from_string" c:identifier="hb_direction_from_string" version="0.9.2">
      <doc xml:space="preserve">Converts a string to an #hb_direction_t.

Matching is loose and applies only to the first letter. For
examples, "LTR" and "left-to-right" will both return #HB_DIRECTION_LTR.

Unmatched strings will return #HB_DIRECTION_INVALID.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_direction_t matching @str</doc>
        <type name="direction_t" c:type="hb_direction_t"/>
      </return-value>
      <parameters>
        <parameter name="str" transfer-ownership="none">
          <doc xml:space="preserve">String to convert</doc>
          <array length="1" zero-terminated="0" c:type="const char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">Length of @str, or -1 if it is `NULL`-terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <enumeration name="direction_t" c:type="hb_direction_t">
      <doc xml:space="preserve">The direction of a text segment or buffer.

A segment can also be tested for horizontal or vertical
orientation (irrespective of specific direction) with
HB_DIRECTION_IS_HORIZONTAL() or HB_DIRECTION_IS_VERTICAL().</doc>
      <member name="invalid" value="0" c:identifier="HB_DIRECTION_INVALID">
        <doc xml:space="preserve">Initial, unset direction.</doc>
      </member>
      <member name="ltr" value="4" c:identifier="HB_DIRECTION_LTR">
        <doc xml:space="preserve">Text is set horizontally from left to right.</doc>
      </member>
      <member name="rtl" value="5" c:identifier="HB_DIRECTION_RTL">
        <doc xml:space="preserve">Text is set horizontally from right to left.</doc>
      </member>
      <member name="ttb" value="6" c:identifier="HB_DIRECTION_TTB">
        <doc xml:space="preserve">Text is set vertically from top to bottom.</doc>
      </member>
      <member name="btt" value="7" c:identifier="HB_DIRECTION_BTT">
        <doc xml:space="preserve">Text is set vertically from bottom to top.</doc>
      </member>
    </enumeration>
    <function name="direction_to_string" c:identifier="hb_direction_to_string" version="0.9.2">
      <doc xml:space="preserve">Converts an #hb_direction_t to a string.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The string corresponding to @direction</doc>
        <type name="utf8" c:type="const char*"/>
      </return-value>
      <parameters>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_direction_t to convert</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_close_path" c:identifier="hb_draw_close_path" version="4.0.0">
      <doc xml:space="preserve">Perform a "close-path" draw operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated draw data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="draw_close_path_func_t" c:type="hb_draw_close_path_func_t" version="4.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_draw_funcs_t to perform a "close-path" draw
operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions object</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the draw functions in hb_font_draw_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
          <doc xml:space="preserve">User data pointer passed to hb_draw_funcs_set_close_path_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="draw_cubic_to" c:identifier="hb_draw_cubic_to" version="4.0.0">
      <doc xml:space="preserve">Perform a "cubic-to" draw operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated draw data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
        <parameter name="control1_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of first control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="control1_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of first control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="control2_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of second control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="control2_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of second control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <callback name="draw_cubic_to_func_t" c:type="hb_draw_cubic_to_func_t" version="4.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_draw_funcs_t to perform a "cubic-to" draw
operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions object</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the draw functions in hb_font_draw_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
        <parameter name="control1_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of first control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="control1_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of first control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="control2_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of second control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="control2_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of second control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="9">
          <doc xml:space="preserve">User data pointer passed to hb_draw_funcs_set_cubic_to_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="draw_funcs_create" c:identifier="hb_draw_funcs_create" version="4.0.0">
      <doc xml:space="preserve">Creates a new draw callbacks object.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">
A newly allocated #hb_draw_funcs_t with a reference count of 1. The initial
reference count should be released with hb_draw_funcs_destroy when you are
done using the #hb_draw_funcs_t. This function never returns `NULL`. If
memory cannot be allocated, a special singleton #hb_draw_funcs_t object will
be returned.</doc>
        <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
      </return-value>
    </function>
    <function name="draw_funcs_destroy" c:identifier="hb_draw_funcs_destroy" version="4.0.0" introspectable="0">
      <doc xml:space="preserve">Deallocate the @dfuncs.
Decreases the reference count on @dfuncs by one. If the result is zero, then
@dfuncs and all associated resources are freed. See hb_draw_funcs_reference().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_get_empty" c:identifier="hb_draw_funcs_get_empty" version="7.0.0">
      <doc xml:space="preserve">Fetches the singleton empty draw-functions structure.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty draw-functions structure</doc>
        <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
      </return-value>
    </function>
    <function name="draw_funcs_get_user_data" c:identifier="hb_draw_funcs_get_user_data" version="7.0.0" introspectable="0">
      <doc xml:space="preserve">Fetches the user-data associated with the specified key,
attached to the specified draw-functions structure.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">The draw-functions structure</doc>
          <type name="draw_funcs_t" c:type="const hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_is_immutable" c:identifier="hb_draw_funcs_is_immutable" version="4.0.0">
      <doc xml:space="preserve">Checks whether @dfuncs is immutable.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @dfuncs is immutable, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_make_immutable" c:identifier="hb_draw_funcs_make_immutable" version="4.0.0">
      <doc xml:space="preserve">Makes @dfuncs object immutable.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_reference" c:identifier="hb_draw_funcs_reference" version="4.0.0" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on @dfuncs by one.

This prevents @dfuncs from being destroyed until a matching
call to hb_draw_funcs_destroy() is made.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">
The referenced #hb_draw_funcs_t.</doc>
        <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_set_close_path_func" c:identifier="hb_draw_funcs_set_close_path_func" version="4.0.0">
      <doc xml:space="preserve">Sets close-path callback to the draw functions object.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions object</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">close-path callback</doc>
          <type name="draw_close_path_func_t" c:type="hb_draw_close_path_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_set_cubic_to_func" c:identifier="hb_draw_funcs_set_cubic_to_func" version="4.0.0">
      <doc xml:space="preserve">Sets cubic-to callback to the draw functions object.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">cubic-to callback</doc>
          <type name="draw_cubic_to_func_t" c:type="hb_draw_cubic_to_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_set_line_to_func" c:identifier="hb_draw_funcs_set_line_to_func" version="4.0.0">
      <doc xml:space="preserve">Sets line-to callback to the draw functions object.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions object</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">line-to callback</doc>
          <type name="draw_line_to_func_t" c:type="hb_draw_line_to_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_set_move_to_func" c:identifier="hb_draw_funcs_set_move_to_func" version="4.0.0">
      <doc xml:space="preserve">Sets move-to callback to the draw functions object.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions object</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">move-to callback</doc>
          <type name="draw_move_to_func_t" c:type="hb_draw_move_to_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_set_quadratic_to_func" c:identifier="hb_draw_funcs_set_quadratic_to_func" version="4.0.0">
      <doc xml:space="preserve">Sets quadratic-to callback to the draw functions object.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions object</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">quadratic-to callback</doc>
          <type name="draw_quadratic_to_func_t" c:type="hb_draw_quadratic_to_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="draw_funcs_set_user_data" c:identifier="hb_draw_funcs_set_user_data" version="7.0.0" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the specified draw-functions structure.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">The draw-functions structure</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="draw_funcs_t" c:type="hb_draw_funcs_t" opaque="1" version="4.0.0" glib:type-name="hb_draw_funcs_t" glib:get-type="hb_gobject_draw_funcs_get_type" c:symbol-prefix="gobject_draw_funcs">
      <doc xml:space="preserve">Glyph draw callbacks.

#hb_draw_move_to_func_t, #hb_draw_line_to_func_t and
#hb_draw_cubic_to_func_t calls are necessary to be defined but we translate
#hb_draw_quadratic_to_func_t calls to #hb_draw_cubic_to_func_t if the
callback isn't defined.</doc>
    </record>
    <function name="draw_line_to" c:identifier="hb_draw_line_to" version="4.0.0">
      <doc xml:space="preserve">Perform a "line-to" draw operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated draw data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
        <parameter name="to_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <callback name="draw_line_to_func_t" c:type="hb_draw_line_to_func_t" version="4.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_draw_funcs_t to perform a "line-to" draw
operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions object</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the draw functions in hb_font_draw_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
        <parameter name="to_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed to hb_draw_funcs_set_line_to_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="draw_move_to" c:identifier="hb_draw_move_to" version="4.0.0">
      <doc xml:space="preserve">Perform a "move-to" draw operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated draw data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
        <parameter name="to_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <callback name="draw_move_to_func_t" c:type="hb_draw_move_to_func_t" version="4.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_draw_funcs_t to perform a "move-to" draw
operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions object</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the draw functions in hb_font_draw_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
        <parameter name="to_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed to hb_draw_funcs_set_move_to_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="draw_quadratic_to" c:identifier="hb_draw_quadratic_to" version="4.0.0">
      <doc xml:space="preserve">Perform a "quadratic-to" draw operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated draw data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
        <parameter name="control_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="control_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <callback name="draw_quadratic_to_func_t" c:type="hb_draw_quadratic_to_func_t" version="4.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_draw_funcs_t to perform a "quadratic-to" draw
operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">draw functions object</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the draw functions in hb_font_draw_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="st" transfer-ownership="none">
          <doc xml:space="preserve">current draw state</doc>
          <type name="draw_state_t" c:type="hb_draw_state_t*"/>
        </parameter>
        <parameter name="control_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="control_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of control point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_x" transfer-ownership="none">
          <doc xml:space="preserve">X component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="to_y" transfer-ownership="none">
          <doc xml:space="preserve">Y component of target point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
          <doc xml:space="preserve">User data pointer passed to hb_draw_funcs_set_quadratic_to_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <record name="draw_state_t" c:type="hb_draw_state_t" version="4.0.0" glib:type-name="hb_draw_state_t" glib:get-type="hb_gobject_draw_state_get_type" c:symbol-prefix="gobject_draw_state">
      <doc xml:space="preserve">Current drawing state.</doc>
      <field name="path_open" writable="1">
        <doc xml:space="preserve">Whether there is an open path</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </field>
      <field name="path_start_x" writable="1">
        <doc xml:space="preserve">X component of the start of current path</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="path_start_y" writable="1">
        <doc xml:space="preserve">Y component of the start of current path</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="current_x" writable="1">
        <doc xml:space="preserve">X component of current point</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="current_y" writable="1">
        <doc xml:space="preserve">Y component of current point</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="reserved1" readable="0" private="1">
        <type name="var_num_t" c:type="hb_var_num_t"/>
      </field>
      <field name="reserved2" readable="0" private="1">
        <type name="var_num_t" c:type="hb_var_num_t"/>
      </field>
      <field name="reserved3" readable="0" private="1">
        <type name="var_num_t" c:type="hb_var_num_t"/>
      </field>
      <field name="reserved4" readable="0" private="1">
        <type name="var_num_t" c:type="hb_var_num_t"/>
      </field>
      <field name="reserved5" readable="0" private="1">
        <type name="var_num_t" c:type="hb_var_num_t"/>
      </field>
      <field name="reserved6" readable="0" private="1">
        <type name="var_num_t" c:type="hb_var_num_t"/>
      </field>
      <field name="reserved7" readable="0" private="1">
        <type name="var_num_t" c:type="hb_var_num_t"/>
      </field>
    </record>
    <function name="face_builder_add_table" c:identifier="hb_face_builder_add_table" version="1.9.0">
      <doc xml:space="preserve">Add table for @tag with data provided by @blob to the face.  @face must
be created using hb_face_builder_create().</doc>
      <return-value transfer-ownership="none">
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object created with hb_face_builder_create()</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_tag_t of the table to add</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">The blob containing the table data to add</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_builder_create" c:identifier="hb_face_builder_create" version="1.9.0">
      <doc xml:space="preserve">Creates a #hb_face_t that can be used with hb_face_builder_add_table().
After tables are added to the face, it can be compiled to a binary
font file by calling hb_face_reference_blob().</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">New face.</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
    </function>
    <function name="face_builder_sort_tables" c:identifier="hb_face_builder_sort_tables" version="5.3.0">
      <doc xml:space="preserve">Set the ordering of tables for serialization. Any tables not
specified in the tags list will be ordered after the tables in
tags, ordered by the default sort ordering.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object created with hb_face_builder_create()</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="tags" transfer-ownership="none">
          <doc xml:space="preserve">ordered list of table tags terminated by
  %HB_TAG_NONE</doc>
          <array c:type="const hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="face_collect_nominal_glyph_mapping" c:identifier="hb_face_collect_nominal_glyph_mapping" version="7.0.0">
      <doc xml:space="preserve">Collects the mapping from Unicode characters to nominal glyphs of the @face,
and optionally all of the Unicode characters covered by @face.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="mapping" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The map to add Unicode-to-glyph mapping to</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
        <parameter name="unicodes" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
          <doc xml:space="preserve">The set to add Unicode characters to, or `NULL`</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_collect_unicodes" c:identifier="hb_face_collect_unicodes" version="1.9.0">
      <doc xml:space="preserve">Collects all of the Unicode characters covered by @face and adds
them to the #hb_set_t set @out.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="out" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The set to add Unicode characters to</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_collect_variation_selectors" c:identifier="hb_face_collect_variation_selectors" version="1.9.0">
      <doc xml:space="preserve">Collects all Unicode "Variation Selector" characters covered by @face and adds
them to the #hb_set_t set @out.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="out" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The set to add Variation Selector characters to</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_collect_variation_unicodes" c:identifier="hb_face_collect_variation_unicodes" version="1.9.0">
      <doc xml:space="preserve">Collects all Unicode characters for @variation_selector covered by @face and adds
them to the #hb_set_t set @out.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="variation_selector" transfer-ownership="none">
          <doc xml:space="preserve">The Variation Selector to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="out" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The set to add Unicode characters to</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_count" c:identifier="hb_face_count" version="1.7.7">
      <doc xml:space="preserve">Fetches the number of faces in a blob.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Number of faces in @blob</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">a blob.</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_create" c:identifier="hb_face_create" version="0.9.2">
      <doc xml:space="preserve">Constructs a new face object from the specified blob and
a face index into that blob.

The face index is used for blobs of file formats such as TTC and
DFont that can contain more than one face.  Face indices within
such collections are zero-based.

&lt;note&gt;Note: If the blob font format is not a collection, @index
is ignored.  Otherwise, only the lower 16-bits of @index are used.
The unmodified @index can be accessed via hb_face_get_index().&lt;/note&gt;

&lt;note&gt;Note: The high 16-bits of @index, if non-zero, are used by
hb_font_create() to load named-instances in variable fonts.  See
hb_font_create() for details.&lt;/note&gt;</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new face object</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">#hb_blob_t to work upon</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the face within @blob</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_create_for_tables" c:identifier="hb_face_create_for_tables" version="0.9.2">
      <doc xml:space="preserve">Variant of hb_face_create(), built for those cases where it is more
convenient to provide data for individual tables instead of the whole font
data. With the caveat that hb_face_get_table_tags() would not work
with faces created this way. You can address that by calling the
hb_face_set_get_table_tags_func() function and setting the appropriate callback.

Creates a new face object from the specified @user_data and @reference_table_func,
with the @destroy callback.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new face object</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="reference_table_func" transfer-ownership="none" scope="notified" closure="1" destroy="2">
          <doc xml:space="preserve">Table-referencing function</doc>
          <type name="reference_table_func_t" c:type="hb_reference_table_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_create_from_file_or_fail" c:identifier="hb_face_create_from_file_or_fail" version="10.1.0">
      <doc xml:space="preserve">A thin wrapper around hb_blob_create_from_file_or_fail()
followed by hb_face_create_or_fail().</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new face object, or `NULL` if
no face is found at the specified index or the file cannot be read.</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="file_name" transfer-ownership="none">
          <doc xml:space="preserve">A font filename</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
        <parameter name="index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the face within the file</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_create_from_file_or_fail_using" c:identifier="hb_face_create_from_file_or_fail_using" version="11.0.0">
      <doc xml:space="preserve">A thin wrapper around the face loader functions registered with HarfBuzz.
If @loader_name is `NULL` or the empty string, the first available loader
is used.

For example, the FreeType ("ft") loader might be able to load
WOFF and WOFF2 files if FreeType is built with those features,
whereas the OpenType ("ot") loader will not.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new face object, or `NULL` if
the file cannot be read or the loader fails to load the face.</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="file_name" transfer-ownership="none">
          <doc xml:space="preserve">A font filename</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
        <parameter name="index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the face within the file</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="loader_name" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The name of the loader to use, or `NULL`</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_create_or_fail" c:identifier="hb_face_create_or_fail" version="10.1.0">
      <doc xml:space="preserve">Like hb_face_create(), but returns `NULL` if the blob data
contains no usable font face at the specified index.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new face object, or `NULL` if
no face is found at the specified index.</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">#hb_blob_t to work upon</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the face within @blob</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_create_or_fail_using" c:identifier="hb_face_create_or_fail_using" version="11.0.0">
      <doc xml:space="preserve">A thin wrapper around the face loader functions registered with HarfBuzz.
If @loader_name is `NULL` or the empty string, the first available loader
is used.

For example, the FreeType ("ft") loader might be able to load
WOFF and WOFF2 files if FreeType is built with those features,
whereas the OpenType ("ot") loader will not.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new face object, or `NULL` if
the loader fails to load the face.</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">#hb_blob_t to work upon</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the face within @blob</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="loader_name" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The name of the loader to use, or `NULL`</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_destroy" c:identifier="hb_face_destroy" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Decreases the reference count on a face object. When the
reference count reaches zero, the face is destroyed,
freeing all memory.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_get_empty" c:identifier="hb_face_get_empty" version="0.9.2">
      <doc xml:space="preserve">Fetches the singleton empty face object.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty face object</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
    </function>
    <function name="face_get_glyph_count" c:identifier="hb_face_get_glyph_count" version="0.9.7">
      <doc xml:space="preserve">Fetches the glyph-count value of the specified face object.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The glyph-count value of @face</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="const hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_get_index" c:identifier="hb_face_get_index" version="0.9.2">
      <doc xml:space="preserve">Fetches the face-index corresponding to the given face.

&lt;note&gt;Note: face indices within a collection are zero-based.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The index of @face.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="const hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_get_table_tags" c:identifier="hb_face_get_table_tags" version="1.6.0">
      <doc xml:space="preserve">Fetches a list of all table tags for a face, if possible. The list returned will
begin at the offset provided</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of tables, or zero if it is not possible to list</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="const hb_face_t*"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">The index of first table tag to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="table_count" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = the maximum number of table tags to return;
               Output = the actual number of table tags returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="table_tags" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of table tags found</doc>
          <array length="2" zero-terminated="0" c:type="hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="face_get_upem" c:identifier="hb_face_get_upem" version="0.9.2">
      <doc xml:space="preserve">Fetches the units-per-em (UPEM) value of the specified face object.

Typical UPEM values for fonts are 1000, or 2048, but any value
in between 16 and 16,384 is allowed for OpenType fonts.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The upem value of @face</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="const hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_get_user_data" c:identifier="hb_face_get_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Fetches the user data associated with the specified key,
attached to the specified face object.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="const hb_face_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_is_immutable" c:identifier="hb_face_is_immutable" version="0.9.2">
      <doc xml:space="preserve">Tests whether the given face object is immutable.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` is @face is immutable, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_list_loaders" c:identifier="hb_face_list_loaders" version="11.0.0">
      <doc xml:space="preserve">Retrieves the list of face loaders supported by HarfBuzz.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">a
   `NULL`-terminated array of supported face loaders
   constant strings. The returned array is owned by HarfBuzz
   and should not be modified or freed.</doc>
        <array c:type="const char**">
          <type name="utf8"/>
        </array>
      </return-value>
    </function>
    <function name="face_make_immutable" c:identifier="hb_face_make_immutable" version="0.9.2">
      <doc xml:space="preserve">Makes the given face object immutable.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_reference" c:identifier="hb_face_reference" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on a face object.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The @face object</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_reference_blob" c:identifier="hb_face_reference_blob" version="0.9.2">
      <doc xml:space="preserve">Fetches a pointer to the binary blob that contains the specified face.
If referencing the face data is not possible, this function creates a blob
out of individual table blobs if hb_face_get_table_tags() works with this
face, otherwise it returns an empty blob.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">A pointer to the blob for @face</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_reference_table" c:identifier="hb_face_reference_table" version="0.9.2">
      <doc xml:space="preserve">Fetches a reference to the specified table within
the specified face. Returns an empty blob if referencing table data is not
possible.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">A pointer to the @tag table within @face</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="const hb_face_t*"/>
        </parameter>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_tag_t of the table to query</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_set_get_table_tags_func" c:identifier="hb_face_set_get_table_tags_func" version="10.0.0">
      <doc xml:space="preserve">Sets the table-tag-fetching function for the specified face object.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The table-tag-fetching function</doc>
          <type name="get_table_tags_func_t" c:type="hb_get_table_tags_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data, to be destroyed by @destroy when not needed anymore</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">A callback to call when @func is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_set_glyph_count" c:identifier="hb_face_set_glyph_count" version="0.9.7">
      <doc xml:space="preserve">Sets the glyph count for a face object to the specified value.

This API is used in rare circumstances.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="glyph_count" transfer-ownership="none">
          <doc xml:space="preserve">The glyph-count value to assign</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_set_index" c:identifier="hb_face_set_index" version="0.9.2">
      <doc xml:space="preserve">Assigns the specified face-index to @face. Fails if the
face is immutable.

&lt;note&gt;Note: changing the index has no effect on the face itself
This only changes the value returned by hb_face_get_index().&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="index" transfer-ownership="none">
          <doc xml:space="preserve">The index to assign</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_set_upem" c:identifier="hb_face_set_upem" version="0.9.2">
      <doc xml:space="preserve">Sets the units-per-em (upem) for a face object to the specified value.

This API is used in rare circumstances.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="upem" transfer-ownership="none">
          <doc xml:space="preserve">The units-per-em value to assign</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="face_set_user_data" c:identifier="hb_face_set_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the given face object.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to set</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="face_t" c:type="hb_face_t" opaque="1" glib:type-name="hb_face_t" glib:get-type="hb_gobject_face_get_type" c:symbol-prefix="gobject_face">
      <doc xml:space="preserve">Data type for holding font faces.</doc>
    </record>
    <function name="feature_from_string" c:identifier="hb_feature_from_string" version="0.9.5">
      <doc xml:space="preserve">Parses a string into a #hb_feature_t.

The format for specifying feature strings follows. All valid CSS
font-feature-settings values other than 'normal' and the global values are
also accepted, though not documented below. CSS string escapes are not
supported.

The range indices refer to the positions between Unicode characters. The
position before the first character is always 0.

The format is Python-esque.  Here is how it all works:

&lt;informaltable pgwide='1' align='left' frame='none'&gt;
&lt;tgroup cols='5'&gt;
&lt;thead&gt;
&lt;row&gt;&lt;entry&gt;Syntax&lt;/entry&gt;    &lt;entry&gt;Value&lt;/entry&gt; &lt;entry&gt;Start&lt;/entry&gt; &lt;entry&gt;End&lt;/entry&gt;&lt;/row&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;row&gt;&lt;entry&gt;Setting value:&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;kern&lt;/entry&gt;      &lt;entry&gt;1&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;      &lt;entry&gt;&#x221E;&lt;/entry&gt;   &lt;entry&gt;Turn feature on&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;+kern&lt;/entry&gt;     &lt;entry&gt;1&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;      &lt;entry&gt;&#x221E;&lt;/entry&gt;   &lt;entry&gt;Turn feature on&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;-kern&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;      &lt;entry&gt;&#x221E;&lt;/entry&gt;   &lt;entry&gt;Turn feature off&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;kern=0&lt;/entry&gt;    &lt;entry&gt;0&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;      &lt;entry&gt;&#x221E;&lt;/entry&gt;   &lt;entry&gt;Turn feature off&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;kern=1&lt;/entry&gt;    &lt;entry&gt;1&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;      &lt;entry&gt;&#x221E;&lt;/entry&gt;   &lt;entry&gt;Turn feature on&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;aalt=2&lt;/entry&gt;    &lt;entry&gt;2&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;      &lt;entry&gt;&#x221E;&lt;/entry&gt;   &lt;entry&gt;Choose 2nd alternate&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;Setting index:&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;kern[]&lt;/entry&gt;    &lt;entry&gt;1&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;      &lt;entry&gt;&#x221E;&lt;/entry&gt;   &lt;entry&gt;Turn feature on&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;kern[:]&lt;/entry&gt;   &lt;entry&gt;1&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;      &lt;entry&gt;&#x221E;&lt;/entry&gt;   &lt;entry&gt;Turn feature on&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;kern[5:]&lt;/entry&gt;  &lt;entry&gt;1&lt;/entry&gt;     &lt;entry&gt;5&lt;/entry&gt;      &lt;entry&gt;&#x221E;&lt;/entry&gt;   &lt;entry&gt;Turn feature on, partial&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;kern[:5]&lt;/entry&gt;  &lt;entry&gt;1&lt;/entry&gt;     &lt;entry&gt;0&lt;/entry&gt;      &lt;entry&gt;5&lt;/entry&gt;   &lt;entry&gt;Turn feature on, partial&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;kern[3:5]&lt;/entry&gt; &lt;entry&gt;1&lt;/entry&gt;     &lt;entry&gt;3&lt;/entry&gt;      &lt;entry&gt;5&lt;/entry&gt;   &lt;entry&gt;Turn feature on, range&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;kern[3]&lt;/entry&gt;   &lt;entry&gt;1&lt;/entry&gt;     &lt;entry&gt;3&lt;/entry&gt;      &lt;entry&gt;3+1&lt;/entry&gt; &lt;entry&gt;Turn feature on, single char&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;Mixing it all:&lt;/entry&gt;&lt;/row&gt;
&lt;row&gt;&lt;entry&gt;aalt[3:5]=2&lt;/entry&gt; &lt;entry&gt;2&lt;/entry&gt;   &lt;entry&gt;3&lt;/entry&gt;      &lt;entry&gt;5&lt;/entry&gt;   &lt;entry&gt;Turn 2nd alternate on for range&lt;/entry&gt;&lt;/row&gt;
&lt;/tbody&gt;
&lt;/tgroup&gt;
&lt;/informaltable&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @str is successfully parsed, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="str" transfer-ownership="none">
          <doc xml:space="preserve">a string to parse</doc>
          <array length="1" zero-terminated="0" c:type="const char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">length of @str, or -1 if string is `NULL` terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="feature" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_feature_t to initialize with the parsed values</doc>
          <type name="feature_t" c:type="hb_feature_t*"/>
        </parameter>
      </parameters>
    </function>
    <record name="feature_t" c:type="hb_feature_t" glib:type-name="hb_feature_t" glib:get-type="hb_gobject_feature_get_type" c:symbol-prefix="gobject_feature">
      <doc xml:space="preserve">The #hb_feature_t is the structure that holds information about requested
feature application. The feature will be applied with the given value to all
glyphs which are in clusters between @start (inclusive) and @end (exclusive).
Setting start to #HB_FEATURE_GLOBAL_START and end to #HB_FEATURE_GLOBAL_END
specifies that the feature always applies to the entire buffer.</doc>
      <field name="tag" writable="1">
        <doc xml:space="preserve">The #hb_tag_t tag of the feature</doc>
        <type name="tag_t" c:type="hb_tag_t"/>
      </field>
      <field name="value" writable="1">
        <doc xml:space="preserve">The value of the feature. 0 disables the feature, non-zero (usually
1) enables the feature.  For features implemented as lookup type 3 (like
'salt') the @value is a one based index into the alternates.</doc>
        <type name="guint32" c:type="uint32_t"/>
      </field>
      <field name="start" writable="1">
        <doc xml:space="preserve">the cluster to start applying this feature setting (inclusive).</doc>
        <type name="guint" c:type="unsigned int"/>
      </field>
      <field name="end" writable="1">
        <doc xml:space="preserve">the cluster to end applying this feature setting (exclusive).</doc>
        <type name="guint" c:type="unsigned int"/>
      </field>
      <method name="_string" c:identifier="hb_feature_to_string" moved-to="feature_to_string" version="0.9.5">
        <doc xml:space="preserve">Converts a #hb_feature_t into a `NULL`-terminated string in the format
understood by hb_feature_from_string(). The client in responsible for
allocating big enough size for @buf, 128 bytes is more than enough.

Note that the feature value will be omitted if it is '1', but the
string won't include any whitespace.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="feature" transfer-ownership="none">
            <doc xml:space="preserve">an #hb_feature_t to convert</doc>
            <type name="feature_t" c:type="hb_feature_t*"/>
          </instance-parameter>
          <parameter name="buf" direction="out" caller-allocates="0" transfer-ownership="full">
            <doc xml:space="preserve">output string</doc>
            <array length="1" zero-terminated="0" c:type="char*">
              <type name="utf8" c:type="char"/>
            </array>
          </parameter>
          <parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
            <doc xml:space="preserve">the allocated size of @buf</doc>
            <type name="guint" c:type="unsigned int"/>
          </parameter>
        </parameters>
      </method>
    </record>
    <function name="feature_to_string" c:identifier="hb_feature_to_string" version="0.9.5">
      <doc xml:space="preserve">Converts a #hb_feature_t into a `NULL`-terminated string in the format
understood by hb_feature_from_string(). The client in responsible for
allocating big enough size for @buf, 128 bytes is more than enough.

Note that the feature value will be omitted if it is '1', but the
string won't include any whitespace.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="feature" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_feature_t to convert</doc>
          <type name="feature_t" c:type="hb_feature_t*"/>
        </parameter>
        <parameter name="buf" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">output string</doc>
          <array length="2" zero-terminated="0" c:type="char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
        <parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">the allocated size of @buf</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_add_glyph_origin_for_direction" c:identifier="hb_font_add_glyph_origin_for_direction" version="0.9.2">
      <doc xml:space="preserve">Adds the origin coordinates to an (X,Y) point coordinate, in
the specified glyph ID in the specified font.

Calls the appropriate direction-specific variant (horizontal
or vertical) depending on the value of @direction.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the text segment</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="x" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = The original X coordinate
    Output = The X coordinate plus the X-coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = The original Y coordinate
    Output = The Y coordinate plus the Y-coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_changed" c:identifier="hb_font_changed" version="4.4.0">
      <doc xml:space="preserve">Notifies the @font that underlying font data has changed.
This has the effect of increasing the serial as returned
by hb_font_get_serial(), which invalidates internal caches.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_create" c:identifier="hb_font_create" version="0.9.2">
      <doc xml:space="preserve">Constructs a new font object from the specified face.

&lt;note&gt;Note: If @face's index value (as passed to hb_face_create()
has non-zero top 16-bits, those bits minus one are passed to
hb_font_set_var_named_instance(), effectively loading a named-instance
of a variable font, instead of the default-instance.  This allows
specifying which named-instance to load by default when creating the
face.&lt;/note&gt;</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new font object</doc>
        <type name="font_t" c:type="hb_font_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">a face.</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_create_sub_font" c:identifier="hb_font_create_sub_font" version="0.9.2">
      <doc xml:space="preserve">Constructs a sub-font font object from the specified @parent font,
replicating the parent's properties.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new sub-font font object</doc>
        <type name="font_t" c:type="hb_font_t*"/>
      </return-value>
      <parameters>
        <parameter name="parent" transfer-ownership="none">
          <doc xml:space="preserve">The parent font object</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_destroy" c:identifier="hb_font_destroy" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Decreases the reference count on the given font object. When the
reference count reaches zero, the font is destroyed,
freeing all memory.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_draw_glyph" c:identifier="hb_font_draw_glyph" version="7.0.0">
      <doc xml:space="preserve">Draws the outline that corresponds to a glyph in the specified @font.

This is an older name for hb_font_draw_glyph_or_fail(), with no
return value.

The outline is returned by way of calls to the callbacks of the @dfuncs
objects, with @draw_data passed to them.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">#hb_draw_funcs_t to draw to</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">User data to pass to draw callbacks</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_draw_glyph_func_t" c:type="hb_font_draw_glyph_func_t" version="7.0.0" deprecated="1" deprecated-version="11.2.0">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.</doc>
      <doc-deprecated xml:space="preserve">Use hb_font_draw_glyph_func_or_fail_t instead.</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="draw_funcs" transfer-ownership="none">
          <doc xml:space="preserve">The draw functions to send the shape data to</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the draw functions</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_draw_glyph_or_fail" c:identifier="hb_font_draw_glyph_or_fail" version="11.2.0">
      <doc xml:space="preserve">Draws the outline that corresponds to a glyph in the specified @font.

This is a newer name for hb_font_draw_glyph(), that returns `false`
if the font has no outlines for the glyph.

The outline is returned by way of calls to the callbacks of the @dfuncs
objects, with @draw_data passed to them.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if glyph was drawn, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">#hb_draw_funcs_t to draw to</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">User data to pass to draw callbacks</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_draw_glyph_or_fail_func_t" c:type="hb_font_draw_glyph_or_fail_func_t" version="11.2.0">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if glyph was drawn, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="draw_funcs" transfer-ownership="none">
          <doc xml:space="preserve">The draw functions to send the shape data to</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the draw functions</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <record name="font_extents_t" c:type="hb_font_extents_t">
      <doc xml:space="preserve">Font-wide extent values, measured in scaled units.

Note that typically @ascender is positive and @descender
negative, in coordinate systems that grow up.</doc>
      <field name="ascender" writable="1">
        <doc xml:space="preserve">The height of typographic ascenders.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="descender" writable="1">
        <doc xml:space="preserve">The depth of typographic descenders.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="line_gap" writable="1">
        <doc xml:space="preserve">The suggested line-spacing gap.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="reserved9" readable="0" private="1">
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="reserved8" readable="0" private="1">
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="reserved7" readable="0" private="1">
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="reserved6" readable="0" private="1">
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="reserved5" readable="0" private="1">
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="reserved4" readable="0" private="1">
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="reserved3" readable="0" private="1">
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="reserved2" readable="0" private="1">
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="reserved1" readable="0" private="1">
        <type name="position_t" c:type="hb_position_t"/>
      </field>
    </record>
    <function name="font_funcs_create" c:identifier="hb_font_funcs_create" version="0.9.2">
      <doc xml:space="preserve">Creates a new #hb_font_funcs_t structure of font functions.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The font-functions structure</doc>
        <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
      </return-value>
    </function>
    <function name="font_funcs_destroy" c:identifier="hb_font_funcs_destroy" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Decreases the reference count on a font-functions structure. When
the reference count reaches zero, the font-functions structure is
destroyed, freeing all memory.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">The font-functions structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_get_empty" c:identifier="hb_font_funcs_get_empty" version="0.9.2">
      <doc xml:space="preserve">Fetches an empty font-functions structure.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The font-functions structure</doc>
        <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
      </return-value>
    </function>
    <function name="font_funcs_get_user_data" c:identifier="hb_font_funcs_get_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Fetches the user data associated with the specified key,
attached to the specified font-functions structure.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">The font-functions structure</doc>
          <type name="font_funcs_t" c:type="const hb_font_funcs_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_is_immutable" c:identifier="hb_font_funcs_is_immutable" version="0.9.2">
      <doc xml:space="preserve">Tests whether a font-functions structure is immutable.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @ffuncs is immutable, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">The font-functions structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_make_immutable" c:identifier="hb_font_funcs_make_immutable" version="0.9.2">
      <doc xml:space="preserve">Makes a font-functions structure immutable.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">The font-functions structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_reference" c:identifier="hb_font_funcs_reference" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on a font-functions structure.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The font-functions structure</doc>
        <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">The font-functions structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_draw_glyph_func" c:identifier="hb_font_funcs_set_draw_glyph_func" version="7.0.0" deprecated="1" deprecated-version="11.2.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_draw_glyph_func_t.</doc>
      <doc-deprecated xml:space="preserve">Use hb_font_funcs_set_draw_glyph_or_fail_func instead.</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_draw_glyph_func_t" c:type="hb_font_draw_glyph_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_draw_glyph_or_fail_func" c:identifier="hb_font_funcs_set_draw_glyph_or_fail_func" version="11.2.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_draw_glyph_or_fail_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_draw_glyph_or_fail_func_t" c:type="hb_font_draw_glyph_or_fail_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_font_h_extents_func" c:identifier="hb_font_funcs_set_font_h_extents_func" version="1.1.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_font_h_extents_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_font_h_extents_func_t" c:type="hb_font_get_font_h_extents_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_font_v_extents_func" c:identifier="hb_font_funcs_set_font_v_extents_func" version="1.1.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_font_v_extents_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_font_v_extents_func_t" c:type="hb_font_get_font_v_extents_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_contour_point_func" c:identifier="hb_font_funcs_set_glyph_contour_point_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_contour_point_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_contour_point_func_t" c:type="hb_font_get_glyph_contour_point_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_extents_func" c:identifier="hb_font_funcs_set_glyph_extents_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_extents_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_extents_func_t" c:type="hb_font_get_glyph_extents_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_from_name_func" c:identifier="hb_font_funcs_set_glyph_from_name_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_from_name_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_from_name_func_t" c:type="hb_font_get_glyph_from_name_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_func" c:identifier="hb_font_funcs_set_glyph_func" version="0.9.2" deprecated="1" deprecated-version="1.2.3">
      <doc xml:space="preserve">Deprecated.  Use hb_font_funcs_set_nominal_glyph_func() and
hb_font_funcs_set_variation_glyph_func() instead.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">The font-functions structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">callback function</doc>
          <type name="font_get_glyph_func_t" c:type="hb_font_get_glyph_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_h_advance_func" c:identifier="hb_font_funcs_set_glyph_h_advance_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_h_advance_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_h_advance_func_t" c:type="hb_font_get_glyph_h_advance_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_h_advances_func" c:identifier="hb_font_funcs_set_glyph_h_advances_func" version="1.8.6">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_h_advances_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_h_advances_func_t" c:type="hb_font_get_glyph_h_advances_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_h_kerning_func" c:identifier="hb_font_funcs_set_glyph_h_kerning_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_h_kerning_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_h_kerning_func_t" c:type="hb_font_get_glyph_h_kerning_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_h_origin_func" c:identifier="hb_font_funcs_set_glyph_h_origin_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_h_origin_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_h_origin_func_t" c:type="hb_font_get_glyph_h_origin_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_h_origins_func" c:identifier="hb_font_funcs_set_glyph_h_origins_func" version="11.3.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_h_origins_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_h_origins_func_t" c:type="hb_font_get_glyph_h_origins_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_name_func" c:identifier="hb_font_funcs_set_glyph_name_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_name_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_name_func_t" c:type="hb_font_get_glyph_name_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_shape_func" c:identifier="hb_font_funcs_set_glyph_shape_func" version="4.0.0" deprecated="1" deprecated-version="7.0.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_shape_func_t,
which is the same as #hb_font_draw_glyph_func_t.</doc>
      <doc-deprecated xml:space="preserve">Use hb_font_funcs_set_draw_glyph_func() instead</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_shape_func_t" c:type="hb_font_get_glyph_shape_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_v_advance_func" c:identifier="hb_font_funcs_set_glyph_v_advance_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_v_advance_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_v_advance_func_t" c:type="hb_font_get_glyph_v_advance_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_v_advances_func" c:identifier="hb_font_funcs_set_glyph_v_advances_func" version="1.8.6">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_v_advances_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_v_advances_func_t" c:type="hb_font_get_glyph_v_advances_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_v_kerning_func" c:identifier="hb_font_funcs_set_glyph_v_kerning_func" version="0.9.2" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_v_kerning_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_v_kerning_func_t" c:type="hb_font_get_glyph_v_kerning_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_v_origin_func" c:identifier="hb_font_funcs_set_glyph_v_origin_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_v_origin_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_v_origin_func_t" c:type="hb_font_get_glyph_v_origin_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_glyph_v_origins_func" c:identifier="hb_font_funcs_set_glyph_v_origins_func" version="11.3.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_glyph_v_origins_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_glyph_v_origins_func_t" c:type="hb_font_get_glyph_v_origins_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_nominal_glyph_func" c:identifier="hb_font_funcs_set_nominal_glyph_func" version="1.2.3">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_nominal_glyph_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_nominal_glyph_func_t" c:type="hb_font_get_nominal_glyph_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_nominal_glyphs_func" c:identifier="hb_font_funcs_set_nominal_glyphs_func" version="2.0.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_nominal_glyphs_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_nominal_glyphs_func_t" c:type="hb_font_get_nominal_glyphs_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_paint_glyph_func" c:identifier="hb_font_funcs_set_paint_glyph_func" version="7.0.0" deprecated="1" deprecated-version="11.2.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_paint_glyph_func_t.</doc>
      <doc-deprecated xml:space="preserve">Use hb_font_funcs_set_paint_glyph_or_fail_func() instead.</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_paint_glyph_func_t" c:type="hb_font_paint_glyph_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_paint_glyph_or_fail_func" c:identifier="hb_font_funcs_set_paint_glyph_or_fail_func" version="11.2.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_paint_glyph_or_fail_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_paint_glyph_or_fail_func_t" c:type="hb_font_paint_glyph_or_fail_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_user_data" c:identifier="hb_font_funcs_set_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the specified font-functions structure.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">The font-functions structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to set</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data set</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_funcs_set_variation_glyph_func" c:identifier="hb_font_funcs_set_variation_glyph_func" version="1.2.3">
      <doc xml:space="preserve">Sets the implementation function for #hb_font_get_variation_glyph_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ffuncs" transfer-ownership="none">
          <doc xml:space="preserve">A font-function structure</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="font_get_variation_glyph_func_t" c:type="hb_font_get_variation_glyph_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="font_funcs_t" c:type="hb_font_funcs_t" opaque="1" glib:type-name="hb_font_funcs_t" glib:get-type="hb_gobject_font_funcs_get_type" c:symbol-prefix="gobject_font_funcs">
      <doc xml:space="preserve">Data type containing a set of virtual methods used for
working on #hb_font_t font objects.

HarfBuzz provides a lightweight default function for each of
the methods in #hb_font_funcs_t. Client programs can implement
their own replacements for the individual font functions, as
needed, and replace the default by calling the setter for a
method.</doc>
    </record>
    <function name="font_get_empty" c:identifier="hb_font_get_empty" version="0.9.2">
      <doc xml:space="preserve">Fetches the empty font object.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty font object</doc>
        <type name="font_t" c:type="hb_font_t*"/>
      </return-value>
    </function>
    <function name="font_get_extents_for_direction" c:identifier="hb_font_get_extents_for_direction" version="1.1.3">
      <doc xml:space="preserve">Fetches the extents for a font in a text segment of the
specified direction.

Calls the appropriate direction-specific variant (horizontal
or vertical) depending on the value of @direction.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the text segment</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="extents" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_font_extents_t retrieved</doc>
          <type name="font_extents_t" c:type="hb_font_extents_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_face" c:identifier="hb_font_get_face" version="0.9.2">
      <doc xml:space="preserve">Fetches the face associated with the specified font object.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_face_t value</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_font_extents_func_t" c:type="hb_font_get_font_extents_func_t">
      <doc xml:space="preserve">This method should retrieve the extents for a font.</doc>
      <return-value transfer-ownership="none">
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="extents" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The font extents retrieved</doc>
          <type name="font_extents_t" c:type="hb_font_extents_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph" c:identifier="hb_font_get_glyph" version="0.9.2">
      <doc xml:space="preserve">Fetches the glyph ID for a Unicode code point in the specified
font, with an optional variation selector.

If @variation_selector is 0, calls hb_font_get_nominal_glyph();
otherwise calls hb_font_get_variation_glyph().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="variation_selector" transfer-ownership="none">
          <doc xml:space="preserve">A variation-selector code point</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_advance_for_direction" c:identifier="hb_font_get_glyph_advance_for_direction" version="0.9.2">
      <doc xml:space="preserve">Fetches the advance for a glyph ID from the specified font,
in a text segment of the specified direction.

Calls the appropriate direction-specific variant (horizontal
or vertical) depending on the value of @direction.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the text segment</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The horizontal advance retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The vertical advance retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_glyph_advance_func_t" c:type="hb_font_get_glyph_advance_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the advance for a specified glyph. The
method must return an #hb_position_t.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The advance of @glyph within @font</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph_advances_for_direction" c:identifier="hb_font_get_glyph_advances_for_direction" version="1.8.6">
      <doc xml:space="preserve">Fetches the advances for a sequence of glyph IDs in the specified
font, in a text segment of the specified direction.

Calls the appropriate direction-specific variant (horizontal
or vertical) depending on the value of @direction.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the text segment</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="count" transfer-ownership="none">
          <doc xml:space="preserve">The number of glyph IDs in the sequence queried</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The first glyph ID to query</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyph_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive glyph IDs</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_advance" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first advance retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="advance_stride" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The stride between successive advances</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_glyph_advances_func_t" c:type="hb_font_get_glyph_advances_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the advances for a sequence of glyphs.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="count" transfer-ownership="none">
          <doc xml:space="preserve">The number of glyph IDs in the sequence queried</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The first glyph ID to query</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyph_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive glyph IDs</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_advance" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first advance retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="advance_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive advances</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph_contour_point" c:identifier="hb_font_get_glyph_contour_point" version="0.9.2">
      <doc xml:space="preserve">Fetches the (x,y) coordinates of a specified contour-point index
in the specified glyph, within the specified font.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="point_index" transfer-ownership="none">
          <doc xml:space="preserve">The contour-point index to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The X value retrieved for the contour point</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The Y value retrieved for the contour point</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_contour_point_for_origin" c:identifier="hb_font_get_glyph_contour_point_for_origin" version="0.9.2">
      <doc xml:space="preserve">Fetches the (X,Y) coordinates of a specified contour-point index
in the specified glyph ID in the specified font, with respect
to the origin in a text segment in the specified direction.

Calls the appropriate direction-specific variant (horizontal
or vertical) depending on the value of @direction.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="point_index" transfer-ownership="none">
          <doc xml:space="preserve">The contour-point index to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the text segment</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The X value retrieved for the contour point</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The Y value retrieved for the contour point</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_glyph_contour_point_func_t" c:type="hb_font_get_glyph_contour_point_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the (X,Y) coordinates (in scaled units) for a
specified contour point in a glyph. Each coordinate must be returned as
an #hb_position_t output parameter.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="point_index" transfer-ownership="none">
          <doc xml:space="preserve">The contour-point index to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The X value retrieved for the contour point</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The Y value retrieved for the contour point</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph_extents" c:identifier="hb_font_get_glyph_extents" version="0.9.2">
      <doc xml:space="preserve">Fetches the #hb_glyph_extents_t data for a glyph ID
in the specified font.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="extents" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_glyph_extents_t retrieved</doc>
          <type name="glyph_extents_t" c:type="hb_glyph_extents_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_extents_for_origin" c:identifier="hb_font_get_glyph_extents_for_origin" version="0.9.2">
      <doc xml:space="preserve">Fetches the #hb_glyph_extents_t data for a glyph ID
in the specified font, with respect to the origin in
a text segment in the specified direction.

Calls the appropriate direction-specific variant (horizontal
or vertical) depending on the value of @direction.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the text segment</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="extents" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_glyph_extents_t retrieved</doc>
          <type name="glyph_extents_t" c:type="hb_glyph_extents_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_glyph_extents_func_t" c:type="hb_font_get_glyph_extents_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the extents for a specified glyph. Extents must be
returned in an #hb_glyph_extents output parameter.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="extents" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_glyph_extents_t retrieved</doc>
          <type name="glyph_extents_t" c:type="hb_glyph_extents_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph_from_name" c:identifier="hb_font_get_glyph_from_name" version="0.9.2">
      <doc xml:space="preserve">Fetches the glyph ID that corresponds to a name string in the specified @font.

&lt;note&gt;Note: @len == -1 means the name string is null-terminated.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="name" transfer-ownership="none">
          <doc xml:space="preserve">The name string to query</doc>
          <array length="2" zero-terminated="0" c:type="const char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">The length of the name queried</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_glyph_from_name_func_t" c:type="hb_font_get_glyph_from_name_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the glyph ID that corresponds to a glyph-name
string.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="name" transfer-ownership="none">
          <doc xml:space="preserve">The name string to query</doc>
          <array length="3" zero-terminated="0" c:type="const char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">The length of the name queried</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="font_get_glyph_func_t" c:type="hb_font_get_glyph_func_t" deprecated="1" deprecated-version="1.2.3">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the glyph ID for a specified Unicode code point
font, with an optional variation selector.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="variation_selector" transfer-ownership="none">
          <doc xml:space="preserve">The  variation-selector code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph_h_advance" c:identifier="hb_font_get_glyph_h_advance" version="0.9.2">
      <doc xml:space="preserve">Fetches the advance for a glyph ID in the specified font,
for horizontal text segments.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The advance of @glyph within @font</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_h_advances" c:identifier="hb_font_get_glyph_h_advances" version="1.8.6">
      <doc xml:space="preserve">Fetches the advances for a sequence of glyph IDs in the specified
font, for horizontal text segments.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="count" transfer-ownership="none">
          <doc xml:space="preserve">The number of glyph IDs in the sequence queried</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The first glyph ID to query</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyph_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive glyph IDs</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_advance" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first advance retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="advance_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive advances</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_h_kerning" c:identifier="hb_font_get_glyph_h_kerning" version="0.9.2">
      <doc xml:space="preserve">Fetches the kerning-adjustment value for a glyph-pair in
the specified font, for horizontal text segments.

&lt;note&gt;It handles legacy kerning only (as returned by the corresponding
#hb_font_funcs_t function).&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The kerning adjustment value</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="left_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID of the left glyph in the glyph pair</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="right_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID of the right glyph in the glyph pair</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_h_origin" c:identifier="hb_font_get_glyph_h_origin" version="0.9.2">
      <doc xml:space="preserve">Fetches the (X,Y) coordinates of the origin for a glyph ID
in the specified font, for horizontal text segments.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The X coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The Y coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_h_origins" c:identifier="hb_font_get_glyph_h_origins" version="11.3.0">
      <doc xml:space="preserve">Fetches the (X,Y) coordinates of the origin for requested glyph IDs
in the specified font, for horizontal text segments.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="count" transfer-ownership="none">
          <doc xml:space="preserve">The number of glyph IDs in the sequence queried</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The first glyph ID to query</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyph_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive glyph IDs</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first X coordinate of the origin retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="x_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive X coordinates</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first Y coordinate of the origin retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive Y coordinates</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_kerning_for_direction" c:identifier="hb_font_get_glyph_kerning_for_direction" version="0.9.2">
      <doc xml:space="preserve">Fetches the kerning-adjustment value for a glyph-pair in the specified font.

Calls the appropriate direction-specific variant (horizontal
or vertical) depending on the value of @direction.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="first_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID of the first glyph in the glyph pair to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="second_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID of the second glyph in the glyph pair to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the text segment</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The horizontal kerning-adjustment value retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The vertical kerning-adjustment value retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_glyph_kerning_func_t" c:type="hb_font_get_glyph_kerning_func_t">
      <doc xml:space="preserve">This method should retrieve the kerning-adjustment value for a glyph-pair in
the specified font, for horizontal text segments.</doc>
      <return-value transfer-ownership="none">
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="first_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID of the first glyph in the glyph pair</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="second_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID of the second glyph in the glyph pair</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph_name" c:identifier="hb_font_get_glyph_name" version="0.9.2">
      <doc xml:space="preserve">Fetches the glyph-name string for a glyph ID in the specified @font.

According to the OpenType specification, glyph names are limited to 63
characters and can only contain (a subset of) ASCII.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="name" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Name string retrieved for the glyph ID</doc>
          <array length="3" zero-terminated="0" c:type="char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
        <parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Length of the glyph-name string retrieved</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_glyph_name_func_t" c:type="hb_font_get_glyph_name_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the glyph name that corresponds to a
glyph ID. The name should be returned in a string output parameter.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="name" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Name string retrieved for the glyph ID</doc>
          <array length="4" zero-terminated="0" c:type="char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
        <parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Length of the glyph-name string retrieved</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph_origin_for_direction" c:identifier="hb_font_get_glyph_origin_for_direction" version="0.9.2">
      <doc xml:space="preserve">Fetches the (X,Y) coordinates of the origin for a glyph in
the specified font.

Calls the appropriate direction-specific variant (horizontal
or vertical) depending on the value of @direction.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the text segment</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The X coordinate retrieved for the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The Y coordinate retrieved for the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_glyph_origin_func_t" c:type="hb_font_get_glyph_origin_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the (X,Y) coordinates (in scaled units) of the
origin for a glyph. Each coordinate must be returned in an #hb_position_t
output parameter.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The X coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The Y coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="font_get_glyph_origins_func_t" c:type="hb_font_get_glyph_origins_func_t" version="11.3.0">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the (X,Y) coordinates (in scaled units) of the
origin for each requested glyph. Each coordinate value must be returned in
an #hb_position_t in the two output parameters.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="count" transfer-ownership="none">
          <doc xml:space="preserve">number of glyphs to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The first glyph ID to query</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyph_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive glyph IDs</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first origin X coordinate retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="x_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive origin X coordinates</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first origin Y coordinate retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive origin Y coordinates</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="9">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph_shape" c:identifier="hb_font_get_glyph_shape" version="4.0.0" deprecated="1" deprecated-version="7.0.0">
      <doc xml:space="preserve">Fetches the glyph shape that corresponds to a glyph in the specified @font.
The shape is returned by way of calls to the callbacks of the @dfuncs
objects, with @draw_data passed to them.</doc>
      <doc-deprecated xml:space="preserve">Use hb_font_draw_glyph() instead</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="dfuncs" transfer-ownership="none">
          <doc xml:space="preserve">#hb_draw_funcs_t to draw to</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">User data to pass to draw callbacks</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_glyph_shape_func_t" c:type="hb_font_get_glyph_shape_func_t" version="4.0.0" deprecated="1" deprecated-version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.</doc>
      <doc-deprecated xml:space="preserve">Use #hb_font_draw_glyph_func_t instead</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="draw_funcs" transfer-ownership="none">
          <doc xml:space="preserve">The draw functions to send the shape data to</doc>
          <type name="draw_funcs_t" c:type="hb_draw_funcs_t*"/>
        </parameter>
        <parameter name="draw_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the draw functions</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_glyph_v_advance" c:identifier="hb_font_get_glyph_v_advance" version="0.9.2">
      <doc xml:space="preserve">Fetches the advance for a glyph ID in the specified font,
for vertical text segments.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The advance of @glyph within @font</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_v_advances" c:identifier="hb_font_get_glyph_v_advances" version="1.8.6">
      <doc xml:space="preserve">Fetches the advances for a sequence of glyph IDs in the specified
font, for vertical text segments.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="count" transfer-ownership="none">
          <doc xml:space="preserve">The number of glyph IDs in the sequence queried</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The first glyph ID to query</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyph_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive glyph IDs</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_advance" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first advance retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="advance_stride" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The stride between successive advances</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_v_kerning" c:identifier="hb_font_get_glyph_v_kerning" version="0.9.2" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Fetches the kerning-adjustment value for a glyph-pair in
the specified font, for vertical text segments.

&lt;note&gt;It handles legacy kerning only (as returned by the corresponding
#hb_font_funcs_t function).&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The kerning adjustment value</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="top_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID of the top glyph in the glyph pair</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="bottom_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID of the bottom glyph in the glyph pair</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_v_origin" c:identifier="hb_font_get_glyph_v_origin" version="0.9.2">
      <doc xml:space="preserve">Fetches the (X,Y) coordinates of the origin for a glyph ID
in the specified font, for vertical text segments.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The X coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The Y coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_glyph_v_origins" c:identifier="hb_font_get_glyph_v_origins" version="11.3.0">
      <doc xml:space="preserve">Fetches the (X,Y) coordinates of the origin for requested glyph IDs
in the specified font, for vertical text segments.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="count" transfer-ownership="none">
          <doc xml:space="preserve">The number of glyph IDs in the sequence queried</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_glyph" transfer-ownership="none">
          <doc xml:space="preserve">The first glyph ID to query</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyph_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive glyph IDs</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_x" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first X coordinate of the origin retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="x_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive X coordinates</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="first_y" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first Y coordinate of the origin retrieved</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive Y coordinates</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_h_extents" c:identifier="hb_font_get_h_extents" version="1.1.3">
      <doc xml:space="preserve">Fetches the extents for a specified font, for horizontal
text segments.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="extents" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The font extents retrieved</doc>
          <type name="font_extents_t" c:type="hb_font_extents_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_nominal_glyph" c:identifier="hb_font_get_nominal_glyph" version="1.2.3">
      <doc xml:space="preserve">Fetches the nominal glyph ID for a Unicode code point in the
specified font.

This version of the function should not be used to fetch glyph IDs
for code points modified by variation selectors. For variation-selector
support, user hb_font_get_variation_glyph() or use hb_font_get_glyph().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_nominal_glyph_func_t" c:type="hb_font_get_nominal_glyph_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the nominal glyph ID for a specified Unicode code
point. Glyph IDs must be returned in a #hb_codepoint_t output parameter.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_nominal_glyphs" c:identifier="hb_font_get_nominal_glyphs" version="2.6.3">
      <doc xml:space="preserve">Fetches the nominal glyph IDs for a sequence of Unicode code points. Glyph
IDs must be returned in a #hb_codepoint_t output parameter. Stops at the
first unsupported glyph ID.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the number of code points processed</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="count" transfer-ownership="none">
          <doc xml:space="preserve">number of code points to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_unicode" transfer-ownership="none">
          <doc xml:space="preserve">The first Unicode code point to query</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="unicode_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive code points</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyph_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive glyph IDs</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_nominal_glyphs_func_t" c:type="hb_font_get_nominal_glyphs_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the nominal glyph IDs for a sequence of
Unicode code points. Glyph IDs must be returned in a #hb_codepoint_t
output parameter.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the number of code points processed</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="count" transfer-ownership="none">
          <doc xml:space="preserve">number of code points to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_unicode" transfer-ownership="none">
          <doc xml:space="preserve">The first Unicode code point to query</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="unicode_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive code points</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="first_glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyph_stride" transfer-ownership="none">
          <doc xml:space="preserve">The stride between successive glyph IDs</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_get_parent" c:identifier="hb_font_get_parent" version="0.9.2">
      <doc xml:space="preserve">Fetches the parent font of @font.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The parent font object</doc>
        <type name="font_t" c:type="hb_font_t*"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_ppem" c:identifier="hb_font_get_ppem" version="0.9.2">
      <doc xml:space="preserve">Fetches the horizontal and vertical points-per-em (ppem) of a font.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="x_ppem" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Horizontal ppem value</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="y_ppem" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Vertical ppem value</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_ptem" c:identifier="hb_font_get_ptem" version="1.6.0">
      <doc xml:space="preserve">Fetches the "point size" of a font. Used in CoreText to
implement optical sizing.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Point size.  A value of zero means "not set."</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_scale" c:identifier="hb_font_get_scale" version="0.9.2">
      <doc xml:space="preserve">Fetches the horizontal and vertical scale of a font.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="x_scale" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Horizontal scale value</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
        <parameter name="y_scale" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Vertical scale value</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_serial" c:identifier="hb_font_get_serial" version="4.4.0">
      <doc xml:space="preserve">Returns the internal serial number of the font. The serial
number is increased every time a setting on the font is
changed, using a setter function.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">serial number</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_synthetic_bold" c:identifier="hb_font_get_synthetic_bold" version="7.0.0">
      <doc xml:space="preserve">Fetches the "synthetic boldness" parameters of a font.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="x_embolden" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">return location for horizontal value</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
        <parameter name="y_embolden" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">return location for vertical value</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
        <parameter name="in_place" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">return location for in-place value</doc>
          <type name="bool_t" c:type="hb_bool_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_synthetic_slant" c:identifier="hb_font_get_synthetic_slant" version="3.3.0">
      <doc xml:space="preserve">Fetches the "synthetic slant" of a font.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Synthetic slant.  By default is zero.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_user_data" c:identifier="hb_font_get_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Fetches the user-data object associated with the specified key,
attached to the specified font object.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">Pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="const hb_font_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_v_extents" c:identifier="hb_font_get_v_extents" version="1.1.3">
      <doc xml:space="preserve">Fetches the extents for a specified font, for vertical
text segments.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="extents" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The font extents retrieved</doc>
          <type name="font_extents_t" c:type="hb_font_extents_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_var_coords_design" c:identifier="hb_font_get_var_coords_design" version="3.3.0">
      <doc xml:space="preserve">Fetches the list of variation coordinates (in design-space units) currently
set on a font.

&lt;note&gt;Note that if no variation coordinates are set, this function may
return %NULL.&lt;/note&gt;

&lt;note&gt;If variations have been set on the font using normalized coordinates
(i.e. via hb_font_set_var_coords_normalized()), the design coordinates will
have NaN (Not a Number) values.&lt;/note&gt;

Return value is valid as long as variation coordinates of the font
are not modified.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">coordinates array</doc>
        <type name="gfloat" c:type="const float*"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Number of coordinates retrieved</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_var_coords_normalized" c:identifier="hb_font_get_var_coords_normalized" version="1.4.2">
      <doc xml:space="preserve">Fetches the list of normalized variation coordinates currently
set on a font.

&lt;note&gt;Note that if no variation coordinates are set, this function may
return %NULL.&lt;/note&gt;

Return value is valid as long as variation coordinates of the font
are not modified.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">coordinates array</doc>
        <type name="gint" c:type="const int*"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Number of coordinates retrieved</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_var_named_instance" c:identifier="hb_font_get_var_named_instance" version="7.0.0">
      <doc xml:space="preserve">Returns the currently-set named-instance index of the font.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Named-instance index or %HB_FONT_NO_VAR_NAMED_INSTANCE.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_get_variation_glyph" c:identifier="hb_font_get_variation_glyph" version="1.2.3">
      <doc xml:space="preserve">Fetches the glyph ID for a Unicode code point when followed by
by the specified variation-selector code point, in the specified
font.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="variation_selector" transfer-ownership="none">
          <doc xml:space="preserve">The  variation-selector code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_get_variation_glyph_func_t" c:type="hb_font_get_variation_glyph_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.

This method should retrieve the glyph ID for a specified Unicode code point
followed by a specified Variation Selector code point. Glyph IDs must be
returned in a #hb_codepoint_t output parameter.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="variation_selector" transfer-ownership="none">
          <doc xml:space="preserve">The  variation-selector code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The glyph ID retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_glyph_from_string" c:identifier="hb_font_glyph_from_string" version="0.9.2">
      <doc xml:space="preserve">Fetches the glyph ID from @font that matches the specified string.
Strings of the format `gidDDD` or `uniUUUU` are parsed automatically.

&lt;note&gt;Note: @len == -1 means the string is null-terminated.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="s" transfer-ownership="none">
          <doc xml:space="preserve">string to query</doc>
          <array length="2" zero-terminated="0" c:type="const char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">The length of the string @s</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="glyph" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The glyph ID corresponding to the string requested</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_glyph_to_string" c:identifier="hb_font_glyph_to_string" version="0.9.2">
      <doc xml:space="preserve">Fetches the name of the specified glyph ID in @font and returns
it in string @s.

If the glyph ID has no name in @font, a string of the form `gidDDD` is
generated, with `DDD` being the glyph ID.

According to the OpenType specification, glyph names are limited to 63
characters and can only contain (a subset of) ASCII.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="s" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The string containing the glyph name</doc>
          <array length="3" zero-terminated="0" c:type="char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
        <parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Length of string @s</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_is_immutable" c:identifier="hb_font_is_immutable" version="0.9.2">
      <doc xml:space="preserve">Tests whether a font object is immutable.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @font is immutable, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_is_synthetic" c:identifier="hb_font_is_synthetic" version="11.2.0">
      <doc xml:space="preserve">Tests whether a font is synthetic. A synthetic font is one
that has either synthetic slant or synthetic bold set on it.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the font is synthetic, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_list_funcs" c:identifier="hb_font_list_funcs" version="11.0.0">
      <doc xml:space="preserve">Retrieves the list of font functions supported by HarfBuzz.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">a
   `NULL`-terminated array of supported font functions
   constant strings. The returned array is owned by HarfBuzz
   and should not be modified or freed.</doc>
        <array c:type="const char**">
          <type name="utf8"/>
        </array>
      </return-value>
    </function>
    <function name="font_make_immutable" c:identifier="hb_font_make_immutable" version="0.9.2">
      <doc xml:space="preserve">Makes @font immutable.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_paint_glyph" c:identifier="hb_font_paint_glyph" version="7.0.0">
      <doc xml:space="preserve">Paints the glyph. This function is similar to
hb_font_paint_glyph_or_fail(), but if painting a color glyph
failed, it will fall back to painting an outline monochrome
glyph.

The painting instructions are returned by way of calls to
the callbacks of the @funcs object, with @paint_data passed
to them.

If the font has color palettes (see hb_ot_color_has_palettes()),
then @palette_index selects the palette to use. If the font only
has one palette, this will be 0.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="pfuncs" transfer-ownership="none">
          <doc xml:space="preserve">#hb_paint_funcs_t to paint with</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">User data to pass to paint callbacks</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="palette_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the font's color palette to use</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="foreground" transfer-ownership="none">
          <doc xml:space="preserve">The foreground color, unpremultipled</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_paint_glyph_func_t" c:type="hb_font_paint_glyph_func_t" version="7.0.0" deprecated="1" deprecated-version="11.2.0">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.</doc>
      <doc-deprecated xml:space="preserve">Use hb_font_paint_glyph_or_fail_func_t instead.</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="paint_funcs" transfer-ownership="none">
          <doc xml:space="preserve">The paint functions to use</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="palette_index" transfer-ownership="none">
          <doc xml:space="preserve">The color palette to use</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="foreground" transfer-ownership="none">
          <doc xml:space="preserve">The foreground color</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_paint_glyph_or_fail" c:identifier="hb_font_paint_glyph_or_fail" version="11.2.0">
      <doc xml:space="preserve">Paints a color glyph.

This function is similar to, but lower-level than,
hb_font_paint_glyph(). It is suitable for clients that
need more control.  If there are no color glyphs available,
it will return `false`. The client can then fall back to
hb_font_draw_glyph_or_fail() for the monochrome outline glyph.

The painting instructions are returned by way of calls to
the callbacks of the @funcs object, with @paint_data passed
to them.

If the font has color palettes (see hb_ot_color_has_palettes()),
then @palette_index selects the palette to use. If the font only
has one palette, this will be 0.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if glyph was painted, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="pfuncs" transfer-ownership="none">
          <doc xml:space="preserve">#hb_paint_funcs_t to paint with</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">User data to pass to paint callbacks</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="palette_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the font's color palette to use</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="foreground" transfer-ownership="none">
          <doc xml:space="preserve">The foreground color, unpremultipled</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="font_paint_glyph_or_fail_func_t" c:type="hb_font_paint_glyph_or_fail_func_t" version="11.2.0">
      <doc xml:space="preserve">A virtual method for the #hb_font_funcs_t of an #hb_font_t object.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if glyph was painted, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">@font user data pointer</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="paint_funcs" transfer-ownership="none">
          <doc xml:space="preserve">The paint functions to use</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="palette_index" transfer-ownership="none">
          <doc xml:space="preserve">The color palette to use</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="foreground" transfer-ownership="none">
          <doc xml:space="preserve">The foreground color</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="font_reference" c:identifier="hb_font_reference" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on the given font object.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The @font object</doc>
        <type name="font_t" c:type="hb_font_t*"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_face" c:identifier="hb_font_set_face" version="1.4.3">
      <doc xml:space="preserve">Sets @face as the font-face value of @font.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to assign</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_funcs" c:identifier="hb_font_set_funcs" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Replaces the font-functions structure attached to a font, updating
the font's user-data with @font-data and the @destroy callback.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="klass" transfer-ownership="none">
          <doc xml:space="preserve">The font-functions structure.</doc>
          <type name="font_funcs_t" c:type="hb_font_funcs_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to attach to @font</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The function to call when @font_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_funcs_data" c:identifier="hb_font_set_funcs_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Replaces the user data attached to a font, updating the font's
@destroy callback.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="font_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to attach to @font</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The function to call when @font_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_funcs_using" c:identifier="hb_font_set_funcs_using" version="11.0.0">
      <doc xml:space="preserve">Sets the font-functions structure to use for a font, based on the
specified name.

If @name is `NULL` or the empty string, the default (first) functioning font-functions
are used.  This default can be changed by setting the `HB_FONT_FUNCS` environment
variable to the name of the desired font-functions.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the font-functions was found and set, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="name" transfer-ownership="none">
          <doc xml:space="preserve">The name of the font-functions structure to use, or `NULL`</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_parent" c:identifier="hb_font_set_parent" version="1.0.5">
      <doc xml:space="preserve">Sets the parent font of @font.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="parent" transfer-ownership="none">
          <doc xml:space="preserve">The parent font object to assign</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_ppem" c:identifier="hb_font_set_ppem" version="0.9.2">
      <doc xml:space="preserve">Sets the horizontal and vertical pixels-per-em (PPEM) of a font.

These values are used for pixel-size-specific adjustment to
shaping and draw results, though for the most part they are
unused and can be left unset.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="x_ppem" transfer-ownership="none">
          <doc xml:space="preserve">Horizontal ppem value to assign</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="y_ppem" transfer-ownership="none">
          <doc xml:space="preserve">Vertical ppem value to assign</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_ptem" c:identifier="hb_font_set_ptem" version="1.6.0">
      <doc xml:space="preserve">Sets the "point size" of a font. Set to zero to unset.
Used in CoreText to implement optical sizing.

&lt;note&gt;Note: There are 72 points in an inch.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="ptem" transfer-ownership="none">
          <doc xml:space="preserve">font size in points.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_scale" c:identifier="hb_font_set_scale" version="0.9.2">
      <doc xml:space="preserve">Sets the horizontal and vertical scale of a font.

The font scale is a number related to, but not the same as,
font size. Typically the client establishes a scale factor
to be used between the two. For example, 64, or 256, which
would be the fractional-precision part of the font scale.
This is necessary because #hb_position_t values are integer
types and you need to leave room for fractional values
in there.

For example, to set the font size to 20, with 64
levels of fractional precision you would call
`hb_font_set_scale(font, 20 * 64, 20 * 64)`.

In the example above, even what font size 20 means is up to
you. It might be 20 pixels, or 20 points, or 20 millimeters.
HarfBuzz does not care about that.  You can set the point
size of the font using hb_font_set_ptem(), and the pixel
size using hb_font_set_ppem().

The choice of scale is yours but needs to be consistent between
what you set here, and what you expect out of #hb_position_t
as well has draw / paint API output values.

Fonts default to a scale equal to the UPEM value of their face.
A font with this setting is sometimes called an "unscaled" font.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="x_scale" transfer-ownership="none">
          <doc xml:space="preserve">Horizontal scale value to assign</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="y_scale" transfer-ownership="none">
          <doc xml:space="preserve">Vertical scale value to assign</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_synthetic_bold" c:identifier="hb_font_set_synthetic_bold" version="7.0.0">
      <doc xml:space="preserve">Sets the "synthetic boldness" of a font.

Positive values for @x_embolden / @y_embolden make a font
bolder, negative values thinner. Typical values are in the
0.01 to 0.05 range. The default value is zero.

Synthetic boldness is applied by offsetting the contour
points of the glyph shape.

Synthetic boldness is applied when rendering a glyph via
hb_font_draw_glyph_or_fail().

If @in_place is `false`, then glyph advance-widths are also
adjusted, otherwise they are not.  The in-place mode is
useful for simulating [font grading](https://fonts.google.com/knowledge/glossary/grade).</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="x_embolden" transfer-ownership="none">
          <doc xml:space="preserve">the amount to embolden horizontally</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y_embolden" transfer-ownership="none">
          <doc xml:space="preserve">the amount to embolden vertically</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="in_place" transfer-ownership="none">
          <doc xml:space="preserve">whether to embolden glyphs in-place</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_synthetic_slant" c:identifier="hb_font_set_synthetic_slant" version="3.3.0">
      <doc xml:space="preserve">Sets the "synthetic slant" of a font.  By default is zero.
Synthetic slant is the graphical skew applied to the font
at rendering time.

HarfBuzz needs to know this value to adjust shaping results,
metrics, and style values to match the slanted rendering.

&lt;note&gt;Note: The glyph shape fetched via the hb_font_draw_glyph_or_fail()
function is slanted to reflect this value as well.&lt;/note&gt;

&lt;note&gt;Note: The slant value is a ratio.  For example, a
20% slant would be represented as a 0.2 value.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="slant" transfer-ownership="none">
          <doc xml:space="preserve">synthetic slant value.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_user_data" c:identifier="hb_font_set_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the specified font object.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_var_coords_design" c:identifier="hb_font_set_var_coords_design" version="1.4.2">
      <doc xml:space="preserve">Applies a list of variation coordinates (in design-space units)
to a font.

Note that this overrides all existing variations set on @font.
Axes not included in @coords will be effectively set to their
default values.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="coords" transfer-ownership="none">
          <doc xml:space="preserve">Array of variation coordinates to apply</doc>
          <array length="2" zero-terminated="0" c:type="const float*">
            <type name="gfloat" c:type="float"/>
          </array>
        </parameter>
        <parameter name="coords_length" transfer-ownership="none">
          <doc xml:space="preserve">Number of coordinates to apply</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_var_coords_normalized" c:identifier="hb_font_set_var_coords_normalized" version="1.4.2">
      <doc xml:space="preserve">Applies a list of variation coordinates (in normalized units)
to a font.

Note that this overrides all existing variations set on @font.
Axes not included in @coords will be effectively set to their
default values.

&lt;note&gt;Note: Coordinates should be normalized to 2.14.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="coords" transfer-ownership="none">
          <doc xml:space="preserve">Array of variation coordinates to apply</doc>
          <array length="2" zero-terminated="0" c:type="const int*">
            <type name="gint" c:type="int"/>
          </array>
        </parameter>
        <parameter name="coords_length" transfer-ownership="none">
          <doc xml:space="preserve">Number of coordinates to apply</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_var_named_instance" c:identifier="hb_font_set_var_named_instance" version="2.6.0">
      <doc xml:space="preserve">Sets design coords of a font from a named-instance index.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="instance_index" transfer-ownership="none">
          <doc xml:space="preserve">named instance index.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_variation" c:identifier="hb_font_set_variation" version="7.1.0">
      <doc xml:space="preserve">Change the value of one variation axis on the font.

Note: This function is expensive to be called repeatedly.
  If you want to set multiple variation axes at the same time,
  use hb_font_set_variations() instead.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_tag_t tag of the variation-axis name</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="value" transfer-ownership="none">
          <doc xml:space="preserve">The value of the variation axis</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_set_variations" c:identifier="hb_font_set_variations" version="1.4.2">
      <doc xml:space="preserve">Applies a list of font-variation settings to a font.

Note that this overrides all existing variations set on @font.
Axes not included in @variations will be effectively set to their
default values.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="variations" transfer-ownership="none">
          <doc xml:space="preserve">Array of variation settings to apply</doc>
          <array length="2" zero-terminated="0" c:type="const hb_variation_t*">
            <type name="variation_t" c:type="hb_variation_t"/>
          </array>
        </parameter>
        <parameter name="variations_length" transfer-ownership="none">
          <doc xml:space="preserve">Number of variations to apply</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="font_subtract_glyph_origin_for_direction" c:identifier="hb_font_subtract_glyph_origin_for_direction" version="0.9.2">
      <doc xml:space="preserve">Subtracts the origin coordinates from an (X,Y) point coordinate,
in the specified glyph ID in the specified font.

Calls the appropriate direction-specific variant (horizontal
or vertical) depending on the value of @direction.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph ID to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the text segment</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="x" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = The original X coordinate
    Output = The X coordinate minus the X-coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
        <parameter name="y" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = The original Y coordinate
    Output = The Y coordinate minus the Y-coordinate of the origin</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <record name="font_t" c:type="hb_font_t" opaque="1" glib:type-name="hb_font_t" glib:get-type="hb_gobject_font_get_type" c:symbol-prefix="gobject_font">
      <doc xml:space="preserve">Data type for holding fonts.</doc>
    </record>
    <function name="free" c:identifier="hb_free" version="11.0.0">
      <doc xml:space="preserve">Frees the memory pointed to by @ptr, using the allocator set at
compile-time. Typically just free().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ptr" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The pointer to the memory to free.</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ft_face_create_from_blob_or_fail" c:identifier="hb_ft_face_create_from_blob_or_fail" version="11.0.0">
      <doc xml:space="preserve">Creates an #hb_face_t face object from the specified
font blob and face index.

This is similar in functionality to hb_face_create_from_blob_or_fail(),
but uses the FreeType library for loading the font blob. This can
be useful, for example, to load WOFF and WOFF2 font data.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new face object, or `NULL` if
loading fails (eg. blob does not contain valid font data).</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="blob" transfer-ownership="none">
          <doc xml:space="preserve">A blob</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the face within the blob</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="ft_face_create_from_file_or_fail" c:identifier="hb_ft_face_create_from_file_or_fail" version="10.1.0">
      <doc xml:space="preserve">Creates an #hb_face_t face object from the specified
font file and face index.

This is similar in functionality to hb_face_create_from_file_or_fail(),
but uses the FreeType library for loading the font file. This can
be useful, for example, to load WOFF and WOFF2 font data.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new face object, or `NULL` if
no face is found at the specified index or the file cannot be read.</doc>
        <type name="face_t" c:type="hb_face_t*"/>
      </return-value>
      <parameters>
        <parameter name="file_name" transfer-ownership="none">
          <doc xml:space="preserve">A font filename</doc>
          <type name="utf8" c:type="const char*"/>
        </parameter>
        <parameter name="index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the face within the file</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="ft_font_changed" c:identifier="hb_ft_font_changed" version="1.0.5">
      <doc xml:space="preserve">Refreshes the state of @font when the underlying FT_Face has changed.
This function should be called after changing the size or
variation-axis settings on the FT_Face.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ft_font_get_ft_face" c:identifier="hb_ft_font_get_ft_face" version="10.4.0" introspectable="0">
      <doc xml:space="preserve">Fetches the FT_Face associated with the specified #hb_font_t
font object.

This function works with #hb_font_t objects created by
hb_ft_font_create() or hb_ft_font_create_referenced().</doc>
      <return-value nullable="1">
        <doc xml:space="preserve">the FT_Face found or `NULL`</doc>
        <type name="freetype2.Face" c:type="FT_Face"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ft_font_get_load_flags" c:identifier="hb_ft_font_get_load_flags" version="1.0.5">
      <doc xml:space="preserve">Fetches the FT_Load_Glyph load flags of the specified #hb_font_t.

For more information, see
&lt;https://freetype.org/freetype2/docs/reference/ft2-glyph_retrieval.html#ft_load_xxx&gt;

This function works with #hb_font_t objects created by
hb_ft_font_create() or hb_ft_font_create_referenced().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">FT_Load_Glyph flags found, or 0</doc>
        <type name="gint" c:type="int"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ft_font_set_funcs" c:identifier="hb_ft_font_set_funcs" version="1.0.5">
      <doc xml:space="preserve">Configures the font-functions structure of the specified
#hb_font_t font object to use FreeType font functions.

In particular, you can use this function to configure an
existing #hb_face_t face object for use with FreeType font
functions even if that #hb_face_t face object was initially
created with hb_face_create(), and therefore was not
initially configured to use FreeType font functions.

An #hb_font_t object created with hb_ft_font_create()
is preconfigured for FreeType font functions and does not
require this function to be used.

Note that if you modify the underlying #hb_font_t after
calling this function, you need to call hb_ft_hb_font_changed()
to update the underlying FT_Face.

&lt;note&gt;Note: Internally, this function creates an FT_Face.
&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ft_font_set_load_flags" c:identifier="hb_ft_font_set_load_flags" version="1.0.5">
      <doc xml:space="preserve">Sets the FT_Load_Glyph load flags for the specified #hb_font_t.

For more information, see
&lt;https://freetype.org/freetype2/docs/reference/ft2-glyph_retrieval.html#ft_load_xxx&gt;

This function works with #hb_font_t objects created by
hb_ft_font_create() or hb_ft_font_create_referenced().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="load_flags" transfer-ownership="none">
          <doc xml:space="preserve">The FreeType load flags to set</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="ft_font_unlock_face" c:identifier="hb_ft_font_unlock_face" version="2.6.5" introspectable="0">
      <doc xml:space="preserve">Releases an FT_Face previously obtained with hb_ft_font_lock_face().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ft_hb_font_changed" c:identifier="hb_ft_hb_font_changed" version="4.4.0">
      <doc xml:space="preserve">Refreshes the state of the underlying FT_Face of @font when the hb_font_t
@font has changed.
This function should be called after changing the size or
variation-axis settings on the @font.
This call is fast if nothing has changed on @font.

Note that as of version 11.0.0, calling this function is not necessary,
as HarfBuzz will automatically detect changes to the font and update
the underlying FT_Face as needed.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">true if changed, false otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="get_table_tags_func_t" c:type="hb_get_table_tags_func_t" version="10.0.0">
      <doc xml:space="preserve">Callback function for hb_face_get_table_tags().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of tables, or zero if it is not possible to list</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">A face object</doc>
          <type name="face_t" c:type="const hb_face_t*"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">The index of first table tag to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="table_count" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = the maximum number of table tags to return;
               Output = the actual number of table tags returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="table_tags" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of table tags found</doc>
          <array length="2" zero-terminated="0" c:type="hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="glib_blob_create" c:identifier="hb_glib_blob_create" version="0.9.38">
      <doc xml:space="preserve">Creates an #hb_blob_t blob from the specified
GBytes data structure.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">the new #hb_blob_t blob object</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="gbytes" transfer-ownership="none">
          <doc xml:space="preserve">the GBytes structure to work upon</doc>
          <type name="GLib.Bytes" c:type="GBytes*"/>
        </parameter>
      </parameters>
    </function>
    <function name="glib_get_unicode_funcs" c:identifier="hb_glib_get_unicode_funcs" version="0.9.38">
      <doc xml:space="preserve">Fetches a Unicode-functions structure that is populated
with the appropriate GLib function for each method.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">a pointer to the #hb_unicode_funcs_t Unicode-functions structure</doc>
        <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
      </return-value>
    </function>
    <function name="glib_script_from_script" c:identifier="hb_glib_script_from_script" version="0.9.38">
      <doc xml:space="preserve">Fetches the GUnicodeScript identifier that corresponds to the
specified #hb_script_t script.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the GUnicodeScript identifier found</doc>
        <type name="GLib.UnicodeScript" c:type="GUnicodeScript"/>
      </return-value>
      <parameters>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_script_t to query</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="glib_script_to_script" c:identifier="hb_glib_script_to_script" version="0.9.38">
      <doc xml:space="preserve">Fetches the #hb_script_t script that corresponds to the
specified GUnicodeScript identifier.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the #hb_script_t script found</doc>
        <type name="script_t" c:type="hb_script_t"/>
      </return-value>
      <parameters>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">The GUnicodeScript identifier to query</doc>
          <type name="GLib.UnicodeScript" c:type="GUnicodeScript"/>
        </parameter>
      </parameters>
    </function>
    <record name="glyph_extents_t" c:type="hb_glyph_extents_t">
      <doc xml:space="preserve">Glyph extent values, measured in font units.

Note that @height is negative, in coordinate systems that grow up.</doc>
      <field name="x_bearing" writable="1">
        <doc xml:space="preserve">Distance from the x-origin to the left extremum of the glyph.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="y_bearing" writable="1">
        <doc xml:space="preserve">Distance from the top extremum of the glyph to the y-origin.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="width" writable="1">
        <doc xml:space="preserve">Distance from the left extremum of the glyph to the right extremum.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="height" writable="1">
        <doc xml:space="preserve">Distance from the top extremum of the glyph to the bottom extremum.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
    </record>
    <bitfield name="glyph_flags_t" version="1.5.0" c:type="hb_glyph_flags_t">
      <doc xml:space="preserve">Flags for #hb_glyph_info_t.</doc>
      <member name="unsafe_to_break" value="1" c:identifier="HB_GLYPH_FLAG_UNSAFE_TO_BREAK">
        <doc xml:space="preserve">Indicates that if input text is broken at the
				   beginning of the cluster this glyph is part of,
				   then both sides need to be re-shaped, as the
				   result might be different.
				   On the flip side, it means that when this
				   flag is not present, then it is safe to break
				   the glyph-run at the beginning of this
				   cluster, and the two sides will represent the
				   exact same result one would get if breaking
				   input text at the beginning of this cluster
				   and shaping the two sides separately.
				   This can be used to optimize paragraph
				   layout, by avoiding re-shaping of each line
				   after line-breaking.</doc>
      </member>
      <member name="unsafe_to_concat" value="2" c:identifier="HB_GLYPH_FLAG_UNSAFE_TO_CONCAT">
        <doc xml:space="preserve">Indicates that if input text is changed on one
				   side of the beginning of the cluster this glyph
				   is part of, then the shaping results for the
				   other side might change.
				   Note that the absence of this flag will NOT by
				   itself mean that it IS safe to concat text.
				   Only two pieces of text both of which clear of
				   this flag can be concatenated safely.
				   This can be used to optimize paragraph
				   layout, by avoiding re-shaping of each line
				   after line-breaking, by limiting the
				   reshaping to a small piece around the
				   breaking position only, even if the breaking
				   position carries the
				   #HB_GLYPH_FLAG_UNSAFE_TO_BREAK or when
				   hyphenation or other text transformation
				   happens at line-break position, in the following
				   way:
				   1. Iterate back from the line-break position
				   until the first cluster start position that is
				   NOT unsafe-to-concat, 2. shape the segment from
				   there till the end of line, 3. check whether the
				   resulting glyph-run also is clear of the
				   unsafe-to-concat at its start-of-text position;
				   if it is, just splice it into place and the line
				   is shaped; If not, move on to a position further
				   back that is clear of unsafe-to-concat and retry
				   from there, and repeat.
				   At the start of next line a similar algorithm can
				   be implemented. That is: 1. Iterate forward from
				   the line-break position until the first cluster
				   start position that is NOT unsafe-to-concat, 2.
				   shape the segment from beginning of the line to
				   that position, 3. check whether the resulting
				   glyph-run also is clear of the unsafe-to-concat
				   at its end-of-text position; if it is, just splice
				   it into place and the beginning is shaped; If not,
				   move on to a position further forward that is clear
				   of unsafe-to-concat and retry up to there, and repeat.
				   A slight complication will arise in the
				   implementation of the algorithm above,
				   because while our buffer API has a way to
				   return flags for position corresponding to
				   start-of-text, there is currently no position
				   corresponding to end-of-text.  This limitation
				   can be alleviated by shaping more text than needed
				   and looking for unsafe-to-concat flag within text
				   clusters.
				   The #HB_GLYPH_FLAG_UNSAFE_TO_BREAK flag will
				   always imply this flag.
			   To use this flag, you must enable the buffer flag
			   @HB_BUFFER_FLAG_PRODUCE_UNSAFE_TO_CONCAT during
			   shaping, otherwise the buffer flag will not be
			   reliably produced.
				   Since: 4.0.0</doc>
      </member>
      <member name="safe_to_insert_tatweel" value="4" c:identifier="HB_GLYPH_FLAG_SAFE_TO_INSERT_TATWEEL">
        <doc xml:space="preserve">In scripts that use elongation (Arabic,
				   Mongolian, Syriac, etc.), this flag signifies
				   that it is safe to insert a U+0640 TATWEEL
				   character before this cluster for elongation.
				   This flag does not determine the
				   script-specific elongation places, but only
				   when it is safe to do the elongation without
				   interrupting text shaping.
				   Since: 5.1.0</doc>
      </member>
      <member name="defined" value="7" c:identifier="HB_GLYPH_FLAG_DEFINED">
        <doc xml:space="preserve">All the currently defined flags.</doc>
      </member>
    </bitfield>
    <function name="glyph_info_get_glyph_flags" c:identifier="hb_glyph_info_get_glyph_flags" version="1.5.0">
      <doc xml:space="preserve">Returns glyph flags encoded within a #hb_glyph_info_t.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_glyph_flags_t encoded within @info</doc>
        <type name="glyph_flags_t" c:type="hb_glyph_flags_t"/>
      </return-value>
      <parameters>
        <parameter name="info" transfer-ownership="none">
          <doc xml:space="preserve">a #hb_glyph_info_t</doc>
          <type name="glyph_info_t" c:type="const hb_glyph_info_t*"/>
        </parameter>
      </parameters>
    </function>
    <record name="glyph_info_t" c:type="hb_glyph_info_t" glib:type-name="hb_glyph_info_t" glib:get-type="hb_gobject_glyph_info_get_type" c:symbol-prefix="gobject_glyph_info">
      <doc xml:space="preserve">The #hb_glyph_info_t is the structure that holds information about the
glyphs and their relation to input text.</doc>
      <field name="codepoint" writable="1">
        <doc xml:space="preserve">either a Unicode code point (before shaping) or a glyph index
            (after shaping).</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </field>
      <field name="mask" readable="0" private="1">
        <type name="mask_t" c:type="hb_mask_t"/>
      </field>
      <field name="cluster" writable="1">
        <doc xml:space="preserve">the index of the character in the original text that corresponds
          to this #hb_glyph_info_t, or whatever the client passes to
          hb_buffer_add(). More than one #hb_glyph_info_t can have the same
          @cluster value, if they resulted from the same character (e.g. one
          to many glyph substitution), and when more than one character gets
          merged in the same glyph (e.g. many to one glyph substitution) the
          #hb_glyph_info_t will have the smallest cluster value of them.
          By default some characters are merged into the same cluster
          (e.g. combining marks have the same cluster as their bases)
          even if they are separate glyphs, hb_buffer_set_cluster_level()
          allow selecting more fine-grained cluster handling.</doc>
        <type name="guint32" c:type="uint32_t"/>
      </field>
      <field name="var1" readable="0" private="1">
        <type name="var_int_t" c:type="hb_var_int_t"/>
      </field>
      <field name="var2" readable="0" private="1">
        <type name="var_int_t" c:type="hb_var_int_t"/>
      </field>
    </record>
    <record name="glyph_position_t" c:type="hb_glyph_position_t" glib:type-name="hb_glyph_position_t" glib:get-type="hb_gobject_glyph_position_get_type" c:symbol-prefix="gobject_glyph_position">
      <doc xml:space="preserve">The #hb_glyph_position_t is the structure that holds the positions of the
glyph in both horizontal and vertical directions. All positions in
#hb_glyph_position_t are relative to the current point.</doc>
      <field name="x_advance" writable="1">
        <doc xml:space="preserve">how much the line advances after drawing this glyph when setting
            text in horizontal direction.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="y_advance" writable="1">
        <doc xml:space="preserve">how much the line advances after drawing this glyph when setting
            text in vertical direction.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="x_offset" writable="1">
        <doc xml:space="preserve">how much the glyph moves on the X-axis before drawing it, this
           should not affect how much the line advances.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="y_offset" writable="1">
        <doc xml:space="preserve">how much the glyph moves on the Y-axis before drawing it, this
           should not affect how much the line advances.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="var" readable="0" private="1">
        <type name="var_int_t" c:type="hb_var_int_t"/>
      </field>
    </record>
    <docsection name="hb-aat-layout">
      <doc xml:space="preserve">Functions for querying AAT Layout features in the font face.

HarfBuzz supports all of the AAT tables used to implement shaping. Other
AAT tables and their associated features are not supported.</doc>
    </docsection>
    <docsection name="hb-blob">
      <doc xml:space="preserve">Blobs wrap a chunk of binary data to handle lifecycle management of data
while it is passed between client and HarfBuzz.  Blobs are primarily used
to create font faces, but also to access font face tables, as well as
pass around other binary data.</doc>
    </docsection>
    <docsection name="hb-buffer">
      <doc xml:space="preserve">Buffers serve a dual role in HarfBuzz; before shaping, they hold
the input characters that are passed to hb_shape(), and after
shaping they hold the output glyphs.

The input buffer is a sequence of Unicode codepoints, with
associated attributes such as direction and script.  The output
buffer is a sequence of glyphs, with associated attributes such
as position and cluster.</doc>
    </docsection>
    <docsection name="hb-common">
      <doc xml:space="preserve">Common data types used across HarfBuzz are defined here.</doc>
    </docsection>
    <docsection name="hb-deprecated">
      <doc xml:space="preserve">These API have been deprecated in favor of newer API, or because they
were deemed unnecessary.</doc>
    </docsection>
    <docsection name="hb-draw">
      <doc xml:space="preserve">Functions for drawing (extracting) glyph shapes.

The #hb_draw_funcs_t struct can be used with hb_font_draw_glyph().</doc>
    </docsection>
    <docsection name="hb-face">
      <doc xml:space="preserve">A font face is an object that represents a single face from within a
font family.

More precisely, a font face represents a single face in a binary font file.
Font faces are typically built from a binary blob and a face index.
Font faces are used to create fonts.

A font face can be created from a binary blob using hb_face_create().
The face index is used to select a face from a binary blob that contains
multiple faces.  For example, a binary blob that contains both a regular
and a bold face can be used to create two font faces, one for each face
index.</doc>
    </docsection>
    <docsection name="hb-font">
      <doc xml:space="preserve">Functions for working with font objects.

A font object represents a font face at a specific size and with
certain other parameters (pixels-per-em, points-per-em, variation
settings) specified. Font objects are created from font face
objects, and are used as input to hb_shape(), among other things.

Client programs can optionally pass in their own functions that
implement the basic, lower-level queries of font objects. This set
of font functions is defined by the virtual methods in
#hb_font_funcs_t.

HarfBuzz provides a built-in set of lightweight default
functions for each method in #hb_font_funcs_t.

The default font functions are implemented in terms of the
#hb_font_funcs_t methods of the parent font object.  This allows
client programs to override only the methods they need to, and
otherwise inherit the parent font's implementation, if any.</doc>
    </docsection>
    <docsection name="hb-ft">
      <doc xml:space="preserve">Functions for using HarfBuzz with the FreeType library.

HarfBuzz supports using FreeType to provide face and
font data.

&lt;note&gt;Note that FreeType is not thread-safe, therefore these
functions are not thread-safe either.&lt;/note&gt;</doc>
    </docsection>
    <docsection name="hb-glib">
      <doc xml:space="preserve">Functions for using HarfBuzz with the GLib library.

HarfBuzz supports using GLib to provide Unicode data, by attaching
GLib functions to the virtual methods in a #hb_unicode_funcs_t function
structure.</doc>
    </docsection>
    <docsection name="hb-map">
      <doc xml:space="preserve">Map objects are integer-to-integer hash-maps.  Currently they are
not used in the HarfBuzz public API, but are provided for client's
use if desired.</doc>
    </docsection>
    <docsection name="hb-ot-color">
      <doc xml:space="preserve">Functions for fetching color-font information from OpenType font faces.

HarfBuzz supports `COLR`/`CPAL`, `sbix`, `CBDT`, and `SVG` color fonts.</doc>
    </docsection>
    <docsection name="hb-ot-font">
      <doc xml:space="preserve">Functions for using OpenType fonts with hb_shape().  Note that fonts returned
by hb_font_create() default to using these functions, so most clients would
never need to call these functions directly.</doc>
    </docsection>
    <docsection name="hb-ot-layout">
      <doc xml:space="preserve">Functions for querying OpenType Layout features in the font face.
See the [OpenType specification](http://www.microsoft.com/typography/otspec/)
for details.</doc>
    </docsection>
    <docsection name="hb-ot-math">
      <doc xml:space="preserve">Functions for fetching mathematics layout data from OpenType fonts.

HarfBuzz itself does not implement a math layout solution. The
functions and types provided can be used by client programs to access
the font data necessary for typesetting OpenType Math layout.</doc>
    </docsection>
    <docsection name="hb-ot-meta">
      <doc xml:space="preserve">Functions for fetching metadata from fonts.</doc>
    </docsection>
    <docsection name="hb-ot-metrics">
      <doc xml:space="preserve">Functions for fetching metrics from fonts.</doc>
    </docsection>
    <docsection name="hb-ot-name">
      <doc xml:space="preserve">Functions for fetching name strings from OpenType fonts.</doc>
    </docsection>
    <docsection name="hb-ot-shape">
      <doc xml:space="preserve">Support functions for OpenType shaping related queries.</doc>
    </docsection>
    <docsection name="hb-ot-var">
      <doc xml:space="preserve">Functions for fetching information about OpenType Variable Fonts.</doc>
    </docsection>
    <docsection name="hb-paint">
      <doc xml:space="preserve">Functions for painting glyphs.

The main purpose of these functions is to paint (extract) color glyph layers
from the COLRv1 table, but the API works for drawing ordinary outlines and
images as well.

The #hb_paint_funcs_t struct can be used with hb_font_paint_glyph().</doc>
    </docsection>
    <docsection name="hb-set">
      <doc xml:space="preserve">Set objects represent a mathematical set of integer values.  They are
used in non-shaping APIs to query certain sets of characters or glyphs,
or other integer values.</doc>
    </docsection>
    <docsection name="hb-shape">
      <doc xml:space="preserve">Shaping is the central operation of HarfBuzz. Shaping operates on buffers,
which are sequences of Unicode characters that use the same font and have
the same text direction, script, and language. After shaping the buffer
contains the output glyphs and their positions.</doc>
    </docsection>
    <docsection name="hb-shape-plan">
      <doc xml:space="preserve">Shape plans are an internal mechanism. Each plan contains state
describing how HarfBuzz will shape a particular text segment, based on
the combination of segment properties and the capabilities in the
font face in use.

Shape plans are not used for shaping directly, but can be queried to
access certain information about how shaping will perform, given a set
of specific input parameters (script, language, direction, features,
etc.).

Most client programs will not need to deal with shape plans directly.</doc>
    </docsection>
    <docsection name="hb-style">
      <doc xml:space="preserve">Functions for fetching style information from fonts.</doc>
    </docsection>
    <docsection name="hb-unicode">
      <doc xml:space="preserve">Unicode functions are used to access Unicode character properties.
With these functions, client programs can query various properties from
the Unicode Character Database for any code point, such as General
Category (gc), Script (sc), Canonical Combining Class (ccc), etc.

Client programs can optionally pass in their own Unicode functions
that implement the same queries. The set of functions available is
defined by the virtual methods in #hb_unicode_funcs_t.

HarfBuzz provides built-in default functions for each method in
#hb_unicode_funcs_t.</doc>
    </docsection>
    <docsection name="hb-version">
      <doc xml:space="preserve">These functions and macros allow accessing version of the HarfBuzz
library used at compile- as well as run-time, and to direct code
conditionally based on those versions, again, at compile- or run-time.</doc>
    </docsection>
    <function name="language_from_string" c:identifier="hb_language_from_string" version="0.9.2">
      <doc xml:space="preserve">Converts @str representing a BCP 47 language tag to the corresponding
#hb_language_t.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">
The #hb_language_t corresponding to the BCP 47 language tag.</doc>
        <type name="language_t" c:type="hb_language_t"/>
      </return-value>
      <parameters>
        <parameter name="str" transfer-ownership="none">
          <doc xml:space="preserve">a string representing
      a BCP 47 language tag</doc>
          <array length="1" zero-terminated="0" c:type="const char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">length of the @str, or -1 if it is `NULL`-terminated.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="language_get_default" c:identifier="hb_language_get_default" version="0.9.2">
      <doc xml:space="preserve">Fetch the default language from current locale.

&lt;note&gt;Note that the first time this function is called, it calls
"setlocale (LC_CTYPE, nullptr)" to fetch current locale.  The underlying
setlocale function is, in many implementations, NOT threadsafe.  To avoid
problems, call this function once before multiple threads can call it.
This function is only used from hb_buffer_guess_segment_properties() by
HarfBuzz itself.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The default language of the locale as
an #hb_language_t</doc>
        <type name="language_t" c:type="hb_language_t"/>
      </return-value>
    </function>
    <function name="language_matches" c:identifier="hb_language_matches" version="5.0.0">
      <doc xml:space="preserve">Check whether a second language tag is the same or a more
specific version of the provided language tag.  For example,
"fa_IR.utf8" is a more specific tag for "fa" or for "fa_IR".</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if languages match, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="language" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_language_t to work on</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
        <parameter name="specific" transfer-ownership="none">
          <doc xml:space="preserve">Another #hb_language_t</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="language_t" c:type="hb_language_t" disguised="1" pointer="1">
      <doc xml:space="preserve">Data type for languages. Each #hb_language_t corresponds to a BCP 47
language tag.</doc>
      <method name="_string" c:identifier="hb_language_to_string" moved-to="language_to_string" version="0.9.2">
        <doc xml:space="preserve">Converts an #hb_language_t to a string.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">
A `NULL`-terminated string representing the @language. Must not be freed by
the caller.</doc>
          <type name="utf8" c:type="const char*"/>
        </return-value>
        <parameters>
          <instance-parameter name="language" transfer-ownership="none">
            <doc xml:space="preserve">The #hb_language_t to convert</doc>
            <type name="language_t" c:type="hb_language_t"/>
          </instance-parameter>
        </parameters>
      </method>
    </record>
    <function name="language_to_string" c:identifier="hb_language_to_string" version="0.9.2">
      <doc xml:space="preserve">Converts an #hb_language_t to a string.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">
A `NULL`-terminated string representing the @language. Must not be freed by
the caller.</doc>
        <type name="utf8" c:type="const char*"/>
      </return-value>
      <parameters>
        <parameter name="language" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_language_t to convert</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="malloc" c:identifier="hb_malloc" version="11.0.0">
      <doc xml:space="preserve">Allocates @size bytes of memory, using the allocator set at
compile-time. Typically just malloc().</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the allocated memory.</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="size" transfer-ownership="none">
          <doc xml:space="preserve">The size of the memory to allocate.</doc>
          <type name="gsize" c:type="size_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_allocation_successful" c:identifier="hb_map_allocation_successful" version="1.7.7">
      <doc xml:space="preserve">Tests whether memory allocation for a set was successful.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if allocation succeeded, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_clear" c:identifier="hb_map_clear" version="1.7.7">
      <doc xml:space="preserve">Clears out the contents of @map.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_copy" c:identifier="hb_map_copy" version="4.4.0">
      <doc xml:space="preserve">Allocate a copy of @map.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">Newly-allocated map.</doc>
        <type name="map_t" c:type="hb_map_t*"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_create" c:identifier="hb_map_create" version="1.7.7">
      <doc xml:space="preserve">Creates a new, initially empty map.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new #hb_map_t</doc>
        <type name="map_t" c:type="hb_map_t*"/>
      </return-value>
    </function>
    <function name="map_del" c:identifier="hb_map_del" version="1.7.7">
      <doc xml:space="preserve">Removes @key and its stored value from @map.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The key to delete</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_destroy" c:identifier="hb_map_destroy" version="1.7.7" introspectable="0">
      <doc xml:space="preserve">Decreases the reference count on a map. When
the reference count reaches zero, the map is
destroyed, freeing all memory.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_get" c:identifier="hb_map_get" version="1.7.7">
      <doc xml:space="preserve">Fetches the value stored for @key in @map.</doc>
      <return-value transfer-ownership="none">
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The key to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_get_empty" c:identifier="hb_map_get_empty" version="1.7.7">
      <doc xml:space="preserve">Fetches the singleton empty #hb_map_t.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty #hb_map_t</doc>
        <type name="map_t" c:type="hb_map_t*"/>
      </return-value>
    </function>
    <function name="map_get_population" c:identifier="hb_map_get_population" version="1.7.7">
      <doc xml:space="preserve">Returns the number of key-value pairs in the map.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The population of @map</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_get_user_data" c:identifier="hb_map_get_user_data" version="1.7.7" introspectable="0">
      <doc xml:space="preserve">Fetches the user data associated with the specified key,
attached to the specified map.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_has" c:identifier="hb_map_has" version="1.7.7">
      <doc xml:space="preserve">Tests whether @key is an element of @map.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @key is found in @map, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The key to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_hash" c:identifier="hb_map_hash" version="4.4.0">
      <doc xml:space="preserve">Creates a hash representing @map.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">A hash of @map.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_is_empty" c:identifier="hb_map_is_empty" version="1.7.7">
      <doc xml:space="preserve">Tests whether @map is empty (contains no elements).</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @map is empty</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_is_equal" c:identifier="hb_map_is_equal" version="4.3.0">
      <doc xml:space="preserve">Tests whether @map and @other are equal (contain the same
elements).</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the two maps are equal, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
        <parameter name="other" transfer-ownership="none">
          <doc xml:space="preserve">Another map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_keys" c:identifier="hb_map_keys" version="7.0.0">
      <doc xml:space="preserve">Add the keys of @map to @keys.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
        <parameter name="keys" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_next" c:identifier="hb_map_next" version="7.0.0">
      <doc xml:space="preserve">Fetches the next key/value pair in @map.

Set @idx to -1 to get started.

If the map is modified during iteration, the behavior is undefined.

The order in which the key/values are returned is undefined.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if there was a next value, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
        <parameter name="idx" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Iterator internal state</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
        <parameter name="key" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Key retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Value retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_reference" c:identifier="hb_map_reference" version="1.7.7" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on a map.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The map</doc>
        <type name="map_t" c:type="hb_map_t*"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_set" c:identifier="hb_map_set" version="1.7.7">
      <doc xml:space="preserve">Stores @key:@value in the map.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The key to store in the map</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="value" transfer-ownership="none">
          <doc xml:space="preserve">The value to store for @key</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_set_user_data" c:identifier="hb_map_set_user_data" version="1.7.7" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the specified map.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to set</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data to set</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="map_t" c:type="hb_map_t" opaque="1" glib:type-name="hb_map_t" glib:get-type="hb_gobject_map_get_type" c:symbol-prefix="gobject_map">
      <doc xml:space="preserve">Data type for holding integer-to-integer hash maps.</doc>
    </record>
    <function name="map_update" c:identifier="hb_map_update" version="7.0.0">
      <doc xml:space="preserve">Add the contents of @other to @map.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
        <parameter name="other" transfer-ownership="none">
          <doc xml:space="preserve">Another map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="map_values" c:identifier="hb_map_values" version="7.0.0">
      <doc xml:space="preserve">Add the values of @map to @values.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="map" transfer-ownership="none">
          <doc xml:space="preserve">A map</doc>
          <type name="map_t" c:type="const hb_map_t*"/>
        </parameter>
        <parameter name="values" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <enumeration name="memory_mode_t" c:type="hb_memory_mode_t">
      <doc xml:space="preserve">Data type holding the memory modes available to
client programs.

Regarding these various memory-modes:

- In no case shall the HarfBuzz client modify memory
  that is passed to HarfBuzz in a blob.  If there is
  any such possibility, @HB_MEMORY_MODE_DUPLICATE should be used
  such that HarfBuzz makes a copy immediately,

- Use @HB_MEMORY_MODE_READONLY otherwise, unless you really really
  really know what you are doing,

- @HB_MEMORY_MODE_WRITABLE is appropriate if you really made a
  copy of data solely for the purpose of passing to
  HarfBuzz and doing that just once (no reuse!),

- If the font is mmap()ed, it's okay to use
  @HB_MEMORY_MODE_READONLY_MAY_MAKE_WRITABLE, however, using that mode
  correctly is very tricky.  Use @HB_MEMORY_MODE_READONLY instead.</doc>
      <member name="duplicate" value="0" c:identifier="HB_MEMORY_MODE_DUPLICATE">
        <doc xml:space="preserve">HarfBuzz immediately makes a copy of the data.</doc>
      </member>
      <member name="readonly" value="1" c:identifier="HB_MEMORY_MODE_READONLY">
        <doc xml:space="preserve">HarfBuzz client will never modify the data,
    and HarfBuzz will never modify the data.</doc>
      </member>
      <member name="writable" value="2" c:identifier="HB_MEMORY_MODE_WRITABLE">
        <doc xml:space="preserve">HarfBuzz client made a copy of the data solely
    for HarfBuzz, so HarfBuzz may modify the data.</doc>
      </member>
      <member name="readonly_may_make_writable" value="3" c:identifier="HB_MEMORY_MODE_READONLY_MAY_MAKE_WRITABLE">
        <doc xml:space="preserve">See above</doc>
      </member>
    </enumeration>
    <function name="ot_color_glyph_get_layers" c:identifier="hb_ot_color_glyph_get_layers" version="2.1.0">
      <doc xml:space="preserve">Fetches a list of all color layers for the specified glyph index in the specified
face. The list returned will begin at the offset provided.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of layers available for the glyph index queried</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph index to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first layer to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="layer_count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of layers to return;
        Output = the actual number of layers returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="layers" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
          <doc xml:space="preserve">The array of layers found</doc>
          <array length="3" zero-terminated="0" c:type="hb_ot_color_layer_t*">
            <type name="ot_color_layer_t" c:type="hb_ot_color_layer_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_glyph_has_paint" c:identifier="hb_ot_color_glyph_has_paint" version="7.0.0">
      <doc xml:space="preserve">Tests where a face includes COLRv1 paint
data for @glyph.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph index to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_glyph_reference_png" c:identifier="hb_ot_color_glyph_reference_png" version="2.1.0">
      <doc xml:space="preserve">Fetches the PNG image for a glyph. This function takes a font object, not a face object,
as input. To get an optimally sized PNG blob, the PPEM values must be set on the @font
object. If PPEM is unset, the blob returned will be the largest PNG available.

If the glyph has no PNG image, the singleton empty blob is returned.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">An #hb_blob_t containing the PNG image for the glyph, if available</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">a glyph index</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_glyph_reference_svg" c:identifier="hb_ot_color_glyph_reference_svg" version="2.1.0">
      <doc xml:space="preserve">Fetches the SVG document for a glyph. The blob may be either plain text or gzip-encoded.

If the glyph has no SVG document, the singleton empty blob is returned.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">An #hb_blob_t containing the SVG document of the glyph, if available</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">a svg glyph index</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_has_layers" c:identifier="hb_ot_color_has_layers" version="2.1.0">
      <doc xml:space="preserve">Tests whether a face includes a `COLR` table
with data according to COLRv0.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_has_paint" c:identifier="hb_ot_color_has_paint" version="7.0.0">
      <doc xml:space="preserve">Tests where a face includes a `COLR` table
with data according to COLRv1.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_has_palettes" c:identifier="hb_ot_color_has_palettes" version="2.1.0">
      <doc xml:space="preserve">Tests whether a face includes a `CPAL` color-palette table.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_has_png" c:identifier="hb_ot_color_has_png" version="2.1.0">
      <doc xml:space="preserve">Tests whether a face has PNG glyph images (either in `CBDT` or `sbix` tables).</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_has_svg" c:identifier="hb_ot_color_has_svg" version="2.1.0">
      <doc xml:space="preserve">Tests whether a face includes any `SVG` glyph images.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon.</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <record name="ot_color_layer_t" c:type="hb_ot_color_layer_t" version="2.1.0">
      <doc xml:space="preserve">Pairs of glyph and color index.

A color index of 0xFFFF does not refer to a palette
color, but indicates that the foreground color should
be used.</doc>
      <field name="glyph" writable="1">
        <doc xml:space="preserve">the glyph ID of the layer</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </field>
      <field name="color_index" writable="1">
        <doc xml:space="preserve">the palette color index of the layer</doc>
        <type name="guint" c:type="unsigned int"/>
      </field>
    </record>
    <function name="ot_color_palette_color_get_name_id" c:identifier="hb_ot_color_palette_color_get_name_id" version="2.1.0">
      <doc xml:space="preserve">Fetches the `name` table Name ID that provides display names for
the specified color in a face's `CPAL` color palette.

Display names can be generic (e.g., "Background") or specific
(e.g., "Eye color").</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the Name ID found for the color.</doc>
        <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="color_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the color</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="ot_color_palette_flags_t" version="2.1.0" c:type="hb_ot_color_palette_flags_t">
      <doc xml:space="preserve">Flags that describe the properties of color palette.</doc>
      <member name="default" value="0" c:identifier="HB_OT_COLOR_PALETTE_FLAG_DEFAULT">
        <doc xml:space="preserve">Default indicating that there is nothing special
  to note about a color palette.</doc>
      </member>
      <member name="usable_with_light_background" value="1" c:identifier="HB_OT_COLOR_PALETTE_FLAG_USABLE_WITH_LIGHT_BACKGROUND">
        <doc xml:space="preserve">Flag indicating that the color
  palette is appropriate to use when displaying the font on a light background such as white.</doc>
      </member>
      <member name="usable_with_dark_background" value="2" c:identifier="HB_OT_COLOR_PALETTE_FLAG_USABLE_WITH_DARK_BACKGROUND">
        <doc xml:space="preserve">Flag indicating that the color
  palette is appropriate to use when displaying the font on a dark background such as black.</doc>
      </member>
    </bitfield>
    <function name="ot_color_palette_get_colors" c:identifier="hb_ot_color_palette_get_colors" version="2.1.0">
      <doc xml:space="preserve">Fetches a list of the colors in a color palette.

After calling this function, @colors will be filled with the palette
colors. If @colors is NULL, the function will just return the number
of total colors without storing any actual colors; this can be used
for allocating a buffer of suitable size before calling
hb_ot_color_palette_get_colors() a second time.

The RGBA values in the palette are unpremultiplied. See the
OpenType spec [CPAL](https://learn.microsoft.com/en-us/typography/opentype/spec/cpal)
section for details.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the total number of colors in the palette</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="palette_index" transfer-ownership="none">
          <doc xml:space="preserve">the index of the color palette to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first color to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="color_count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of colors to return;
              Output = the actual number of colors returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="colors" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">The array of #hb_color_t records found</doc>
          <array length="3" zero-terminated="0" c:type="hb_color_t*">
            <type name="color_t" c:type="hb_color_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_palette_get_count" c:identifier="hb_ot_color_palette_get_count" version="2.1.0">
      <doc xml:space="preserve">Fetches the number of color palettes in a face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the number of palettes found</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_palette_get_flags" c:identifier="hb_ot_color_palette_get_flags" version="2.1.0">
      <doc xml:space="preserve">Fetches the flags defined for a color palette.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the #hb_ot_color_palette_flags_t of the requested color palette</doc>
        <type name="ot_color_palette_flags_t" c:type="hb_ot_color_palette_flags_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="palette_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the color palette</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_color_palette_get_name_id" c:identifier="hb_ot_color_palette_get_name_id" version="2.1.0">
      <doc xml:space="preserve">Fetches the `name` table Name ID that provides display names for
a `CPAL` color palette.

Palette display names can be generic (e.g., "Default") or provide
specific, themed names (e.g., "Spring", "Summer", "Fall", and "Winter").</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the Named ID found for the palette.
If the requested palette has no name the result is #HB_OT_NAME_ID_INVALID.</doc>
        <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="palette_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the color palette</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_font_set_funcs" c:identifier="hb_ot_font_set_funcs" version="0.9.28">
      <doc xml:space="preserve">Sets the font functions to use when working with @font to
the HarfBuzz's native implementation. This is the default
for fonts newly created.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="ot_layout_baseline_tag_t" version="2.6.0" c:type="hb_ot_layout_baseline_tag_t">
      <doc xml:space="preserve">Baseline tags from [Baseline Tags](https://docs.microsoft.com/en-us/typography/opentype/spec/baselinetags) registry.</doc>
      <member name="b_ot_layout_baseline_tag_roman" value="1919905134" c:identifier="HB_OT_LAYOUT_BASELINE_TAG_ROMAN">
        <doc xml:space="preserve">The baseline used by alphabetic scripts such as Latin, Cyrillic and Greek.
In vertical writing mode, the alphabetic baseline for characters rotated 90 degrees clockwise.
(This would not apply to alphabetic characters that remain upright in vertical writing mode, since these
characters are not rotated.)</doc>
      </member>
      <member name="b_ot_layout_baseline_tag_hanging" value="1751215719" c:identifier="HB_OT_LAYOUT_BASELINE_TAG_HANGING">
        <doc xml:space="preserve">The hanging baseline. In horizontal direction, this is the horizontal
line from which syllables seem, to hang in Tibetan and other similar scripts. In vertical writing mode,
for Tibetan (or some other similar script) characters rotated 90 degrees clockwise.</doc>
      </member>
      <member name="b_ot_layout_baseline_tag_ideo_face_bottom_or_left" value="1768121954" c:identifier="HB_OT_LAYOUT_BASELINE_TAG_IDEO_FACE_BOTTOM_OR_LEFT">
        <doc xml:space="preserve">Ideographic character face bottom or left edge,
if the direction is horizontal or vertical, respectively.</doc>
      </member>
      <member name="b_ot_layout_baseline_tag_ideo_face_top_or_right" value="1768121972" c:identifier="HB_OT_LAYOUT_BASELINE_TAG_IDEO_FACE_TOP_OR_RIGHT">
        <doc xml:space="preserve">Ideographic character face top or right edge,
if the direction is horizontal or vertical, respectively.</doc>
      </member>
      <member name="b_ot_layout_baseline_tag_ideo_face_central" value="1231251043" c:identifier="HB_OT_LAYOUT_BASELINE_TAG_IDEO_FACE_CENTRAL">
        <doc xml:space="preserve">The center of the ideographic character face. Since: 4.0.0</doc>
      </member>
      <member name="b_ot_layout_baseline_tag_ideo_embox_bottom_or_left" value="1768187247" c:identifier="HB_OT_LAYOUT_BASELINE_TAG_IDEO_EMBOX_BOTTOM_OR_LEFT">
        <doc xml:space="preserve">Ideographic em-box bottom or left edge,
if the direction is horizontal or vertical, respectively.</doc>
      </member>
      <member name="b_ot_layout_baseline_tag_ideo_embox_top_or_right" value="1768191088" c:identifier="HB_OT_LAYOUT_BASELINE_TAG_IDEO_EMBOX_TOP_OR_RIGHT">
        <doc xml:space="preserve">Ideographic em-box top or right edge baseline,</doc>
      </member>
      <member name="b_ot_layout_baseline_tag_ideo_embox_central" value="1231315813" c:identifier="HB_OT_LAYOUT_BASELINE_TAG_IDEO_EMBOX_CENTRAL">
        <doc xml:space="preserve">The center of the ideographic em-box. Since: 4.0.0
if the direction is horizontal or vertical, respectively.</doc>
      </member>
      <member name="b_ot_layout_baseline_tag_math" value="1835103336" c:identifier="HB_OT_LAYOUT_BASELINE_TAG_MATH">
        <doc xml:space="preserve">The baseline about which mathematical characters are centered.
In vertical writing mode when mathematical characters rotated 90 degrees clockwise, are centered.</doc>
      </member>
    </bitfield>
    <function name="ot_layout_collect_features" c:identifier="hb_ot_layout_collect_features" version="1.8.5">
      <doc xml:space="preserve">Fetches a list of all feature indexes in the specified face's GSUB table
or GPOS table, underneath the specified scripts, languages, and features.
If no list of scripts is provided, all scripts will be queried. If no list
of languages is provided, all languages will be queried. If no list of
features is provided, all features will be queried.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="scripts" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The array of scripts to collect features for,
  terminated by %HB_TAG_NONE</doc>
          <array c:type="const hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
        <parameter name="languages" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The array of languages to collect features for,
  terminated by %HB_TAG_NONE</doc>
          <array c:type="const hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
        <parameter name="features" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The array of features to collect,
  terminated by %HB_TAG_NONE</doc>
          <array c:type="const hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
        <parameter name="feature_indexes" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The set of feature indexes found for the query</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_collect_features_map" c:identifier="hb_ot_layout_collect_features_map" version="8.1.0">
      <doc xml:space="preserve">Fetches the mapping from feature tags to feature indexes for
the specified script and language.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="language_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested language tag</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="feature_map" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The map of feature tag to feature index.</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_collect_lookups" c:identifier="hb_ot_layout_collect_lookups" version="0.9.8">
      <doc xml:space="preserve">Fetches a list of all feature-lookup indexes in the specified face's GSUB
table or GPOS table, underneath the specified scripts, languages, and
features. If no list of scripts is provided, all scripts will be queried.
If no list of languages is provided, all languages will be queried. If no
list of features is provided, all features will be queried.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="scripts" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The array of scripts to collect lookups for,
  terminated by %HB_TAG_NONE</doc>
          <array c:type="const hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
        <parameter name="languages" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The array of languages to collect lookups for,
  terminated by %HB_TAG_NONE</doc>
          <array c:type="const hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
        <parameter name="features" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The array of features to collect lookups for,
  terminated by %HB_TAG_NONE</doc>
          <array c:type="const hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
        <parameter name="lookup_indexes" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The array of lookup indexes found for the query</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_feature_get_characters" c:identifier="hb_ot_layout_feature_get_characters" version="2.0.0">
      <doc xml:space="preserve">Fetches a list of the characters defined as having a variant under the specified
"Character Variant" ("cvXX") feature tag.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Number of total sample characters in the cvXX feature.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">table tag to query, "GSUB" or "GPOS".</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="feature_index" transfer-ownership="none">
          <doc xml:space="preserve">index of feature to query.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first character to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="char_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of characters to return;
             Output = the actual number of characters returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="characters" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">A buffer pointer.
             The Unicode codepoints of the characters for which this feature provides
              glyph variants.</doc>
          <array length="4" zero-terminated="0" c:type="hb_codepoint_t*">
            <type name="codepoint_t" c:type="hb_codepoint_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_feature_get_lookups" c:identifier="hb_ot_layout_feature_get_lookups" version="0.9.7">
      <doc xml:space="preserve">Fetches a list of all lookups enumerated for the specified feature, in
the specified face's GSUB table or GPOS table. The list returned will
begin at the offset provided.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of lookups.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="feature_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested feature</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first lookup to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="lookup_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of lookups to return;
               Output = the actual number of lookups returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="lookup_indexes" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of lookup indexes found for the query</doc>
          <array length="4" zero-terminated="0" c:type="unsigned int*">
            <type name="guint" c:type="unsigned int"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_feature_get_name_ids" c:identifier="hb_ot_layout_feature_get_name_ids" version="2.0.0">
      <doc xml:space="preserve">Fetches name indices from feature parameters for "Stylistic Set" ('ssXX') or
"Character Variant" ('cvXX') features.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">table tag to query, "GSUB" or "GPOS".</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="feature_index" transfer-ownership="none">
          <doc xml:space="preserve">index of feature to query.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="label_id" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">The &#x2018;name&#x2019; table name ID that specifies a string
           for a user-interface label for this feature.</doc>
          <type name="ot_name_id_t" c:type="hb_ot_name_id_t*"/>
        </parameter>
        <parameter name="tooltip_id" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">The &#x2018;name&#x2019; table name ID that specifies a string
             that an application can use for tooltip text for this
             feature.</doc>
          <type name="ot_name_id_t" c:type="hb_ot_name_id_t*"/>
        </parameter>
        <parameter name="sample_id" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">The &#x2018;name&#x2019; table name ID that specifies sample text
            that illustrates the effect of this feature.</doc>
          <type name="ot_name_id_t" c:type="hb_ot_name_id_t*"/>
        </parameter>
        <parameter name="num_named_parameters" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Number of named parameters.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="first_param_id" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">The first &#x2018;name&#x2019; table name ID used to specify
                 strings for user-interface labels for the feature
                 parameters. (Must be zero if numParameters is zero.)</doc>
          <type name="ot_name_id_t" c:type="hb_ot_name_id_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_feature_with_variations_get_lookups" c:identifier="hb_ot_layout_feature_with_variations_get_lookups" version="1.4.0">
      <doc xml:space="preserve">Fetches a list of all lookups enumerated for the specified feature, in
the specified face's GSUB table or GPOS table, enabled at the specified
variations index. The list returned will begin at the offset provided.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of lookups.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="feature_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the feature to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="variations_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the feature variation to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first lookup to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="lookup_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of lookups to return;
               Output = the actual number of lookups returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="lookup_indexes" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of lookups found for the query</doc>
          <array length="5" zero-terminated="0" c:type="unsigned int*">
            <type name="guint" c:type="unsigned int"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_attach_points" c:identifier="hb_ot_layout_get_attach_points">
      <doc xml:space="preserve">Fetches a list of all attachment points for the specified glyph in the GDEF
table of the face. The list returned will begin at the offset provided.

Useful if the client program wishes to cache the list.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of attachment points for @glyph.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_codepoint_t code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first attachment point to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="point_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of attachment points to return;
              Output = the actual number of attachment points returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="point_array" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of attachment points found for the query</doc>
          <array length="3" zero-terminated="0" c:type="unsigned int*">
            <type name="guint" c:type="unsigned int"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_baseline" c:identifier="hb_ot_layout_get_baseline" version="2.6.0">
      <doc xml:space="preserve">Fetches a baseline value from the face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if found baseline value in the font.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="baseline_tag" transfer-ownership="none">
          <doc xml:space="preserve">a baseline tag</doc>
          <type name="ot_layout_baseline_tag_t" c:type="hb_ot_layout_baseline_tag_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">text direction.</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="script_tag" transfer-ownership="none">
          <doc xml:space="preserve">script tag.</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="language_tag" transfer-ownership="none">
          <doc xml:space="preserve">language tag, currently unused.</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="coord" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">baseline value if found.</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_baseline2" c:identifier="hb_ot_layout_get_baseline2" version="8.0.0">
      <doc xml:space="preserve">Fetches a baseline value from the face.

This function is like hb_ot_layout_get_baseline() but takes
#hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if found baseline value in the font.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="baseline_tag" transfer-ownership="none">
          <doc xml:space="preserve">a baseline tag</doc>
          <type name="ot_layout_baseline_tag_t" c:type="hb_ot_layout_baseline_tag_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">text direction.</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">script.</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
        <parameter name="language" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">language, currently unused.</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
        <parameter name="coord" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">baseline value if found.</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_baseline_with_fallback" c:identifier="hb_ot_layout_get_baseline_with_fallback" version="4.0.0">
      <doc xml:space="preserve">Fetches a baseline value from the face, and synthesizes
it if the font does not have it.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="baseline_tag" transfer-ownership="none">
          <doc xml:space="preserve">a baseline tag</doc>
          <type name="ot_layout_baseline_tag_t" c:type="hb_ot_layout_baseline_tag_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">text direction.</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="script_tag" transfer-ownership="none">
          <doc xml:space="preserve">script tag.</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="language_tag" transfer-ownership="none">
          <doc xml:space="preserve">language tag, currently unused.</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="coord" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">baseline value if found.</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_baseline_with_fallback2" c:identifier="hb_ot_layout_get_baseline_with_fallback2" version="8.0.0">
      <doc xml:space="preserve">Fetches a baseline value from the face, and synthesizes
it if the font does not have it.

This function is like hb_ot_layout_get_baseline_with_fallback() but takes
#hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="baseline_tag" transfer-ownership="none">
          <doc xml:space="preserve">a baseline tag</doc>
          <type name="ot_layout_baseline_tag_t" c:type="hb_ot_layout_baseline_tag_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">text direction.</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">script.</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
        <parameter name="language" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">language, currently unused.</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
        <parameter name="coord" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">baseline value if found.</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_font_extents" c:identifier="hb_ot_layout_get_font_extents" version="8.0.0">
      <doc xml:space="preserve">Fetches script/language-specific font extents.  These values are
looked up in the `BASE` table's `MinMax` records.

If no such extents are found, the default extents for the font are
fetched. As such, the return value of this function can for the
most part be ignored.  Note that the per-script/language extents
do not have a line-gap value, and the line-gap is set to zero in
that case.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if found script/language-specific font extents.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">text direction.</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="script_tag" transfer-ownership="none">
          <doc xml:space="preserve">script tag.</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="language_tag" transfer-ownership="none">
          <doc xml:space="preserve">language tag.</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="extents" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
          <doc xml:space="preserve">font extents if found.</doc>
          <type name="font_extents_t" c:type="hb_font_extents_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_font_extents2" c:identifier="hb_ot_layout_get_font_extents2" version="8.0.0">
      <doc xml:space="preserve">Fetches script/language-specific font extents.  These values are
looked up in the `BASE` table's `MinMax` records.

If no such extents are found, the default extents for the font are
fetched. As such, the return value of this function can for the
most part be ignored.  Note that the per-script/language extents
do not have a line-gap value, and the line-gap is set to zero in
that case.

This function is like hb_ot_layout_get_font_extents() but takes
#hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if found script/language-specific font extents.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">text direction.</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">script.</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
        <parameter name="language" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">language.</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
        <parameter name="extents" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
          <doc xml:space="preserve">font extents if found.</doc>
          <type name="font_extents_t" c:type="hb_font_extents_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_glyph_class" c:identifier="hb_ot_layout_get_glyph_class" version="0.9.7">
      <doc xml:space="preserve">Fetches the GDEF class of the requested glyph in the specified face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_ot_layout_glyph_class_t glyph class of the given code
point in the GDEF table of the face.</doc>
        <type name="ot_layout_glyph_class_t" c:type="hb_ot_layout_glyph_class_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_codepoint_t code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_glyphs_in_class" c:identifier="hb_ot_layout_get_glyphs_in_class" version="0.9.7">
      <doc xml:space="preserve">Retrieves the set of all glyphs from the face that belong to the requested
glyph class in the face's GDEF table.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="klass" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_ot_layout_glyph_class_t GDEF class to retrieve</doc>
          <type name="ot_layout_glyph_class_t" c:type="hb_ot_layout_glyph_class_t"/>
        </parameter>
        <parameter name="glyphs" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_set_t set of all glyphs belonging to the requested
         class.</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_horizontal_baseline_tag_for_script" c:identifier="hb_ot_layout_get_horizontal_baseline_tag_for_script" version="4.0.0">
      <doc xml:space="preserve">Fetches the dominant horizontal baseline tag used by @script.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">dominant baseline tag for the @script.</doc>
        <type name="ot_layout_baseline_tag_t" c:type="hb_ot_layout_baseline_tag_t"/>
      </return-value>
      <parameters>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">a script tag.</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_ligature_carets" c:identifier="hb_ot_layout_get_ligature_carets">
      <doc xml:space="preserve">Fetches a list of the caret positions defined for a ligature glyph in the GDEF
table of the font. The list returned will begin at the offset provided.

Note that a ligature that is formed from n characters will have n-1
caret positions. The first character is not represented in the array,
since its caret position is the glyph position.

The positions returned by this function are 'unshaped', and will have to
be fixed up for kerning that may be applied to the ligature glyph.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of ligature caret positions for @glyph.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_font_t to work on</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_direction_t text direction to use</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_codepoint_t code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first caret position to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="caret_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of caret positions to return;
              Output = the actual number of caret positions returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="caret_array" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of caret positions found for the query</doc>
          <array length="4" zero-terminated="0" c:type="hb_position_t*">
            <type name="position_t" c:type="hb_position_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_get_size_params" c:identifier="hb_ot_layout_get_size_params" version="0.9.10">
      <doc xml:space="preserve">Fetches optical-size feature data (i.e., the `size` feature from GPOS). Note that
the subfamily_id and the subfamily name string (accessible via the subfamily_name_id)
as used here are defined as pertaining only to fonts within a font family that differ
specifically in their respective size ranges; other ways to differentiate fonts within
a subfamily are not covered by the `size` feature.

For more information on this distinction, see the [`size` feature documentation](
https://docs.microsoft.com/en-us/typography/opentype/spec/features_pt#tag-size).</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="design_size" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The design size of the face</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="subfamily_id" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The identifier of the face within the font subfamily</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="subfamily_name_id" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The &#x2018;name&#x2019; table name ID of the face within the font subfamily</doc>
          <type name="ot_name_id_t" c:type="hb_ot_name_id_t*"/>
        </parameter>
        <parameter name="range_start" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The minimum size of the recommended size range for the face</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="range_end" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The maximum size of the recommended size range for the face</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <enumeration name="ot_layout_glyph_class_t" c:type="hb_ot_layout_glyph_class_t">
      <doc xml:space="preserve">The GDEF classes defined for glyphs.</doc>
      <member name="unclassified" value="0" c:identifier="HB_OT_LAYOUT_GLYPH_CLASS_UNCLASSIFIED">
        <doc xml:space="preserve">Glyphs not matching the other classifications</doc>
      </member>
      <member name="base_glyph" value="1" c:identifier="HB_OT_LAYOUT_GLYPH_CLASS_BASE_GLYPH">
        <doc xml:space="preserve">Spacing, single characters, capable of accepting marks</doc>
      </member>
      <member name="ligature" value="2" c:identifier="HB_OT_LAYOUT_GLYPH_CLASS_LIGATURE">
        <doc xml:space="preserve">Glyphs that represent ligation of multiple characters</doc>
      </member>
      <member name="mark" value="3" c:identifier="HB_OT_LAYOUT_GLYPH_CLASS_MARK">
        <doc xml:space="preserve">Non-spacing, combining glyphs that represent marks</doc>
      </member>
      <member name="component" value="4" c:identifier="HB_OT_LAYOUT_GLYPH_CLASS_COMPONENT">
        <doc xml:space="preserve">Spacing glyphs that represent part of a single character</doc>
      </member>
    </enumeration>
    <function name="ot_layout_has_glyph_classes" c:identifier="hb_ot_layout_has_glyph_classes">
      <doc xml:space="preserve">Tests whether a face has any glyph classes defined in its GDEF table.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_has_positioning" c:identifier="hb_ot_layout_has_positioning">
      <doc xml:space="preserve">Tests whether the specified face includes any GPOS positioning.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the face has GPOS data, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_has_substitution" c:identifier="hb_ot_layout_has_substitution" version="0.6.0">
      <doc xml:space="preserve">Tests whether the specified face includes any GSUB substitutions.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_language_find_feature" c:identifier="hb_ot_layout_language_find_feature" version="0.6.0">
      <doc xml:space="preserve">Fetches the index of a given feature tag in the specified face's GSUB table
or GPOS table, underneath the specified script and language.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the feature is found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested language tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="feature_tag" transfer-ownership="none">
          <doc xml:space="preserve">#hb_tag_t of the feature tag requested</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="feature_index" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The index of the requested feature</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_language_get_feature_indexes" c:identifier="hb_ot_layout_language_get_feature_indexes" version="0.6.0">
      <doc xml:space="preserve">Fetches a list of all features in the specified face's GSUB table
or GPOS table, underneath the specified script and language. The list
returned will begin at the offset provided.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of features.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested language tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first feature tag to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="feature_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of feature tags to return;
                Output: the actual number of feature tags returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="feature_indexes" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of feature indexes found for the query</doc>
          <array length="5" zero-terminated="0" c:type="unsigned int*">
            <type name="guint" c:type="unsigned int"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_language_get_feature_tags" c:identifier="hb_ot_layout_language_get_feature_tags" version="0.6.0">
      <doc xml:space="preserve">Fetches a list of all features in the specified face's GSUB table
or GPOS table, underneath the specified script and language. The list
returned will begin at the offset provided.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of feature tags.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested language tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first feature tag to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="feature_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of feature tags to return;
                Output = the actual number of feature tags returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="feature_tags" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of #hb_tag_t feature tags found for the query</doc>
          <array length="5" zero-terminated="0" c:type="hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_language_get_required_feature" c:identifier="hb_ot_layout_language_get_required_feature" version="0.9.30">
      <doc xml:space="preserve">Fetches the tag of a requested feature index in the given face's GSUB or GPOS table,
underneath the specified script and language.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the feature is found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested language tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="feature_index" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The index of the requested feature</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="feature_tag" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The #hb_tag_t of the requested feature</doc>
          <type name="tag_t" c:type="hb_tag_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_language_get_required_feature_index" c:identifier="hb_ot_layout_language_get_required_feature_index" version="0.6.0">
      <doc xml:space="preserve">Fetches the index of a requested feature in the given face's GSUB or GPOS table,
underneath the specified script and language.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the feature is found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested language tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="feature_index" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The index of the requested feature</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_lookup_collect_glyph_alternates" c:identifier="hb_ot_layout_lookup_collect_glyph_alternates" version="12.1.0">
      <doc xml:space="preserve">Collects alternates of glyphs from a given GSUB lookup index.

For one-to-one GSUB glyph substitutions, this function collects the
substituted glyph.

For lookups that assign multiple alternates to a glyph, all alternate glyphs are collected.

For other lookup types, nothing is performed and `false` is returned.

The `alternate_count` mapping will contain the number of alternates for each glyph id.
Upon entry, this mapping should contain the glyph ids as keys, and the number of alternates
currently known for each glyph id as values.

The `alternate_glyphs` mapping will contain the alternate glyph ids for each glyph id.
The mapping is encoded in the following way, upon entry and after processing:
If G is the glyph id, and A0, A1, ..., A(n-1) are the alternate glyph ids,
the mapping will contain the following entries: (G + (i &lt;&lt; 24)) -&gt; A(i)
for i = 0, 1, ..., n-1 where n is the number of alternates for G as per `alternate_count`.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if alternates were collected, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">a face.</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="lookup_index" transfer-ownership="none">
          <doc xml:space="preserve">index of the feature lookup to query.</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="alternate_count" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">mapping from glyph index to number of alternates for that glyph.</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
        <parameter name="alternate_glyphs" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">mapping from encoded glyph index and alternate index, to alternate glyph ids.</doc>
          <type name="map_t" c:type="hb_map_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_lookup_collect_glyphs" c:identifier="hb_ot_layout_lookup_collect_glyphs" version="0.9.7">
      <doc xml:space="preserve">Fetches a list of all glyphs affected by the specified lookup in the
specified face's GSUB table or GPOS table.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="lookup_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the feature lookup to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="glyphs_before" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
          <doc xml:space="preserve">Array of glyphs preceding the substitution range</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="glyphs_input" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
          <doc xml:space="preserve">Array of input glyphs that would be substituted by the lookup</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="glyphs_after" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
          <doc xml:space="preserve">Array of glyphs following the substitution range</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="glyphs_output" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
          <doc xml:space="preserve">Array of glyphs that would be the substituted output of the lookup</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_lookup_get_glyph_alternates" c:identifier="hb_ot_layout_lookup_get_glyph_alternates" version="2.6.8">
      <doc xml:space="preserve">Fetches alternates of a glyph from a given GSUB lookup index. Note that for one-to-one GSUB
glyph substitutions, this function fetches the substituted glyph.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of alternates found in the specific lookup index for the given glyph id.</doc>
        <type name="guint" c:type="unsigned"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">a face.</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="lookup_index" transfer-ownership="none">
          <doc xml:space="preserve">index of the feature lookup to query.</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">a glyph id.</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">starting offset.</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="alternate_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of alternate glyphs to return;
                  Output = the actual number of alternate glyphs returned (may be zero).</doc>
          <type name="guint" c:type="unsigned*"/>
        </parameter>
        <parameter name="alternate_glyphs" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">A glyphs buffer.
                   Alternate glyphs associated with the glyph id.</doc>
          <array length="4" zero-terminated="0" c:type="hb_codepoint_t*">
            <type name="codepoint_t" c:type="hb_codepoint_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_lookup_get_optical_bound" c:identifier="hb_ot_layout_lookup_get_optical_bound" version="5.3.0">
      <doc xml:space="preserve">Fetches the optical bound of a glyph positioned at the margin of text.
The direction identifies which edge of the glyph to query.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Adjustment value. Negative values mean the glyph will stick out of the margin.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="lookup_index" transfer-ownership="none">
          <doc xml:space="preserve">index of the feature lookup to query.</doc>
          <type name="guint" c:type="unsigned"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">edge of the glyph to query.</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">a glyph id.</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_lookup_substitute_closure" c:identifier="hb_ot_layout_lookup_substitute_closure" version="0.9.7">
      <doc xml:space="preserve">Compute the transitive closure of glyphs needed for a
specified lookup.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="lookup_index" transfer-ownership="none">
          <doc xml:space="preserve">index of the feature lookup to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="glyphs" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">Array of glyphs comprising the transitive closure of the lookup</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_lookup_would_substitute" c:identifier="hb_ot_layout_lookup_would_substitute" version="0.9.7">
      <doc xml:space="preserve">Tests whether a specified lookup in the specified face would
trigger a substitution on the given glyph sequence.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if a substitution would be triggered, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="lookup_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the lookup to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="glyphs" transfer-ownership="none">
          <doc xml:space="preserve">The sequence of glyphs to query for substitution</doc>
          <type name="codepoint_t" c:type="const hb_codepoint_t*"/>
        </parameter>
        <parameter name="glyphs_length" transfer-ownership="none">
          <doc xml:space="preserve">The length of the glyph sequence</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="zero_context" transfer-ownership="none">
          <doc xml:space="preserve">#hb_bool_t indicating whether pre-/post-context are disallowed
in substitutions</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_lookups_substitute_closure" c:identifier="hb_ot_layout_lookups_substitute_closure" version="1.8.1">
      <doc xml:space="preserve">Compute the transitive closure of glyphs needed for all of the
provided lookups.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="lookups" transfer-ownership="none">
          <doc xml:space="preserve">The set of lookups to query</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="glyphs" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">Array of glyphs comprising the transitive closure of the lookups</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_script_find_language" c:identifier="hb_ot_layout_script_find_language" version="0.6.0" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Fetches the index of a given language tag in the specified face's GSUB table
or GPOS table, underneath the specified script tag.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the language tag is found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_tag" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_tag_t of the requested language</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="language_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested language</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_script_get_language_tags" c:identifier="hb_ot_layout_script_get_language_tags" version="0.6.0">
      <doc xml:space="preserve">Fetches a list of language tags in the given face's GSUB or GPOS table, underneath
the specified script index. The list returned will begin at the offset provided.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of language tags.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first language tag to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of language tags to return;
                 Output = the actual number of language tags returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="language_tags" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Array of language tags found in the table</doc>
          <array length="4" zero-terminated="0" c:type="hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_script_select_language" c:identifier="hb_ot_layout_script_select_language" version="2.0.0">
      <doc xml:space="preserve">Fetches the index of the first language tag fom @language_tags that is present
in the specified face's GSUB or GPOS table, underneath the specified script
index.

If none of the given language tags is found, `false` is returned and
@language_index is set to the default language index.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if one of the given language tags is found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_count" transfer-ownership="none">
          <doc xml:space="preserve">The number of languages in the specified script</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_tags" transfer-ownership="none">
          <doc xml:space="preserve">The array of language tags</doc>
          <type name="tag_t" c:type="const hb_tag_t*"/>
        </parameter>
        <parameter name="language_index" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The index of the requested language</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_script_select_language2" c:identifier="hb_ot_layout_script_select_language2" version="7.0.0">
      <doc xml:space="preserve">Fetches the index of the first language tag fom @language_tags that is present
in the specified face's GSUB or GPOS table, underneath the specified script
index.

If none of the given language tags is found, `false` is returned and
@language_index is set to #HB_OT_LAYOUT_DEFAULT_LANGUAGE_INDEX and
@chosen_language is set to #HB_TAG_NONE.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if one of the given language tags is found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_count" transfer-ownership="none">
          <doc xml:space="preserve">The number of languages in the specified script</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="language_tags" transfer-ownership="none">
          <doc xml:space="preserve">The array of language tags</doc>
          <type name="tag_t" c:type="const hb_tag_t*"/>
        </parameter>
        <parameter name="language_index" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The index of the chosen language</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="chosen_language" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">#hb_tag_t of the chosen language</doc>
          <type name="tag_t" c:type="hb_tag_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_table_choose_script" c:identifier="hb_ot_layout_table_choose_script">
      <doc xml:space="preserve">Deprecated since 2.0.0</doc>
      <return-value transfer-ownership="none">
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_tags" transfer-ownership="none">
          <doc xml:space="preserve">Array of #hb_tag_t script tags</doc>
          <type name="tag_t" c:type="const hb_tag_t*"/>
        </parameter>
        <parameter name="script_index" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The index of the chosen script</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="chosen_script" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">#hb_tag_t of the chosen script</doc>
          <type name="tag_t" c:type="hb_tag_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_table_find_feature_variations" c:identifier="hb_ot_layout_table_find_feature_variations" version="1.4.0">
      <doc xml:space="preserve">Fetches a list of feature variations in the specified face's GSUB table
or GPOS table, at the specified variation coordinates.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if feature variations were found, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="coords" transfer-ownership="none">
          <doc xml:space="preserve">The variation coordinates to query</doc>
          <type name="gint" c:type="const int*"/>
        </parameter>
        <parameter name="num_coords" transfer-ownership="none">
          <doc xml:space="preserve">The number of variation coordinates</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="variations_index" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of feature variations found for the query</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_table_find_script" c:identifier="hb_ot_layout_table_find_script">
      <doc xml:space="preserve">Fetches the index if a given script tag in the specified face's GSUB table
or GPOS table.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the script is found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_tag" transfer-ownership="none">
          <doc xml:space="preserve">#hb_tag_t of the script tag requested</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_index" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The index of the requested script tag</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_table_get_feature_tags" c:identifier="hb_ot_layout_table_get_feature_tags" version="0.6.0">
      <doc xml:space="preserve">Fetches a list of all feature tags in the given face's GSUB or GPOS table.
Note that there might be duplicate feature tags, belonging to different
script/language-system pairs of the table.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of feature tags.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first feature tag to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="feature_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of feature tags to return;
                Output = the actual number of feature tags returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="feature_tags" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Array of feature tags found in the table</doc>
          <array length="3" zero-terminated="0" c:type="hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_table_get_lookup_count" c:identifier="hb_ot_layout_table_get_lookup_count" version="0.9.22">
      <doc xml:space="preserve">Fetches the total number of lookups enumerated in the specified
face's GSUB table or GPOS table.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of lookups.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_table_get_script_tags" c:identifier="hb_ot_layout_table_get_script_tags">
      <doc xml:space="preserve">Fetches a list of all scripts enumerated in the specified face's GSUB table
or GPOS table. The list returned will begin at the offset provided.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of script tags.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first script tag to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="script_count" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">Input = the maximum number of script tags to return;
               Output = the actual number of script tags returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="script_tags" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of #hb_tag_t script tags found for the query</doc>
          <array length="3" zero-terminated="0" c:type="hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_layout_table_select_script" c:identifier="hb_ot_layout_table_select_script" version="2.0.0">
      <doc xml:space="preserve">Selects an OpenType script for @table_tag from the @script_tags array.

If the table does not have any of the requested scripts, then `DFLT`,
`dflt`, and `latn` tags are tried in that order. If the table still does not
have any of these scripts, @script_index is set to
#HB_OT_LAYOUT_NO_SCRIPT_INDEX and @chosen_script is set to #HB_TAG_NONE.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if one of the requested scripts is selected, `false` if a fallback
script is selected or if no scripts are selected.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">#HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script_count" transfer-ownership="none">
          <doc xml:space="preserve">Number of script tags in the array</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="script_tags" transfer-ownership="none">
          <doc xml:space="preserve">Array of #hb_tag_t script tags</doc>
          <type name="tag_t" c:type="const hb_tag_t*"/>
        </parameter>
        <parameter name="script_index" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">The index of the requested script</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="chosen_script" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
          <doc xml:space="preserve">#hb_tag_t of the requested script</doc>
          <type name="tag_t" c:type="hb_tag_t*"/>
        </parameter>
      </parameters>
    </function>
    <enumeration name="ot_math_constant_t" version="1.3.3" c:type="hb_ot_math_constant_t">
      <doc xml:space="preserve">The 'MATH' table constants, refer to
[OpenType documentation](https://docs.microsoft.com/en-us/typography/opentype/spec/math#mathconstants-table)
For more explanations.</doc>
      <member name="script_percent_scale_down" value="0" c:identifier="HB_OT_MATH_CONSTANT_SCRIPT_PERCENT_SCALE_DOWN">
        <doc xml:space="preserve">scriptPercentScaleDown</doc>
      </member>
      <member name="script_script_percent_scale_down" value="1" c:identifier="HB_OT_MATH_CONSTANT_SCRIPT_SCRIPT_PERCENT_SCALE_DOWN">
        <doc xml:space="preserve">scriptScriptPercentScaleDown</doc>
      </member>
      <member name="delimited_sub_formula_min_height" value="2" c:identifier="HB_OT_MATH_CONSTANT_DELIMITED_SUB_FORMULA_MIN_HEIGHT">
        <doc xml:space="preserve">delimitedSubFormulaMinHeight</doc>
      </member>
      <member name="display_operator_min_height" value="3" c:identifier="HB_OT_MATH_CONSTANT_DISPLAY_OPERATOR_MIN_HEIGHT">
        <doc xml:space="preserve">displayOperatorMinHeight</doc>
      </member>
      <member name="math_leading" value="4" c:identifier="HB_OT_MATH_CONSTANT_MATH_LEADING">
        <doc xml:space="preserve">mathLeading</doc>
      </member>
      <member name="axis_height" value="5" c:identifier="HB_OT_MATH_CONSTANT_AXIS_HEIGHT">
        <doc xml:space="preserve">axisHeight</doc>
      </member>
      <member name="accent_base_height" value="6" c:identifier="HB_OT_MATH_CONSTANT_ACCENT_BASE_HEIGHT">
        <doc xml:space="preserve">accentBaseHeight</doc>
      </member>
      <member name="flattened_accent_base_height" value="7" c:identifier="HB_OT_MATH_CONSTANT_FLATTENED_ACCENT_BASE_HEIGHT">
        <doc xml:space="preserve">flattenedAccentBaseHeight</doc>
      </member>
      <member name="subscript_shift_down" value="8" c:identifier="HB_OT_MATH_CONSTANT_SUBSCRIPT_SHIFT_DOWN">
        <doc xml:space="preserve">subscriptShiftDown</doc>
      </member>
      <member name="subscript_top_max" value="9" c:identifier="HB_OT_MATH_CONSTANT_SUBSCRIPT_TOP_MAX">
        <doc xml:space="preserve">subscriptTopMax</doc>
      </member>
      <member name="subscript_baseline_drop_min" value="10" c:identifier="HB_OT_MATH_CONSTANT_SUBSCRIPT_BASELINE_DROP_MIN">
        <doc xml:space="preserve">subscriptBaselineDropMin</doc>
      </member>
      <member name="superscript_shift_up" value="11" c:identifier="HB_OT_MATH_CONSTANT_SUPERSCRIPT_SHIFT_UP">
        <doc xml:space="preserve">superscriptShiftUp</doc>
      </member>
      <member name="superscript_shift_up_cramped" value="12" c:identifier="HB_OT_MATH_CONSTANT_SUPERSCRIPT_SHIFT_UP_CRAMPED">
        <doc xml:space="preserve">superscriptShiftUpCramped</doc>
      </member>
      <member name="superscript_bottom_min" value="13" c:identifier="HB_OT_MATH_CONSTANT_SUPERSCRIPT_BOTTOM_MIN">
        <doc xml:space="preserve">superscriptBottomMin</doc>
      </member>
      <member name="superscript_baseline_drop_max" value="14" c:identifier="HB_OT_MATH_CONSTANT_SUPERSCRIPT_BASELINE_DROP_MAX">
        <doc xml:space="preserve">superscriptBaselineDropMax</doc>
      </member>
      <member name="sub_superscript_gap_min" value="15" c:identifier="HB_OT_MATH_CONSTANT_SUB_SUPERSCRIPT_GAP_MIN">
        <doc xml:space="preserve">subSuperscriptGapMin</doc>
      </member>
      <member name="superscript_bottom_max_with_subscript" value="16" c:identifier="HB_OT_MATH_CONSTANT_SUPERSCRIPT_BOTTOM_MAX_WITH_SUBSCRIPT">
        <doc xml:space="preserve">superscriptBottomMaxWithSubscript</doc>
      </member>
      <member name="space_after_script" value="17" c:identifier="HB_OT_MATH_CONSTANT_SPACE_AFTER_SCRIPT">
        <doc xml:space="preserve">spaceAfterScript</doc>
      </member>
      <member name="upper_limit_gap_min" value="18" c:identifier="HB_OT_MATH_CONSTANT_UPPER_LIMIT_GAP_MIN">
        <doc xml:space="preserve">upperLimitGapMin</doc>
      </member>
      <member name="upper_limit_baseline_rise_min" value="19" c:identifier="HB_OT_MATH_CONSTANT_UPPER_LIMIT_BASELINE_RISE_MIN">
        <doc xml:space="preserve">upperLimitBaselineRiseMin</doc>
      </member>
      <member name="lower_limit_gap_min" value="20" c:identifier="HB_OT_MATH_CONSTANT_LOWER_LIMIT_GAP_MIN">
        <doc xml:space="preserve">lowerLimitGapMin</doc>
      </member>
      <member name="lower_limit_baseline_drop_min" value="21" c:identifier="HB_OT_MATH_CONSTANT_LOWER_LIMIT_BASELINE_DROP_MIN">
        <doc xml:space="preserve">lowerLimitBaselineDropMin</doc>
      </member>
      <member name="stack_top_shift_up" value="22" c:identifier="HB_OT_MATH_CONSTANT_STACK_TOP_SHIFT_UP">
        <doc xml:space="preserve">stackTopShiftUp</doc>
      </member>
      <member name="stack_top_display_style_shift_up" value="23" c:identifier="HB_OT_MATH_CONSTANT_STACK_TOP_DISPLAY_STYLE_SHIFT_UP">
        <doc xml:space="preserve">stackTopDisplayStyleShiftUp</doc>
      </member>
      <member name="stack_bottom_shift_down" value="24" c:identifier="HB_OT_MATH_CONSTANT_STACK_BOTTOM_SHIFT_DOWN">
        <doc xml:space="preserve">stackBottomShiftDown</doc>
      </member>
      <member name="stack_bottom_display_style_shift_down" value="25" c:identifier="HB_OT_MATH_CONSTANT_STACK_BOTTOM_DISPLAY_STYLE_SHIFT_DOWN">
        <doc xml:space="preserve">stackBottomDisplayStyleShiftDown</doc>
      </member>
      <member name="stack_gap_min" value="26" c:identifier="HB_OT_MATH_CONSTANT_STACK_GAP_MIN">
        <doc xml:space="preserve">stackGapMin</doc>
      </member>
      <member name="stack_display_style_gap_min" value="27" c:identifier="HB_OT_MATH_CONSTANT_STACK_DISPLAY_STYLE_GAP_MIN">
        <doc xml:space="preserve">stackDisplayStyleGapMin</doc>
      </member>
      <member name="stretch_stack_top_shift_up" value="28" c:identifier="HB_OT_MATH_CONSTANT_STRETCH_STACK_TOP_SHIFT_UP">
        <doc xml:space="preserve">stretchStackTopShiftUp</doc>
      </member>
      <member name="stretch_stack_bottom_shift_down" value="29" c:identifier="HB_OT_MATH_CONSTANT_STRETCH_STACK_BOTTOM_SHIFT_DOWN">
        <doc xml:space="preserve">stretchStackBottomShiftDown</doc>
      </member>
      <member name="stretch_stack_gap_above_min" value="30" c:identifier="HB_OT_MATH_CONSTANT_STRETCH_STACK_GAP_ABOVE_MIN">
        <doc xml:space="preserve">stretchStackGapAboveMin</doc>
      </member>
      <member name="stretch_stack_gap_below_min" value="31" c:identifier="HB_OT_MATH_CONSTANT_STRETCH_STACK_GAP_BELOW_MIN">
        <doc xml:space="preserve">stretchStackGapBelowMin</doc>
      </member>
      <member name="fraction_numerator_shift_up" value="32" c:identifier="HB_OT_MATH_CONSTANT_FRACTION_NUMERATOR_SHIFT_UP">
        <doc xml:space="preserve">fractionNumeratorShiftUp</doc>
      </member>
      <member name="fraction_numerator_display_style_shift_up" value="33" c:identifier="HB_OT_MATH_CONSTANT_FRACTION_NUMERATOR_DISPLAY_STYLE_SHIFT_UP">
        <doc xml:space="preserve">fractionNumeratorDisplayStyleShiftUp</doc>
      </member>
      <member name="fraction_denominator_shift_down" value="34" c:identifier="HB_OT_MATH_CONSTANT_FRACTION_DENOMINATOR_SHIFT_DOWN">
        <doc xml:space="preserve">fractionDenominatorShiftDown</doc>
      </member>
      <member name="fraction_denominator_display_style_shift_down" value="35" c:identifier="HB_OT_MATH_CONSTANT_FRACTION_DENOMINATOR_DISPLAY_STYLE_SHIFT_DOWN">
        <doc xml:space="preserve">fractionDenominatorDisplayStyleShiftDown</doc>
      </member>
      <member name="fraction_numerator_gap_min" value="36" c:identifier="HB_OT_MATH_CONSTANT_FRACTION_NUMERATOR_GAP_MIN">
        <doc xml:space="preserve">fractionNumeratorGapMin</doc>
      </member>
      <member name="fraction_num_display_style_gap_min" value="37" c:identifier="HB_OT_MATH_CONSTANT_FRACTION_NUM_DISPLAY_STYLE_GAP_MIN">
        <doc xml:space="preserve">fractionNumDisplayStyleGapMin</doc>
      </member>
      <member name="fraction_rule_thickness" value="38" c:identifier="HB_OT_MATH_CONSTANT_FRACTION_RULE_THICKNESS">
        <doc xml:space="preserve">fractionRuleThickness</doc>
      </member>
      <member name="fraction_denominator_gap_min" value="39" c:identifier="HB_OT_MATH_CONSTANT_FRACTION_DENOMINATOR_GAP_MIN">
        <doc xml:space="preserve">fractionDenominatorGapMin</doc>
      </member>
      <member name="fraction_denom_display_style_gap_min" value="40" c:identifier="HB_OT_MATH_CONSTANT_FRACTION_DENOM_DISPLAY_STYLE_GAP_MIN">
        <doc xml:space="preserve">fractionDenomDisplayStyleGapMin</doc>
      </member>
      <member name="skewed_fraction_horizontal_gap" value="41" c:identifier="HB_OT_MATH_CONSTANT_SKEWED_FRACTION_HORIZONTAL_GAP">
        <doc xml:space="preserve">skewedFractionHorizontalGap</doc>
      </member>
      <member name="skewed_fraction_vertical_gap" value="42" c:identifier="HB_OT_MATH_CONSTANT_SKEWED_FRACTION_VERTICAL_GAP">
        <doc xml:space="preserve">skewedFractionVerticalGap</doc>
      </member>
      <member name="overbar_vertical_gap" value="43" c:identifier="HB_OT_MATH_CONSTANT_OVERBAR_VERTICAL_GAP">
        <doc xml:space="preserve">overbarVerticalGap</doc>
      </member>
      <member name="overbar_rule_thickness" value="44" c:identifier="HB_OT_MATH_CONSTANT_OVERBAR_RULE_THICKNESS">
        <doc xml:space="preserve">overbarRuleThickness</doc>
      </member>
      <member name="overbar_extra_ascender" value="45" c:identifier="HB_OT_MATH_CONSTANT_OVERBAR_EXTRA_ASCENDER">
        <doc xml:space="preserve">overbarExtraAscender</doc>
      </member>
      <member name="underbar_vertical_gap" value="46" c:identifier="HB_OT_MATH_CONSTANT_UNDERBAR_VERTICAL_GAP">
        <doc xml:space="preserve">underbarVerticalGap</doc>
      </member>
      <member name="underbar_rule_thickness" value="47" c:identifier="HB_OT_MATH_CONSTANT_UNDERBAR_RULE_THICKNESS">
        <doc xml:space="preserve">underbarRuleThickness</doc>
      </member>
      <member name="underbar_extra_descender" value="48" c:identifier="HB_OT_MATH_CONSTANT_UNDERBAR_EXTRA_DESCENDER">
        <doc xml:space="preserve">underbarExtraDescender</doc>
      </member>
      <member name="radical_vertical_gap" value="49" c:identifier="HB_OT_MATH_CONSTANT_RADICAL_VERTICAL_GAP">
        <doc xml:space="preserve">radicalVerticalGap</doc>
      </member>
      <member name="radical_display_style_vertical_gap" value="50" c:identifier="HB_OT_MATH_CONSTANT_RADICAL_DISPLAY_STYLE_VERTICAL_GAP">
        <doc xml:space="preserve">radicalDisplayStyleVerticalGap</doc>
      </member>
      <member name="radical_rule_thickness" value="51" c:identifier="HB_OT_MATH_CONSTANT_RADICAL_RULE_THICKNESS">
        <doc xml:space="preserve">radicalRuleThickness</doc>
      </member>
      <member name="radical_extra_ascender" value="52" c:identifier="HB_OT_MATH_CONSTANT_RADICAL_EXTRA_ASCENDER">
        <doc xml:space="preserve">radicalExtraAscender</doc>
      </member>
      <member name="radical_kern_before_degree" value="53" c:identifier="HB_OT_MATH_CONSTANT_RADICAL_KERN_BEFORE_DEGREE">
        <doc xml:space="preserve">radicalKernBeforeDegree</doc>
      </member>
      <member name="radical_kern_after_degree" value="54" c:identifier="HB_OT_MATH_CONSTANT_RADICAL_KERN_AFTER_DEGREE">
        <doc xml:space="preserve">radicalKernAfterDegree</doc>
      </member>
      <member name="radical_degree_bottom_raise_percent" value="55" c:identifier="HB_OT_MATH_CONSTANT_RADICAL_DEGREE_BOTTOM_RAISE_PERCENT">
        <doc xml:space="preserve">radicalDegreeBottomRaisePercent</doc>
      </member>
    </enumeration>
    <function name="ot_math_get_constant" c:identifier="hb_ot_math_get_constant" version="1.3.3">
      <doc xml:space="preserve">Fetches the specified math constant. For most constants, the value returned
is an #hb_position_t.

However, if the requested constant is #HB_OT_MATH_CONSTANT_SCRIPT_PERCENT_SCALE_DOWN,
#HB_OT_MATH_CONSTANT_SCRIPT_SCRIPT_PERCENT_SCALE_DOWN or
#HB_OT_MATH_CONSTANT_RADICAL_DEGREE_BOTTOM_RAISE_PERCENT, then the return value is
an integer between 0 and 100 representing that percentage.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the requested constant or zero</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="constant" transfer-ownership="none">
          <doc xml:space="preserve">#hb_ot_math_constant_t the constant to retrieve</doc>
          <type name="ot_math_constant_t" c:type="hb_ot_math_constant_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_math_get_glyph_assembly" c:identifier="hb_ot_math_get_glyph_assembly" version="1.3.3">
      <doc xml:space="preserve">Fetches the GlyphAssembly for the specified font, glyph index, and direction.
Returned are a list of #hb_ot_math_glyph_part_t glyph parts that can be
used to draw the glyph and an italics-correction value (if one is defined
in the font).

&lt;note&gt;The @direction parameter is only used to select between horizontal
or vertical directions for the construction. Even though all #hb_direction_t
values are accepted, only the result of #HB_DIRECTION_IS_HORIZONTAL is
considered.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the total number of parts in the glyph assembly</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The index of the glyph to stretch</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">direction of the stretching (horizontal or vertical)</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first glyph part to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="parts_count" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = maximum number of glyph parts to return;
              Output = actual number of parts returned</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="parts" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">the glyph parts returned</doc>
          <array length="4" zero-terminated="0" c:type="hb_ot_math_glyph_part_t*">
            <type name="ot_math_glyph_part_t" c:type="hb_ot_math_glyph_part_t"/>
          </array>
        </parameter>
        <parameter name="italics_correction" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">italics correction of the glyph assembly</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_math_get_glyph_italics_correction" c:identifier="hb_ot_math_get_glyph_italics_correction" version="1.3.3">
      <doc xml:space="preserve">Fetches an italics-correction value (if one exists) for the specified
glyph index.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the italics correction of the glyph or zero</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph index from which to retrieve the value</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_math_get_glyph_kerning" c:identifier="hb_ot_math_get_glyph_kerning" version="1.3.3">
      <doc xml:space="preserve">Fetches the math kerning (cut-ins) value for the specified font, glyph index, and
@kern.

If the MathKern table is found, the function examines it to find a height
value that is greater or equal to @correction_height. If such a height
value is found, corresponding kerning value from the table is returned. If
no such height value is found, the last kerning value is returned.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">requested kerning value or zero</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph index from which to retrieve the value</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="kern" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_ot_math_kern_t from which to retrieve the value</doc>
          <type name="ot_math_kern_t" c:type="hb_ot_math_kern_t"/>
        </parameter>
        <parameter name="correction_height" transfer-ownership="none">
          <doc xml:space="preserve">the correction height to use to determine the kerning.</doc>
          <type name="position_t" c:type="hb_position_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_math_get_glyph_kernings" c:identifier="hb_ot_math_get_glyph_kernings" version="3.4.0">
      <doc xml:space="preserve">Fetches the raw MathKern (cut-in) data for the specified font, glyph index,
and @kern. The corresponding list of kern values and correction heights is
returned as a list of #hb_ot_math_kern_entry_t structs.

See also #hb_ot_math_get_glyph_kerning, which handles selecting the
appropriate kern value for a given correction height.

&lt;note&gt;For a glyph with @n defined kern values (where @n &gt; 0), there are only
@n&#x2212;1 defined correction heights, as each correction height defines a boundary
past which the next kern value should be selected. Therefore, only the
#hb_ot_math_kern_entry_t.kern_value of the uppermost #hb_ot_math_kern_entry_t
actually comes from the font; its corresponding
#hb_ot_math_kern_entry_t.max_correction_height is always set to
&lt;code&gt;INT32_MAX&lt;/code&gt;.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the total number of kern values available or zero</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph index from which to retrieve the kernings</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="kern" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_ot_math_kern_t from which to retrieve the kernings</doc>
          <type name="ot_math_kern_t" c:type="hb_ot_math_kern_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first kern entry to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="entries_count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of kern entries to return;
                                    Output = the actual number of kern entries returned</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="kern_entries" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">array of kern entries returned</doc>
          <array length="4" zero-terminated="0" c:type="hb_ot_math_kern_entry_t*">
            <type name="ot_math_kern_entry_t" c:type="hb_ot_math_kern_entry_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_math_get_glyph_top_accent_attachment" c:identifier="hb_ot_math_get_glyph_top_accent_attachment" version="1.3.3">
      <doc xml:space="preserve">Fetches a top-accent-attachment value (if one exists) for the specified
glyph index.

For any glyph that does not have a top-accent-attachment value - that is,
a glyph not covered by the `MathTopAccentAttachment` table (or, when
@font has no `MathTopAccentAttachment` table or no `MATH` table, any
glyph) - the function synthesizes a value, returning the position at
one-half the glyph's advance width.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the top accent attachment of the glyph or 0.5 * the advance
              width of @glyph</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph index from which to retrieve the value</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_math_get_glyph_variants" c:identifier="hb_ot_math_get_glyph_variants" version="1.3.3">
      <doc xml:space="preserve">Fetches the MathGlyphConstruction for the specified font, glyph index, and
direction. The corresponding list of size variants is returned as a list of
#hb_ot_math_glyph_variant_t structs.

&lt;note&gt;The @direction parameter is only used to select between horizontal
or vertical directions for the construction. Even though all #hb_direction_t
values are accepted, only the result of #HB_DIRECTION_IS_HORIZONTAL is
considered.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the total number of size variants available or zero</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The index of the glyph to stretch</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">The direction of the stretching (horizontal or vertical)</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first variant to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="variants_count" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = the maximum number of variants to return;
                          Output = the actual number of variants returned</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="variants" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">array of variants returned</doc>
          <array length="4" zero-terminated="0" c:type="hb_ot_math_glyph_variant_t*">
            <type name="ot_math_glyph_variant_t" c:type="hb_ot_math_glyph_variant_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_math_get_min_connector_overlap" c:identifier="hb_ot_math_get_min_connector_overlap" version="1.3.3">
      <doc xml:space="preserve">Fetches the MathVariants table for the specified font and returns the
minimum overlap of connecting glyphs that are required to draw a glyph
assembly in the specified direction.

&lt;note&gt;The @direction parameter is only used to select between horizontal
or vertical directions for the construction. Even though all #hb_direction_t
values are accepted, only the result of #HB_DIRECTION_IS_HORIZONTAL is
considered.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">requested minimum connector overlap or zero</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="direction" transfer-ownership="none">
          <doc xml:space="preserve">direction of the stretching (horizontal or vertical)</doc>
          <type name="direction_t" c:type="hb_direction_t"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="ot_math_glyph_part_flags_t" version="1.3.3" c:type="hb_ot_math_glyph_part_flags_t">
      <doc xml:space="preserve">Flags for math glyph parts.</doc>
      <member name="ot_math_glyph_part_flag_extender" value="1" c:identifier="HB_OT_MATH_GLYPH_PART_FLAG_EXTENDER">
        <doc xml:space="preserve">This is an extender glyph part that
can be repeated to reach the desired length.</doc>
      </member>
    </bitfield>
    <record name="ot_math_glyph_part_t" c:type="hb_ot_math_glyph_part_t" version="1.3.3" glib:type-name="hb_ot_math_glyph_part_t" glib:get-type="hb_gobject_ot_math_glyph_part_get_type" c:symbol-prefix="gobject_ot_math_glyph_part">
      <doc xml:space="preserve">Data type to hold information for a "part" component of a math-variant glyph.
Large variants for stretchable math glyphs (such as parentheses) can be constructed
on the fly from parts.</doc>
      <field name="glyph" writable="1">
        <doc xml:space="preserve">The glyph index of the variant part</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </field>
      <field name="start_connector_length" writable="1">
        <doc xml:space="preserve">The length of the connector on the starting side of the variant part</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="end_connector_length" writable="1">
        <doc xml:space="preserve">The length of the connector on the ending side of the variant part</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="full_advance" writable="1">
        <doc xml:space="preserve">The total advance of the part</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="flags" writable="1">
        <doc xml:space="preserve">#hb_ot_math_glyph_part_flags_t flags for the part</doc>
        <type name="ot_math_glyph_part_flags_t" c:type="hb_ot_math_glyph_part_flags_t"/>
      </field>
    </record>
    <record name="ot_math_glyph_variant_t" c:type="hb_ot_math_glyph_variant_t" version="1.3.3" glib:type-name="hb_ot_math_glyph_variant_t" glib:get-type="hb_gobject_ot_math_glyph_variant_get_type" c:symbol-prefix="gobject_ot_math_glyph_variant">
      <doc xml:space="preserve">Data type to hold math-variant information for a glyph.</doc>
      <field name="glyph" writable="1">
        <doc xml:space="preserve">The glyph index of the variant</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </field>
      <field name="advance" writable="1">
        <doc xml:space="preserve">The advance width of the variant</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
    </record>
    <function name="ot_math_has_data" c:identifier="hb_ot_math_has_data" version="1.3.3">
      <doc xml:space="preserve">Tests whether a face has a `MATH` table.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the table is found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to test</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_math_is_glyph_extended_shape" c:identifier="hb_ot_math_is_glyph_extended_shape" version="1.3.3">
      <doc xml:space="preserve">Tests whether the given glyph index is an extended shape in the face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the glyph is an extended shape, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">The glyph index to test</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="ot_math_kern_entry_t" c:type="hb_ot_math_kern_entry_t" version="3.4.0">
      <doc xml:space="preserve">Data type to hold math kerning (cut-in) information for a glyph.</doc>
      <field name="max_correction_height" writable="1">
        <doc xml:space="preserve">The maximum height at which this entry should be used</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
      <field name="kern_value" writable="1">
        <doc xml:space="preserve">The kern value of the entry</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </field>
    </record>
    <enumeration name="ot_math_kern_t" version="1.3.3" c:type="hb_ot_math_kern_t">
      <doc xml:space="preserve">The math kerning-table types defined for the four corners
of a glyph.</doc>
      <member name="top_right" value="0" c:identifier="HB_OT_MATH_KERN_TOP_RIGHT">
        <doc xml:space="preserve">The top right corner of the glyph.</doc>
      </member>
      <member name="top_left" value="1" c:identifier="HB_OT_MATH_KERN_TOP_LEFT">
        <doc xml:space="preserve">The top left corner of the glyph.</doc>
      </member>
      <member name="bottom_right" value="2" c:identifier="HB_OT_MATH_KERN_BOTTOM_RIGHT">
        <doc xml:space="preserve">The bottom right corner of the glyph.</doc>
      </member>
      <member name="bottom_left" value="3" c:identifier="HB_OT_MATH_KERN_BOTTOM_LEFT">
        <doc xml:space="preserve">The bottom left corner of the glyph.</doc>
      </member>
    </enumeration>
    <function name="ot_meta_get_entry_tags" c:identifier="hb_ot_meta_get_entry_tags" version="2.6.0">
      <doc xml:space="preserve">Fetches all available feature types.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Number of all available feature types.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">a face object</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">iteration's start offset</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="entries_count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">buffer size as input, filled size as output</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="entries" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">entries tags buffer</doc>
          <array length="2" zero-terminated="0" c:type="hb_ot_meta_tag_t*">
            <type name="ot_meta_tag_t" c:type="hb_ot_meta_tag_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_meta_reference_entry" c:identifier="hb_ot_meta_reference_entry" version="2.6.0">
      <doc xml:space="preserve">It fetches metadata entry of a given tag from a font.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">A blob containing the blob.</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">a #hb_face_t object.</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="meta_tag" transfer-ownership="none">
          <doc xml:space="preserve">tag of metadata you like to have.</doc>
          <type name="ot_meta_tag_t" c:type="hb_ot_meta_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="ot_meta_tag_t" version="2.6.0" c:type="hb_ot_meta_tag_t">
      <doc xml:space="preserve">Known metadata tags from https://docs.microsoft.com/en-us/typography/opentype/spec/meta</doc>
      <member name="b_ot_meta_tag_design_languages" value="1684827751" c:identifier="HB_OT_META_TAG_DESIGN_LANGUAGES">
        <doc xml:space="preserve">Design languages. Text, using only
Basic Latin (ASCII) characters. Indicates languages and/or scripts
for the user audiences that the font was primarily designed for.</doc>
      </member>
      <member name="b_ot_meta_tag_supported_languages" value="1936485991" c:identifier="HB_OT_META_TAG_SUPPORTED_LANGUAGES">
        <doc xml:space="preserve">Supported languages. Text, using
only Basic Latin (ASCII) characters. Indicates languages and/or scripts
that the font is declared to be capable of supporting.</doc>
      </member>
    </bitfield>
    <function name="ot_metrics_get_position" c:identifier="hb_ot_metrics_get_position" version="2.6.0">
      <doc xml:space="preserve">Fetches metrics value corresponding to @metrics_tag from @font.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Whether found the requested metrics in the font.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_font_t object.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="metrics_tag" transfer-ownership="none">
          <doc xml:space="preserve">tag of metrics value you like to fetch.</doc>
          <type name="ot_metrics_tag_t" c:type="hb_ot_metrics_tag_t"/>
        </parameter>
        <parameter name="position" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">result of metrics value from the font.</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_metrics_get_position_with_fallback" c:identifier="hb_ot_metrics_get_position_with_fallback" version="4.0.0">
      <doc xml:space="preserve">Fetches metrics value corresponding to @metrics_tag from @font,
and synthesizes a value if it the value is missing in the font.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_font_t object.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="metrics_tag" transfer-ownership="none">
          <doc xml:space="preserve">tag of metrics value you like to fetch.</doc>
          <type name="ot_metrics_tag_t" c:type="hb_ot_metrics_tag_t"/>
        </parameter>
        <parameter name="position" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">result of metrics value from the font.</doc>
          <type name="position_t" c:type="hb_position_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_metrics_get_variation" c:identifier="hb_ot_metrics_get_variation" version="2.6.0">
      <doc xml:space="preserve">Fetches metrics value corresponding to @metrics_tag from @font with the
current font variation settings applied.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The requested metric value.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_font_t object.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="metrics_tag" transfer-ownership="none">
          <doc xml:space="preserve">tag of metrics value you like to fetch.</doc>
          <type name="ot_metrics_tag_t" c:type="hb_ot_metrics_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_metrics_get_x_variation" c:identifier="hb_ot_metrics_get_x_variation" version="2.6.0">
      <doc xml:space="preserve">Fetches horizontal metrics value corresponding to @metrics_tag from @font
with the current font variation settings applied.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The requested metric value.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_font_t object.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="metrics_tag" transfer-ownership="none">
          <doc xml:space="preserve">tag of metrics value you like to fetch.</doc>
          <type name="ot_metrics_tag_t" c:type="hb_ot_metrics_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_metrics_get_y_variation" c:identifier="hb_ot_metrics_get_y_variation" version="2.6.0">
      <doc xml:space="preserve">Fetches vertical metrics value corresponding to @metrics_tag from @font with
the current font variation settings applied.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The requested metric value.</doc>
        <type name="position_t" c:type="hb_position_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_font_t object.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="metrics_tag" transfer-ownership="none">
          <doc xml:space="preserve">tag of metrics value you like to fetch.</doc>
          <type name="ot_metrics_tag_t" c:type="hb_ot_metrics_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="ot_metrics_tag_t" version="2.6.0" c:type="hb_ot_metrics_tag_t">
      <doc xml:space="preserve">Metric tags corresponding to [MVAR Value
Tags](https://docs.microsoft.com/en-us/typography/opentype/spec/mvar#value-tags)</doc>
      <member name="b_ot_metrics_tag_horizontal_ascender" value="1751216995" c:identifier="HB_OT_METRICS_TAG_HORIZONTAL_ASCENDER">
        <doc xml:space="preserve">horizontal ascender.</doc>
      </member>
      <member name="b_ot_metrics_tag_horizontal_descender" value="1751413603" c:identifier="HB_OT_METRICS_TAG_HORIZONTAL_DESCENDER">
        <doc xml:space="preserve">horizontal descender.</doc>
      </member>
      <member name="b_ot_metrics_tag_horizontal_line_gap" value="1751934832" c:identifier="HB_OT_METRICS_TAG_HORIZONTAL_LINE_GAP">
        <doc xml:space="preserve">horizontal line gap.</doc>
      </member>
      <member name="b_ot_metrics_tag_horizontal_clipping_ascent" value="1751346273" c:identifier="HB_OT_METRICS_TAG_HORIZONTAL_CLIPPING_ASCENT">
        <doc xml:space="preserve">horizontal clipping ascent.</doc>
      </member>
      <member name="b_ot_metrics_tag_horizontal_clipping_descent" value="1751346276" c:identifier="HB_OT_METRICS_TAG_HORIZONTAL_CLIPPING_DESCENT">
        <doc xml:space="preserve">horizontal clipping descent.</doc>
      </member>
      <member name="b_ot_metrics_tag_vertical_ascender" value="1986098019" c:identifier="HB_OT_METRICS_TAG_VERTICAL_ASCENDER">
        <doc xml:space="preserve">vertical ascender.</doc>
      </member>
      <member name="b_ot_metrics_tag_vertical_descender" value="1986294627" c:identifier="HB_OT_METRICS_TAG_VERTICAL_DESCENDER">
        <doc xml:space="preserve">vertical descender.</doc>
      </member>
      <member name="b_ot_metrics_tag_vertical_line_gap" value="1986815856" c:identifier="HB_OT_METRICS_TAG_VERTICAL_LINE_GAP">
        <doc xml:space="preserve">vertical line gap.</doc>
      </member>
      <member name="b_ot_metrics_tag_horizontal_caret_rise" value="1751347827" c:identifier="HB_OT_METRICS_TAG_HORIZONTAL_CARET_RISE">
        <doc xml:space="preserve">horizontal caret rise.</doc>
      </member>
      <member name="b_ot_metrics_tag_horizontal_caret_run" value="1751347822" c:identifier="HB_OT_METRICS_TAG_HORIZONTAL_CARET_RUN">
        <doc xml:space="preserve">horizontal caret run.</doc>
      </member>
      <member name="b_ot_metrics_tag_horizontal_caret_offset" value="1751347046" c:identifier="HB_OT_METRICS_TAG_HORIZONTAL_CARET_OFFSET">
        <doc xml:space="preserve">horizontal caret offset.</doc>
      </member>
      <member name="b_ot_metrics_tag_vertical_caret_rise" value="1986228851" c:identifier="HB_OT_METRICS_TAG_VERTICAL_CARET_RISE">
        <doc xml:space="preserve">vertical caret rise.</doc>
      </member>
      <member name="b_ot_metrics_tag_vertical_caret_run" value="1986228846" c:identifier="HB_OT_METRICS_TAG_VERTICAL_CARET_RUN">
        <doc xml:space="preserve">vertical caret run.</doc>
      </member>
      <member name="b_ot_metrics_tag_vertical_caret_offset" value="1986228070" c:identifier="HB_OT_METRICS_TAG_VERTICAL_CARET_OFFSET">
        <doc xml:space="preserve">vertical caret offset.</doc>
      </member>
      <member name="b_ot_metrics_tag_x_height" value="2020108148" c:identifier="HB_OT_METRICS_TAG_X_HEIGHT">
        <doc xml:space="preserve">x height.</doc>
      </member>
      <member name="b_ot_metrics_tag_cap_height" value="1668311156" c:identifier="HB_OT_METRICS_TAG_CAP_HEIGHT">
        <doc xml:space="preserve">cap height.</doc>
      </member>
      <member name="b_ot_metrics_tag_subscript_em_x_size" value="1935833203" c:identifier="HB_OT_METRICS_TAG_SUBSCRIPT_EM_X_SIZE">
        <doc xml:space="preserve">subscript em x size.</doc>
      </member>
      <member name="b_ot_metrics_tag_subscript_em_y_size" value="1935833459" c:identifier="HB_OT_METRICS_TAG_SUBSCRIPT_EM_Y_SIZE">
        <doc xml:space="preserve">subscript em y size.</doc>
      </member>
      <member name="b_ot_metrics_tag_subscript_em_x_offset" value="1935833199" c:identifier="HB_OT_METRICS_TAG_SUBSCRIPT_EM_X_OFFSET">
        <doc xml:space="preserve">subscript em x offset.</doc>
      </member>
      <member name="b_ot_metrics_tag_subscript_em_y_offset" value="1935833455" c:identifier="HB_OT_METRICS_TAG_SUBSCRIPT_EM_Y_OFFSET">
        <doc xml:space="preserve">subscript em y offset.</doc>
      </member>
      <member name="b_ot_metrics_tag_superscript_em_x_size" value="1936750707" c:identifier="HB_OT_METRICS_TAG_SUPERSCRIPT_EM_X_SIZE">
        <doc xml:space="preserve">superscript em x size.</doc>
      </member>
      <member name="b_ot_metrics_tag_superscript_em_y_size" value="1936750963" c:identifier="HB_OT_METRICS_TAG_SUPERSCRIPT_EM_Y_SIZE">
        <doc xml:space="preserve">superscript em y size.</doc>
      </member>
      <member name="b_ot_metrics_tag_superscript_em_x_offset" value="1936750703" c:identifier="HB_OT_METRICS_TAG_SUPERSCRIPT_EM_X_OFFSET">
        <doc xml:space="preserve">superscript em x offset.</doc>
      </member>
      <member name="b_ot_metrics_tag_superscript_em_y_offset" value="1936750959" c:identifier="HB_OT_METRICS_TAG_SUPERSCRIPT_EM_Y_OFFSET">
        <doc xml:space="preserve">superscript em y offset.</doc>
      </member>
      <member name="b_ot_metrics_tag_strikeout_size" value="1937011315" c:identifier="HB_OT_METRICS_TAG_STRIKEOUT_SIZE">
        <doc xml:space="preserve">strikeout size.</doc>
      </member>
      <member name="b_ot_metrics_tag_strikeout_offset" value="1937011311" c:identifier="HB_OT_METRICS_TAG_STRIKEOUT_OFFSET">
        <doc xml:space="preserve">strikeout offset.</doc>
      </member>
      <member name="b_ot_metrics_tag_underline_size" value="1970168947" c:identifier="HB_OT_METRICS_TAG_UNDERLINE_SIZE">
        <doc xml:space="preserve">underline size.</doc>
      </member>
      <member name="b_ot_metrics_tag_underline_offset" value="1970168943" c:identifier="HB_OT_METRICS_TAG_UNDERLINE_OFFSET">
        <doc xml:space="preserve">underline offset.</doc>
      </member>
    </bitfield>
    <record name="ot_name_entry_t" c:type="hb_ot_name_entry_t" version="2.1.0">
      <doc xml:space="preserve">Structure representing a name ID in a particular language.</doc>
      <field name="name_id" writable="1">
        <doc xml:space="preserve">name ID</doc>
        <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
      </field>
      <field name="var" readable="0" private="1">
        <type name="var_int_t" c:type="hb_var_int_t"/>
      </field>
      <field name="language" writable="1">
        <doc xml:space="preserve">language</doc>
        <type name="language_t" c:type="hb_language_t"/>
      </field>
    </record>
    <function name="ot_name_get_utf16" c:identifier="hb_ot_name_get_utf16" version="2.1.0">
      <doc xml:space="preserve">Fetches a font name from the OpenType 'name' table.
If @language is #HB_LANGUAGE_INVALID, English ("en") is assumed.
Returns string in UTF-16 encoding. A NUL terminator is always written
for convenience, and isn't included in the output @text_size.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">full length of the requested string, or 0 if not found.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">font face.</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="name_id" transfer-ownership="none">
          <doc xml:space="preserve">OpenType name identifier to fetch.</doc>
          <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
        </parameter>
        <parameter name="language" transfer-ownership="none">
          <doc xml:space="preserve">language to fetch the name for.</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
        <parameter name="text_size" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">input size of @text buffer, and output size of
                                  text written to buffer.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="text" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">buffer to write fetched name into.</doc>
          <array length="3" zero-terminated="0" c:type="uint16_t*">
            <type name="guint16" c:type="uint16_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_name_get_utf32" c:identifier="hb_ot_name_get_utf32" version="2.1.0">
      <doc xml:space="preserve">Fetches a font name from the OpenType 'name' table.
If @language is #HB_LANGUAGE_INVALID, English ("en") is assumed.
Returns string in UTF-32 encoding. A NUL terminator is always written
for convenience, and isn't included in the output @text_size.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">full length of the requested string, or 0 if not found.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">font face.</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="name_id" transfer-ownership="none">
          <doc xml:space="preserve">OpenType name identifier to fetch.</doc>
          <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
        </parameter>
        <parameter name="language" transfer-ownership="none">
          <doc xml:space="preserve">language to fetch the name for.</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
        <parameter name="text_size" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">input size of @text buffer, and output size of
                                  text written to buffer.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="text" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">buffer to write fetched name into.</doc>
          <array length="3" zero-terminated="0" c:type="uint32_t*">
            <type name="guint32" c:type="uint32_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_name_get_utf8" c:identifier="hb_ot_name_get_utf8" version="2.1.0">
      <doc xml:space="preserve">Fetches a font name from the OpenType 'name' table.
If @language is #HB_LANGUAGE_INVALID, English ("en") is assumed.
Returns string in UTF-8 encoding. A NUL terminator is always written
for convenience, and isn't included in the output @text_size.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">full length of the requested string, or 0 if not found.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">font face.</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="name_id" transfer-ownership="none">
          <doc xml:space="preserve">OpenType name identifier to fetch.</doc>
          <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
        </parameter>
        <parameter name="language" transfer-ownership="none">
          <doc xml:space="preserve">language to fetch the name for.</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
        <parameter name="text_size" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">input size of @text buffer, and output size of
                                  text written to buffer.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="text" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">buffer to write fetched name into.</doc>
          <array length="3" zero-terminated="0" c:type="char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <enumeration name="ot_name_id_predefined_t" version="7.0.0" c:type="hb_ot_name_id_predefined_t">
      <doc xml:space="preserve">An enum type representing the pre-defined name IDs.

For more information on these fields, see the
[OpenType spec](https://docs.microsoft.com/en-us/typography/opentype/spec/name#name-ids).</doc>
      <member name="copyright" value="0" c:identifier="HB_OT_NAME_ID_COPYRIGHT">
        <doc xml:space="preserve">Copyright notice</doc>
      </member>
      <member name="font_family" value="1" c:identifier="HB_OT_NAME_ID_FONT_FAMILY">
        <doc xml:space="preserve">Font Family name</doc>
      </member>
      <member name="font_subfamily" value="2" c:identifier="HB_OT_NAME_ID_FONT_SUBFAMILY">
        <doc xml:space="preserve">Font Subfamily name</doc>
      </member>
      <member name="unique_id" value="3" c:identifier="HB_OT_NAME_ID_UNIQUE_ID">
        <doc xml:space="preserve">Unique font identifier</doc>
      </member>
      <member name="full_name" value="4" c:identifier="HB_OT_NAME_ID_FULL_NAME">
        <doc xml:space="preserve">Full font name that reflects
all family and relevant subfamily descriptors</doc>
      </member>
      <member name="version_string" value="5" c:identifier="HB_OT_NAME_ID_VERSION_STRING">
        <doc xml:space="preserve">Version string</doc>
      </member>
      <member name="postscript_name" value="6" c:identifier="HB_OT_NAME_ID_POSTSCRIPT_NAME">
        <doc xml:space="preserve">PostScript name for the font</doc>
      </member>
      <member name="trademark" value="7" c:identifier="HB_OT_NAME_ID_TRADEMARK">
        <doc xml:space="preserve">Trademark</doc>
      </member>
      <member name="manufacturer" value="8" c:identifier="HB_OT_NAME_ID_MANUFACTURER">
        <doc xml:space="preserve">Manufacturer Name</doc>
      </member>
      <member name="designer" value="9" c:identifier="HB_OT_NAME_ID_DESIGNER">
        <doc xml:space="preserve">Designer</doc>
      </member>
      <member name="description" value="10" c:identifier="HB_OT_NAME_ID_DESCRIPTION">
        <doc xml:space="preserve">Description</doc>
      </member>
      <member name="vendor_url" value="11" c:identifier="HB_OT_NAME_ID_VENDOR_URL">
        <doc xml:space="preserve">URL of font vendor</doc>
      </member>
      <member name="designer_url" value="12" c:identifier="HB_OT_NAME_ID_DESIGNER_URL">
        <doc xml:space="preserve">URL of typeface designer</doc>
      </member>
      <member name="license" value="13" c:identifier="HB_OT_NAME_ID_LICENSE">
        <doc xml:space="preserve">License Description</doc>
      </member>
      <member name="license_url" value="14" c:identifier="HB_OT_NAME_ID_LICENSE_URL">
        <doc xml:space="preserve">URL where additional licensing
information can be found</doc>
      </member>
      <member name="typographic_family" value="16" c:identifier="HB_OT_NAME_ID_TYPOGRAPHIC_FAMILY">
        <doc xml:space="preserve">Typographic Family name</doc>
      </member>
      <member name="typographic_subfamily" value="17" c:identifier="HB_OT_NAME_ID_TYPOGRAPHIC_SUBFAMILY">
        <doc xml:space="preserve">Typographic Subfamily name</doc>
      </member>
      <member name="mac_full_name" value="18" c:identifier="HB_OT_NAME_ID_MAC_FULL_NAME">
        <doc xml:space="preserve">Compatible Full Name for MacOS</doc>
      </member>
      <member name="sample_text" value="19" c:identifier="HB_OT_NAME_ID_SAMPLE_TEXT">
        <doc xml:space="preserve">Sample text</doc>
      </member>
      <member name="cid_findfont_name" value="20" c:identifier="HB_OT_NAME_ID_CID_FINDFONT_NAME">
        <doc xml:space="preserve">PostScript CID findfont name</doc>
      </member>
      <member name="wws_family" value="21" c:identifier="HB_OT_NAME_ID_WWS_FAMILY">
        <doc xml:space="preserve">WWS Family Name</doc>
      </member>
      <member name="wws_subfamily" value="22" c:identifier="HB_OT_NAME_ID_WWS_SUBFAMILY">
        <doc xml:space="preserve">WWS Subfamily Name</doc>
      </member>
      <member name="light_background" value="23" c:identifier="HB_OT_NAME_ID_LIGHT_BACKGROUND">
        <doc xml:space="preserve">Light Background Palette</doc>
      </member>
      <member name="dark_background" value="24" c:identifier="HB_OT_NAME_ID_DARK_BACKGROUND">
        <doc xml:space="preserve">Dark Background Palette</doc>
      </member>
      <member name="variations_ps_prefix" value="25" c:identifier="HB_OT_NAME_ID_VARIATIONS_PS_PREFIX">
        <doc xml:space="preserve">Variations PostScript Name Prefix</doc>
      </member>
      <member name="invalid" value="65535" c:identifier="HB_OT_NAME_ID_INVALID">
        <doc xml:space="preserve">Value to represent a nonexistent name ID.</doc>
      </member>
    </enumeration>
    <function name="ot_name_list_names" c:identifier="hb_ot_name_list_names" version="2.1.0">
      <doc xml:space="preserve">Enumerates all available name IDs and language combinations. Returned
array is owned by the @face and should not be modified.  It can be
used as long as @face is alive.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Array of available name entries.</doc>
        <array length="1" zero-terminated="0" c:type="const hb_ot_name_entry_t*">
          <type name="ot_name_entry_t" c:type="hb_ot_name_entry_t"/>
        </array>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">font face.</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="num_entries" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">number of returned entries.</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_shape_glyphs_closure" c:identifier="hb_ot_shape_glyphs_closure" version="0.9.2">
      <doc xml:space="preserve">Computes the transitive closure of glyphs needed for a specified
input buffer under the given font and feature list. The closure is
computed as a set, not as a list.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">#hb_font_t to work upon</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">The input buffer to compute from</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="features" transfer-ownership="none">
          <doc xml:space="preserve">The features enabled on the buffer</doc>
          <array length="3" zero-terminated="0" c:type="const hb_feature_t*">
            <type name="feature_t" c:type="hb_feature_t"/>
          </array>
        </parameter>
        <parameter name="num_features" transfer-ownership="none">
          <doc xml:space="preserve">The number of features enabled on the buffer</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="glyphs" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_set_t set of glyphs comprising the transitive closure of the query</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_shape_plan_collect_lookups" c:identifier="hb_ot_shape_plan_collect_lookups" version="0.9.7">
      <doc xml:space="preserve">Computes the complete set of GSUB or GPOS lookups that are applicable
under a given @shape_plan.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="shape_plan" transfer-ownership="none">
          <doc xml:space="preserve">#hb_shape_plan_t to query</doc>
          <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
        </parameter>
        <parameter name="table_tag" transfer-ownership="none">
          <doc xml:space="preserve">GSUB or GPOS</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="lookup_indexes" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_set_t set of lookups returned</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_shape_plan_get_feature_tags" c:identifier="hb_ot_shape_plan_get_feature_tags" version="10.3.0">
      <doc xml:space="preserve">Fetches the list of OpenType feature tags enabled for a shaping plan, if possible.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Total number of feature tagss.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="shape_plan" transfer-ownership="none">
          <doc xml:space="preserve">A shaping plan</doc>
          <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">The index of first feature to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="tag_count" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = the maximum number of features to return;
                     Output = the actual number of features returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="tags" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of enabled feature</doc>
          <array length="2" zero-terminated="0" c:type="hb_tag_t*">
            <type name="tag_t" c:type="hb_tag_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_tag_from_language" c:identifier="hb_ot_tag_from_language" version="0.6.0" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Converts an #hb_language_t to an #hb_tag_t.</doc>
      <doc-deprecated xml:space="preserve">use hb_ot_tags_from_script_and_language() instead</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="tag_t" c:type="hb_tag_t"/>
      </return-value>
      <parameters>
        <parameter name="language" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_language_t to convert.</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_tag_to_language" c:identifier="hb_ot_tag_to_language" version="0.9.2">
      <doc xml:space="preserve">Converts a language tag to an #hb_language_t.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">
The #hb_language_t corresponding to @tag.</doc>
        <type name="language_t" c:type="hb_language_t"/>
      </return-value>
      <parameters>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:space="preserve">an language tag</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_tag_to_script" c:identifier="hb_ot_tag_to_script">
      <doc xml:space="preserve">Converts a script tag to an #hb_script_t.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_script_t corresponding to @tag.</doc>
        <type name="script_t" c:type="hb_script_t"/>
      </return-value>
      <parameters>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:space="preserve">a script tag</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_tags_from_script" c:identifier="hb_ot_tags_from_script" version="0.6.0" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Converts an #hb_script_t to script tags.</doc>
      <doc-deprecated xml:space="preserve">use hb_ot_tags_from_script_and_language() instead</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_script_t to convert.</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
        <parameter name="script_tag_1" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">output #hb_tag_t.</doc>
          <type name="tag_t" c:type="hb_tag_t*"/>
        </parameter>
        <parameter name="script_tag_2" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">output #hb_tag_t.</doc>
          <type name="tag_t" c:type="hb_tag_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_tags_from_script_and_language" c:identifier="hb_ot_tags_from_script_and_language" version="2.0.0">
      <doc xml:space="preserve">Converts an #hb_script_t and an #hb_language_t to script and language tags.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_script_t to convert.</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
        <parameter name="language" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">an #hb_language_t to convert.</doc>
          <type name="language_t" c:type="hb_language_t"/>
        </parameter>
        <parameter name="script_count" direction="inout" caller-allocates="0" transfer-ownership="full" optional="1">
          <doc xml:space="preserve">maximum number of script tags to retrieve (IN)
and actual number of script tags retrieved (OUT)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="script_tags" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">array of size at least @script_count to store the
script tag results</doc>
          <type name="tag_t" c:type="hb_tag_t*"/>
        </parameter>
        <parameter name="language_count" direction="inout" caller-allocates="0" transfer-ownership="full" optional="1">
          <doc xml:space="preserve">maximum number of language tags to retrieve
(IN) and actual number of language tags retrieved (OUT)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="language_tags" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">array of size at least @language_count to store
the language tag results</doc>
          <type name="tag_t" c:type="hb_tag_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_tags_to_script_and_language" c:identifier="hb_ot_tags_to_script_and_language" version="2.0.0">
      <doc xml:space="preserve">Converts a script tag and a language tag to an #hb_script_t and an
#hb_language_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="script_tag" transfer-ownership="none">
          <doc xml:space="preserve">a script tag</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="language_tag" transfer-ownership="none">
          <doc xml:space="preserve">a language tag</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="script" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">the #hb_script_t corresponding to @script_tag.</doc>
          <type name="script_t" c:type="hb_script_t*"/>
        </parameter>
        <parameter name="language" direction="out" caller-allocates="1" transfer-ownership="none" optional="1" allow-none="1">
          <doc xml:space="preserve">the #hb_language_t corresponding to @script_tag and
@language_tag.</doc>
          <type name="language_t" c:type="hb_language_t*"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="ot_var_axis_flags_t" version="2.2.0" c:type="hb_ot_var_axis_flags_t">
      <doc xml:space="preserve">Flags for #hb_ot_var_axis_info_t.</doc>
      <member name="b_ot_var_axis_flag_hidden" value="1" c:identifier="HB_OT_VAR_AXIS_FLAG_HIDDEN">
        <doc xml:space="preserve">The axis should not be exposed directly in user interfaces.</doc>
      </member>
    </bitfield>
    <record name="ot_var_axis_info_t" c:type="hb_ot_var_axis_info_t" version="2.2.0" glib:type-name="hb_ot_var_axis_info_t" glib:get-type="hb_gobject_ot_var_axis_info_get_type" c:symbol-prefix="gobject_ot_var_axis_info">
      <doc xml:space="preserve">Data type for holding variation-axis values.

The minimum, default, and maximum values are in un-normalized, user scales.

&lt;note&gt;Note: at present, the only flag defined for @flags is
#HB_OT_VAR_AXIS_FLAG_HIDDEN.&lt;/note&gt;</doc>
      <field name="axis_index" writable="1">
        <doc xml:space="preserve">Index of the axis in the variation-axis array</doc>
        <type name="guint" c:type="unsigned int"/>
      </field>
      <field name="tag" writable="1">
        <doc xml:space="preserve">The #hb_tag_t tag identifying the design variation of the axis</doc>
        <type name="tag_t" c:type="hb_tag_t"/>
      </field>
      <field name="name_id" writable="1">
        <doc xml:space="preserve">The `name` table Name ID that provides display names for the axis</doc>
        <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
      </field>
      <field name="flags" writable="1">
        <doc xml:space="preserve">The #hb_ot_var_axis_flags_t flags for the axis</doc>
        <type name="ot_var_axis_flags_t" c:type="hb_ot_var_axis_flags_t"/>
      </field>
      <field name="min_value" writable="1">
        <doc xml:space="preserve">The minimum value on the variation axis that the font covers</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="default_value" writable="1">
        <doc xml:space="preserve">The position on the variation axis corresponding to the font's defaults</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="max_value" writable="1">
        <doc xml:space="preserve">The maximum value on the variation axis that the font covers</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="reserved" readable="0" private="1">
        <type name="guint" c:type="unsigned int"/>
      </field>
    </record>
    <record name="ot_var_axis_t" c:type="hb_ot_var_axis_t" version="1.4.2" deprecated="1" deprecated-version="2.2.0">
      <doc xml:space="preserve">Use #hb_ot_var_axis_info_t instead.</doc>
      <field name="tag" writable="1">
        <doc xml:space="preserve">axis tag</doc>
        <type name="tag_t" c:type="hb_tag_t"/>
      </field>
      <field name="name_id" writable="1">
        <doc xml:space="preserve">axis name identifier</doc>
        <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
      </field>
      <field name="min_value" writable="1">
        <doc xml:space="preserve">minimum value of the axis</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="default_value" writable="1">
        <doc xml:space="preserve">default value of the axis</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="max_value" writable="1">
        <doc xml:space="preserve">maximum value of the axis</doc>
        <type name="gfloat" c:type="float"/>
      </field>
    </record>
    <function name="ot_var_find_axis" c:identifier="hb_ot_var_find_axis" version="1.4.2" deprecated="1" deprecated-version="2.2.0">
      <doc xml:space="preserve">Fetches the variation-axis information corresponding to the specified axis tag
in the specified face.</doc>
      <doc-deprecated xml:space="preserve">use hb_ot_var_find_axis_info() instead</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="axis_tag" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_tag_t of the variation axis to query</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="axis_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the variation axis</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="axis_info" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_ot_var_axis_info_t of the axis tag queried</doc>
          <type name="ot_var_axis_t" c:type="hb_ot_var_axis_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_find_axis_info" c:identifier="hb_ot_var_find_axis_info" version="2.2.0">
      <doc xml:space="preserve">Fetches the variation-axis information corresponding to the specified axis tag
in the specified face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="axis_tag" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_tag_t of the variation axis to query</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="axis_info" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_ot_var_axis_info_t of the axis tag queried</doc>
          <type name="ot_var_axis_info_t" c:type="hb_ot_var_axis_info_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_get_axes" c:identifier="hb_ot_var_get_axes" version="1.4.2" deprecated="1" deprecated-version="2.2.0">
      <doc xml:space="preserve">Fetches a list of all variation axes in the specified face. The list returned will begin
at the offset provided.</doc>
      <doc-deprecated xml:space="preserve">use hb_ot_var_get_axis_infos() instead</doc-deprecated>
      <return-value transfer-ownership="none">
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first lookup to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="axes_count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of variation axes to return;
               Output = the actual number of variation axes returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="axes_array" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The array of variation axes found</doc>
          <array length="2" zero-terminated="0" c:type="hb_ot_var_axis_t*">
            <type name="ot_var_axis_t" c:type="hb_ot_var_axis_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_get_axis_count" c:identifier="hb_ot_var_get_axis_count" version="1.4.2">
      <doc xml:space="preserve">Fetches the number of OpenType variation axes included in the face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the number of variation axes defined</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_get_axis_infos" c:identifier="hb_ot_var_get_axis_infos" version="2.2.0">
      <doc xml:space="preserve">Fetches a list of all variation axes in the specified face. The list returned will begin
at the offset provided.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the number of variation axes in the face</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to work upon</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="start_offset" transfer-ownership="none">
          <doc xml:space="preserve">offset of the first lookup to retrieve</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="axes_count" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of variation axes to return;
               Output = the actual number of variation axes returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="axes_array" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">The array of variation axes found</doc>
          <array length="2" zero-terminated="0" c:type="hb_ot_var_axis_info_t*">
            <type name="ot_var_axis_info_t" c:type="hb_ot_var_axis_info_t"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_get_named_instance_count" c:identifier="hb_ot_var_get_named_instance_count" version="2.2.0">
      <doc xml:space="preserve">Fetches the number of named instances included in the face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the number of named instances defined</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_has_data" c:identifier="hb_ot_var_has_data" version="1.4.2">
      <doc xml:space="preserve">Tests whether a face includes any OpenType variation data in the `fvar` table.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if data found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_named_instance_get_design_coords" c:identifier="hb_ot_var_named_instance_get_design_coords" version="2.2.0">
      <doc xml:space="preserve">Fetches the design-space coordinates corresponding to the given
named instance in the face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the number of variation axes in the face</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="instance_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the named instance to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="coords_length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
          <doc xml:space="preserve">Input = the maximum number of coordinates to return;
                Output = the actual number of coordinates returned (may be zero)</doc>
          <type name="guint" c:type="unsigned int*"/>
        </parameter>
        <parameter name="coords" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of coordinates found for the query</doc>
          <array length="2" zero-terminated="0" c:type="float*">
            <type name="gfloat" c:type="float"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_named_instance_get_postscript_name_id" c:identifier="hb_ot_var_named_instance_get_postscript_name_id" version="2.2.0">
      <doc xml:space="preserve">Fetches the `name` table Name ID that provides display names for
the "PostScript name" defined for the given named instance in the face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the Name ID found for the PostScript name</doc>
        <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="instance_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the named instance to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_named_instance_get_subfamily_name_id" c:identifier="hb_ot_var_named_instance_get_subfamily_name_id" version="2.2.0">
      <doc xml:space="preserve">Fetches the `name` table Name ID that provides display names for
the "Subfamily name" defined for the given named instance in the face.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the Name ID found for the Subfamily name</doc>
        <type name="ot_name_id_t" c:type="hb_ot_name_id_t"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="instance_index" transfer-ownership="none">
          <doc xml:space="preserve">The index of the named instance to query</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_normalize_coords" c:identifier="hb_ot_var_normalize_coords" version="1.4.2">
      <doc xml:space="preserve">Normalizes the given design-space coordinates. The minimum and maximum
values for the axis are mapped to the interval [-1,1], with the default
axis value mapped to 0.

The normalized values have 14 bits of fixed-point sub-integer precision as per
OpenType specification.

Any additional scaling defined in the face's `avar` table is also
applied, as described at https://docs.microsoft.com/en-us/typography/opentype/spec/avar

Note: @coords_length must be the same as the number of axes in the face, as
for example returned by hb_ot_var_get_axis_count().
Otherwise, the behavior is undefined.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="coords_length" transfer-ownership="none">
          <doc xml:space="preserve">The length of the coordinate array</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="design_coords" transfer-ownership="none">
          <doc xml:space="preserve">The design-space coordinates to normalize</doc>
          <type name="gfloat" c:type="const float*"/>
        </parameter>
        <parameter name="normalized_coords" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The normalized coordinates</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="ot_var_normalize_variations" c:identifier="hb_ot_var_normalize_variations" version="1.4.2">
      <doc xml:space="preserve">Normalizes all of the coordinates in the given list of variation axes.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_face_t to work on</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="variations" transfer-ownership="none">
          <doc xml:space="preserve">The array of variations to normalize</doc>
          <type name="variation_t" c:type="const hb_variation_t*"/>
        </parameter>
        <parameter name="variations_length" transfer-ownership="none">
          <doc xml:space="preserve">The number of variations to normalize</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="coords" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The array of normalized coordinates</doc>
          <array length="4" zero-terminated="0" c:type="int*">
            <type name="gint" c:type="int"/>
          </array>
        </parameter>
        <parameter name="coords_length" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The length of the coordinate array</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_color" c:identifier="hb_paint_color" version="7.0.0">
      <doc xml:space="preserve">Perform a "color" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="is_foreground" transfer-ownership="none">
          <doc xml:space="preserve">whether the color is the foreground</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
        <parameter name="color" transfer-ownership="none">
          <doc xml:space="preserve">The color to use</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_color_func_t" c:type="hb_paint_color_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to paint a
color everywhere within the current clip.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="is_foreground" transfer-ownership="none">
          <doc xml:space="preserve">whether the color is the foreground</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
        <parameter name="color" transfer-ownership="none">
          <doc xml:space="preserve">The color to use, unpremultiplied</doc>
          <type name="color_t" c:type="hb_color_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_color_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_color_glyph" c:identifier="hb_paint_color_glyph" version="8.2.0">
      <doc xml:space="preserve">Perform a "color-glyph" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">the glyph ID</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">the font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_color_glyph_func_t" c:type="hb_paint_color_glyph_func_t" version="8.2.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to render a color glyph by glyph index.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the glyph was painted, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">the glyph ID</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">the font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_color_glyph_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <enumeration name="paint_composite_mode_t" version="7.0.0" c:type="hb_paint_composite_mode_t">
      <doc xml:space="preserve">The values of this enumeration describe the compositing modes
that can be used when combining temporary redirected drawing
with the backdrop.

See the OpenType spec [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr)
section for details.</doc>
      <member name="clear" value="0" c:identifier="HB_PAINT_COMPOSITE_MODE_CLEAR">
        <doc xml:space="preserve">clear destination layer (bounded)</doc>
      </member>
      <member name="src" value="1" c:identifier="HB_PAINT_COMPOSITE_MODE_SRC">
        <doc xml:space="preserve">replace destination layer (bounded)</doc>
      </member>
      <member name="dest" value="2" c:identifier="HB_PAINT_COMPOSITE_MODE_DEST">
        <doc xml:space="preserve">ignore the source</doc>
      </member>
      <member name="src_over" value="3" c:identifier="HB_PAINT_COMPOSITE_MODE_SRC_OVER">
        <doc xml:space="preserve">draw source layer on top of destination layer
(bounded)</doc>
      </member>
      <member name="dest_over" value="4" c:identifier="HB_PAINT_COMPOSITE_MODE_DEST_OVER">
        <doc xml:space="preserve">draw destination on top of source</doc>
      </member>
      <member name="src_in" value="5" c:identifier="HB_PAINT_COMPOSITE_MODE_SRC_IN">
        <doc xml:space="preserve">draw source where there was destination content
(unbounded)</doc>
      </member>
      <member name="dest_in" value="6" c:identifier="HB_PAINT_COMPOSITE_MODE_DEST_IN">
        <doc xml:space="preserve">leave destination only where there was
source content (unbounded)</doc>
      </member>
      <member name="src_out" value="7" c:identifier="HB_PAINT_COMPOSITE_MODE_SRC_OUT">
        <doc xml:space="preserve">draw source where there was no destination
content (unbounded)</doc>
      </member>
      <member name="dest_out" value="8" c:identifier="HB_PAINT_COMPOSITE_MODE_DEST_OUT">
        <doc xml:space="preserve">leave destination only where there was no
source content</doc>
      </member>
      <member name="src_atop" value="9" c:identifier="HB_PAINT_COMPOSITE_MODE_SRC_ATOP">
        <doc xml:space="preserve">draw source on top of destination content and
only there</doc>
      </member>
      <member name="dest_atop" value="10" c:identifier="HB_PAINT_COMPOSITE_MODE_DEST_ATOP">
        <doc xml:space="preserve">leave destination on top of source content
and only there (unbounded)</doc>
      </member>
      <member name="xor" value="11" c:identifier="HB_PAINT_COMPOSITE_MODE_XOR">
        <doc xml:space="preserve">source and destination are shown where there is only
one of them</doc>
      </member>
      <member name="plus" value="12" c:identifier="HB_PAINT_COMPOSITE_MODE_PLUS">
        <doc xml:space="preserve">source and destination layers are accumulated</doc>
      </member>
      <member name="screen" value="13" c:identifier="HB_PAINT_COMPOSITE_MODE_SCREEN">
        <doc xml:space="preserve">source and destination are complemented and
multiplied. This causes the result to be at least as light as the lighter
inputs.</doc>
      </member>
      <member name="overlay" value="14" c:identifier="HB_PAINT_COMPOSITE_MODE_OVERLAY">
        <doc xml:space="preserve">multiplies or screens, depending on the
lightness of the destination color.</doc>
      </member>
      <member name="darken" value="15" c:identifier="HB_PAINT_COMPOSITE_MODE_DARKEN">
        <doc xml:space="preserve">replaces the destination with the source if it
is darker, otherwise keeps the source.</doc>
      </member>
      <member name="lighten" value="16" c:identifier="HB_PAINT_COMPOSITE_MODE_LIGHTEN">
        <doc xml:space="preserve">replaces the destination with the source if it
is lighter, otherwise keeps the source.</doc>
      </member>
      <member name="color_dodge" value="17" c:identifier="HB_PAINT_COMPOSITE_MODE_COLOR_DODGE">
        <doc xml:space="preserve">brightens the destination color to reflect
the source color.</doc>
      </member>
      <member name="color_burn" value="18" c:identifier="HB_PAINT_COMPOSITE_MODE_COLOR_BURN">
        <doc xml:space="preserve">darkens the destination color to reflect
the source color.</doc>
      </member>
      <member name="hard_light" value="19" c:identifier="HB_PAINT_COMPOSITE_MODE_HARD_LIGHT">
        <doc xml:space="preserve">Multiplies or screens, dependent on source
color.</doc>
      </member>
      <member name="soft_light" value="20" c:identifier="HB_PAINT_COMPOSITE_MODE_SOFT_LIGHT">
        <doc xml:space="preserve">Darkens or lightens, dependent on source
color.</doc>
      </member>
      <member name="difference" value="21" c:identifier="HB_PAINT_COMPOSITE_MODE_DIFFERENCE">
        <doc xml:space="preserve">Takes the difference of the source and
destination color.</doc>
      </member>
      <member name="exclusion" value="22" c:identifier="HB_PAINT_COMPOSITE_MODE_EXCLUSION">
        <doc xml:space="preserve">Produces an effect similar to difference, but
with lower contrast.</doc>
      </member>
      <member name="multiply" value="23" c:identifier="HB_PAINT_COMPOSITE_MODE_MULTIPLY">
        <doc xml:space="preserve">source and destination layers are multiplied.
This causes the result to be at least as dark as the darker inputs.</doc>
      </member>
      <member name="hsl_hue" value="24" c:identifier="HB_PAINT_COMPOSITE_MODE_HSL_HUE">
        <doc xml:space="preserve">Creates a color with the hue of the source
and the saturation and luminosity of the target.</doc>
      </member>
      <member name="hsl_saturation" value="25" c:identifier="HB_PAINT_COMPOSITE_MODE_HSL_SATURATION">
        <doc xml:space="preserve">Creates a color with the saturation
of the source and the hue and luminosity of the target. Painting with
this mode onto a gray area produces no change.</doc>
      </member>
      <member name="hsl_color" value="26" c:identifier="HB_PAINT_COMPOSITE_MODE_HSL_COLOR">
        <doc xml:space="preserve">Creates a color with the hue and saturation
of the source and the luminosity of the target. This preserves the gray
levels of the target and is useful for coloring monochrome images or
tinting color images.</doc>
      </member>
      <member name="hsl_luminosity" value="27" c:identifier="HB_PAINT_COMPOSITE_MODE_HSL_LUMINOSITY">
        <doc xml:space="preserve">Creates a color with the luminosity of
the source and the hue and saturation of the target. This produces an
inverse effect to @HB_PAINT_COMPOSITE_MODE_HSL_COLOR.</doc>
      </member>
    </enumeration>
    <function name="paint_custom_palette_color" c:identifier="hb_paint_custom_palette_color" version="7.0.0">
      <doc xml:space="preserve">Gets the custom palette color for @color_index.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="color_index" transfer-ownership="none">
          <doc xml:space="preserve">color index</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="color" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">fetched color</doc>
          <type name="color_t" c:type="hb_color_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_custom_palette_color_func_t" c:type="hb_paint_custom_palette_color_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to fetch a color from the custom
color palette.

Custom palette colors override the colors from the fonts selected color
palette. It is not necessary to override all palette entries; for entries
that should be taken from the font palette, return `false`.

This function might get called multiple times, but the custom palette is
expected to remain unchanged for duration of a hb_font_paint_glyph() call.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if found, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="color_index" transfer-ownership="none">
          <doc xml:space="preserve">the color index</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="color" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">fetched color</doc>
          <type name="color_t" c:type="hb_color_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_pop_group_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <enumeration name="paint_extend_t" version="7.0.0" c:type="hb_paint_extend_t">
      <doc xml:space="preserve">The values of this enumeration determine how color values
outside the minimum and maximum defined offset on a #hb_color_line_t
are determined.

See the OpenType spec [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr)
section for details.</doc>
      <member name="pad" value="0" c:identifier="HB_PAINT_EXTEND_PAD">
        <doc xml:space="preserve">Outside the defined interval,
  the color of the closest color stop is used.</doc>
      </member>
      <member name="repeat" value="1" c:identifier="HB_PAINT_EXTEND_REPEAT">
        <doc xml:space="preserve">The color line is repeated over
  repeated multiples of the defined interval</doc>
      </member>
      <member name="reflect" value="2" c:identifier="HB_PAINT_EXTEND_REFLECT">
        <doc xml:space="preserve">The color line is repeated over
     repeated intervals, as for the repeat mode.
     However, in each repeated interval, the ordering of
     color stops is the reverse of the adjacent interval.</doc>
      </member>
    </enumeration>
    <function name="paint_funcs_create" c:identifier="hb_paint_funcs_create" version="7.0.0">
      <doc xml:space="preserve">Creates a new #hb_paint_funcs_t structure of paint functions.

The initial reference count of 1 should be released with hb_paint_funcs_destroy()
when you are done using the #hb_paint_funcs_t. This function never returns
`NULL`. If memory cannot be allocated, a special singleton #hb_paint_funcs_t
object will be returned.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">the paint-functions structure</doc>
        <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
      </return-value>
    </function>
    <function name="paint_funcs_destroy" c:identifier="hb_paint_funcs_destroy" version="7.0.0" introspectable="0">
      <doc xml:space="preserve">Decreases the reference count on a paint-functions structure.

When the reference count reaches zero, the structure
is destroyed, freeing all memory.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">The paint-functions structure</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_get_empty" c:identifier="hb_paint_funcs_get_empty" version="7.0.0">
      <doc xml:space="preserve">Fetches the singleton empty paint-functions structure.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty paint-functions structure</doc>
        <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
      </return-value>
    </function>
    <function name="paint_funcs_get_user_data" c:identifier="hb_paint_funcs_get_user_data" version="7.0.0" introspectable="0">
      <doc xml:space="preserve">Fetches the user-data associated with the specified key,
attached to the specified paint-functions structure.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">The paint-functions structure</doc>
          <type name="paint_funcs_t" c:type="const hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_is_immutable" c:identifier="hb_paint_funcs_is_immutable" version="7.0.0">
      <doc xml:space="preserve">Tests whether a paint-functions structure is immutable.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @funcs is immutable, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">The paint-functions structure</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_make_immutable" c:identifier="hb_paint_funcs_make_immutable" version="7.0.0">
      <doc xml:space="preserve">Makes a paint-functions structure immutable.

After this call, all attempts to set one of the callbacks
on @funcs will fail.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">The paint-functions structure</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_reference" c:identifier="hb_paint_funcs_reference" version="7.0.0" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on a paint-functions structure.

This prevents @funcs from being destroyed until a matching
call to hb_paint_funcs_destroy() is made.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The paint-functions structure</doc>
        <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">The paint-functions structure</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_color_func" c:identifier="hb_paint_funcs_set_color_func" version="7.0.0">
      <doc xml:space="preserve">Sets the paint-color callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The paint-color callback</doc>
          <type name="paint_color_func_t" c:type="hb_paint_color_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_color_glyph_func" c:identifier="hb_paint_funcs_set_color_glyph_func" version="8.2.0">
      <doc xml:space="preserve">Sets the color-glyph callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The color-glyph callback</doc>
          <type name="paint_color_glyph_func_t" c:type="hb_paint_color_glyph_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_custom_palette_color_func" c:identifier="hb_paint_funcs_set_custom_palette_color_func" version="7.0.0">
      <doc xml:space="preserve">Sets the custom-palette-color callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The custom-palette-color callback</doc>
          <type name="paint_custom_palette_color_func_t" c:type="hb_paint_custom_palette_color_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_image_func" c:identifier="hb_paint_funcs_set_image_func" version="7.0.0">
      <doc xml:space="preserve">Sets the paint-image callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The paint-image callback</doc>
          <type name="paint_image_func_t" c:type="hb_paint_image_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_linear_gradient_func" c:identifier="hb_paint_funcs_set_linear_gradient_func" version="7.0.0">
      <doc xml:space="preserve">Sets the linear-gradient callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The linear-gradient callback</doc>
          <type name="paint_linear_gradient_func_t" c:type="hb_paint_linear_gradient_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_pop_clip_func" c:identifier="hb_paint_funcs_set_pop_clip_func" version="7.0.0">
      <doc xml:space="preserve">Sets the pop-clip callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The pop-clip callback</doc>
          <type name="paint_pop_clip_func_t" c:type="hb_paint_pop_clip_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_pop_group_func" c:identifier="hb_paint_funcs_set_pop_group_func" version="7.0.0">
      <doc xml:space="preserve">Sets the pop-group callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The pop-group callback</doc>
          <type name="paint_pop_group_func_t" c:type="hb_paint_pop_group_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_pop_transform_func" c:identifier="hb_paint_funcs_set_pop_transform_func" version="7.0.0">
      <doc xml:space="preserve">Sets the pop-transform callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The pop-transform callback</doc>
          <type name="paint_pop_transform_func_t" c:type="hb_paint_pop_transform_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_push_clip_glyph_func" c:identifier="hb_paint_funcs_set_push_clip_glyph_func" version="7.0.0">
      <doc xml:space="preserve">Sets the push-clip-glyph callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The push-clip-glyph callback</doc>
          <type name="paint_push_clip_glyph_func_t" c:type="hb_paint_push_clip_glyph_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_push_clip_rectangle_func" c:identifier="hb_paint_funcs_set_push_clip_rectangle_func" version="7.0.0">
      <doc xml:space="preserve">Sets the push-clip-rect callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The push-clip-rectangle callback</doc>
          <type name="paint_push_clip_rectangle_func_t" c:type="hb_paint_push_clip_rectangle_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_push_group_func" c:identifier="hb_paint_funcs_set_push_group_func" version="7.0.0">
      <doc xml:space="preserve">Sets the push-group callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The push-group callback</doc>
          <type name="paint_push_group_func_t" c:type="hb_paint_push_group_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_push_transform_func" c:identifier="hb_paint_funcs_set_push_transform_func" version="7.0.0">
      <doc xml:space="preserve">Sets the push-transform callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The push-transform callback</doc>
          <type name="paint_push_transform_func_t" c:type="hb_paint_push_transform_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_radial_gradient_func" c:identifier="hb_paint_funcs_set_radial_gradient_func" version="7.0.0">
      <doc xml:space="preserve">Sets the radial-gradient callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The radial-gradient callback</doc>
          <type name="paint_radial_gradient_func_t" c:type="hb_paint_radial_gradient_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_sweep_gradient_func" c:identifier="hb_paint_funcs_set_sweep_gradient_func" version="7.0.0">
      <doc xml:space="preserve">Sets the sweep-gradient callback on the paint functions struct.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">A paint functions struct</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The sweep-gradient callback</doc>
          <type name="paint_sweep_gradient_func_t" c:type="hb_paint_sweep_gradient_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">Function to call when @user_data is no longer needed</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_funcs_set_user_data" c:identifier="hb_paint_funcs_set_user_data" version="7.0.0" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the specified paint-functions structure.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">The paint-functions structure</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="paint_funcs_t" c:type="hb_paint_funcs_t" opaque="1" version="7.0.0" glib:type-name="hb_paint_funcs_t" glib:get-type="hb_gobject_paint_funcs_get_type" c:symbol-prefix="gobject_paint_funcs">
      <doc xml:space="preserve">Glyph paint callbacks.

The callbacks assume that the caller maintains a stack
of current transforms, clips and intermediate surfaces,
as evidenced by the pairs of push/pop callbacks. The
push/pop calls will be properly nested, so it is fine
to store the different kinds of object on a single stack.

Not all callbacks are required for all kinds of glyphs.
For rendering COLRv0 or non-color outline glyphs, the
gradient callbacks are not needed, and the composite
callback only needs to handle simple alpha compositing
(#HB_PAINT_COMPOSITE_MODE_SRC_OVER).

The paint-image callback is only needed for glyphs
with image blobs in the CBDT, sbix or SVG tables.

The custom-palette-color callback is only necessary if
you want to override colors from the font palette with
custom colors.</doc>
    </record>
    <function name="paint_image" c:identifier="hb_paint_image" version="7.0.0">
      <doc xml:space="preserve">Perform a "image" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="image" transfer-ownership="none">
          <doc xml:space="preserve">image data</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="width" transfer-ownership="none">
          <doc xml:space="preserve">width of the raster image in pixels, or 0</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="height" transfer-ownership="none">
          <doc xml:space="preserve">height of the raster image in pixels, or 0</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="format" transfer-ownership="none">
          <doc xml:space="preserve">the image format as a tag</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="slant" transfer-ownership="none">
          <doc xml:space="preserve">Deprecated. set to 0.0</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="extents" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">the extents of the glyph</doc>
          <type name="glyph_extents_t" c:type="hb_glyph_extents_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_image_func_t" c:type="hb_paint_image_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to paint a glyph image.

This method is called for glyphs with image blobs in the CBDT,
sbix or SVG tables. The @format identifies the kind of data that
is contained in @image. Possible values include #HB_PAINT_IMAGE_FORMAT_PNG,
#HB_PAINT_IMAGE_FORMAT_SVG and #HB_PAINT_IMAGE_FORMAT_BGRA.

The image dimensions and glyph extents are provided if available,
and should be used to size and position the image.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Whether the operation was successful.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="image" transfer-ownership="none">
          <doc xml:space="preserve">the image data</doc>
          <type name="blob_t" c:type="hb_blob_t*"/>
        </parameter>
        <parameter name="width" transfer-ownership="none">
          <doc xml:space="preserve">width of the raster image in pixels, or 0</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="height" transfer-ownership="none">
          <doc xml:space="preserve">height of the raster image in pixels, or 0</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="format" transfer-ownership="none">
          <doc xml:space="preserve">the image format as a tag</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="slant" transfer-ownership="none">
          <doc xml:space="preserve">Deprecated. Always set to 0.0.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="extents" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">glyph extents for desired rendering</doc>
          <type name="glyph_extents_t" c:type="hb_glyph_extents_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="8">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_image_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_linear_gradient" c:identifier="hb_paint_linear_gradient" version="7.0.0">
      <doc xml:space="preserve">Perform a "linear-gradient" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">Color information for the gradient</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
        <parameter name="x0" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the first point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y0" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the first point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="x1" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the second point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y1" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the second point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="x2" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the third point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y2" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the third point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_linear_gradient_func_t" c:type="hb_paint_linear_gradient_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to paint a linear
gradient everywhere within the current clip.

The @color_line object contains information about the colors of the gradients.
It is only valid for the duration of the callback, you cannot keep it around.

The coordinates of the points are interpreted according
to the current transform.

See the OpenType spec [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr)
section for details on how the points define the direction
of the gradient, and how to interpret the @color_line.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">Color information for the gradient</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
        <parameter name="x0" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the first point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y0" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the first point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="x1" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the second point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y1" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the second point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="x2" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the third point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y2" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the third point</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="9">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_linear_gradient_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_pop_clip" c:identifier="hb_paint_pop_clip" version="7.0.0">
      <doc xml:space="preserve">Perform a "pop-clip" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_pop_clip_func_t" c:type="hb_paint_pop_clip_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to undo
the effect of a prior call to the #hb_paint_funcs_push_clip_glyph_func_t
or #hb_paint_funcs_push_clip_rectangle_func_t vfuncs.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_pop_clip_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_pop_group" c:identifier="hb_paint_pop_group" version="7.0.0">
      <doc xml:space="preserve">Perform a "pop-group" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="mode" transfer-ownership="none">
          <doc xml:space="preserve">the compositing mode to use</doc>
          <type name="paint_composite_mode_t" c:type="hb_paint_composite_mode_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_pop_group_func_t" c:type="hb_paint_pop_group_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to undo
the effect of a prior call to the #hb_paint_funcs_push_group_func_t
vfunc.

This call stops the redirection to the intermediate surface,
and then composites it on the previous surface, using the
compositing mode passed to this call.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="mode" transfer-ownership="none">
          <doc xml:space="preserve">the compositing mode to use</doc>
          <type name="paint_composite_mode_t" c:type="hb_paint_composite_mode_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_pop_group_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_pop_transform" c:identifier="hb_paint_pop_transform" version="7.0.0">
      <doc xml:space="preserve">Perform a "pop-transform" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_pop_transform_func_t" c:type="hb_paint_pop_transform_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to undo
the effect of a prior call to the #hb_paint_funcs_push_transform_func_t
vfunc.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_pop_transform_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_push_clip_glyph" c:identifier="hb_paint_push_clip_glyph" version="7.0.0">
      <doc xml:space="preserve">Perform a "push-clip-glyph" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">the glyph ID</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">the font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_push_clip_glyph_func_t" c:type="hb_paint_push_clip_glyph_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to clip
subsequent paint calls to the outline of a glyph.

The coordinates of the glyph outline are expected in the
current @font scale (ie. the results of calling
hb_font_draw_glyph() with @font). The outline is
transformed by the current transform.

This clip is applied in addition to the current clip,
and remains in effect until a matching call to
the #hb_paint_funcs_pop_clip_func_t vfunc.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="glyph" transfer-ownership="none">
          <doc xml:space="preserve">the glyph ID</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">the font</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_push_clip_glyph_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_push_clip_rectangle" c:identifier="hb_paint_push_clip_rectangle" version="7.0.0">
      <doc xml:space="preserve">Perform a "push-clip-rect" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="xmin" transfer-ownership="none">
          <doc xml:space="preserve">min X for the rectangle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="ymin" transfer-ownership="none">
          <doc xml:space="preserve">min Y for the rectangle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="xmax" transfer-ownership="none">
          <doc xml:space="preserve">max X for the rectangle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="ymax" transfer-ownership="none">
          <doc xml:space="preserve">max Y for the rectangle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_push_clip_rectangle_func_t" c:type="hb_paint_push_clip_rectangle_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to clip
subsequent paint calls to a rectangle.

The coordinates of the rectangle are interpreted according
to the current transform.

This clip is applied in addition to the current clip,
and remains in effect until a matching call to
the #hb_paint_funcs_pop_clip_func_t vfunc.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="xmin" transfer-ownership="none">
          <doc xml:space="preserve">min X for the rectangle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="ymin" transfer-ownership="none">
          <doc xml:space="preserve">min Y for the rectangle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="xmax" transfer-ownership="none">
          <doc xml:space="preserve">max X for the rectangle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="ymax" transfer-ownership="none">
          <doc xml:space="preserve">max Y for the rectangle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_push_clip_rectangle_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_push_font_transform" c:identifier="hb_paint_push_font_transform" version="11.0.0">
      <doc xml:space="preserve">Push the transform reflecting the font's scale and slant
settings onto the paint functions.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font</doc>
          <type name="font_t" c:type="const hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_push_group" c:identifier="hb_paint_push_group" version="7.0.0">
      <doc xml:space="preserve">Perform a "push-group" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_push_group_func_t" c:type="hb_paint_push_group_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to use
an intermediate surface for subsequent paint calls.

The drawing will be redirected to an intermediate surface
until a matching call to the #hb_paint_funcs_pop_group_func_t
vfunc.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_push_group_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_push_inverse_font_transform" c:identifier="hb_paint_push_inverse_font_transform" version="11.0.0">
      <doc xml:space="preserve">Push the inverse of the transform reflecting the font's
scale and slant settings onto the paint functions.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a font</doc>
          <type name="font_t" c:type="const hb_font_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="paint_push_transform" c:identifier="hb_paint_push_transform" version="7.0.0">
      <doc xml:space="preserve">Perform a "push-transform" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="xx" transfer-ownership="none">
          <doc xml:space="preserve">xx component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="yx" transfer-ownership="none">
          <doc xml:space="preserve">yx component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="xy" transfer-ownership="none">
          <doc xml:space="preserve">xy component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="yy" transfer-ownership="none">
          <doc xml:space="preserve">yy component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="dx" transfer-ownership="none">
          <doc xml:space="preserve">dx component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="dy" transfer-ownership="none">
          <doc xml:space="preserve">dy component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_push_transform_func_t" c:type="hb_paint_push_transform_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to apply
a transform to subsequent paint calls.

This transform is applied after the current transform,
and remains in effect until a matching call to
the #hb_paint_funcs_pop_transform_func_t vfunc.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="xx" transfer-ownership="none">
          <doc xml:space="preserve">xx component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="yx" transfer-ownership="none">
          <doc xml:space="preserve">yx component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="xy" transfer-ownership="none">
          <doc xml:space="preserve">xy component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="yy" transfer-ownership="none">
          <doc xml:space="preserve">yy component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="dx" transfer-ownership="none">
          <doc xml:space="preserve">dx component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="dy" transfer-ownership="none">
          <doc xml:space="preserve">dy component of the transform matrix</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="8">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_push_transform_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_radial_gradient" c:identifier="hb_paint_radial_gradient" version="7.0.0">
      <doc xml:space="preserve">Perform a "radial-gradient" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">Color information for the gradient</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
        <parameter name="x0" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the first circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y0" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the first circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="r0" transfer-ownership="none">
          <doc xml:space="preserve">radius of the first circle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="x1" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the second circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y1" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the second circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="r1" transfer-ownership="none">
          <doc xml:space="preserve">radius of the second circle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_radial_gradient_func_t" c:type="hb_paint_radial_gradient_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to paint a radial
gradient everywhere within the current clip.

The @color_line object contains information about the colors of the gradients.
It is only valid for the duration of the callback, you cannot keep it around.

The coordinates of the points are interpreted according
to the current transform.

See the OpenType spec [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr)
section for details on how the points define the direction
of the gradient, and how to interpret the @color_line.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">Color information for the gradient</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
        <parameter name="x0" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the first circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y0" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the first circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="r0" transfer-ownership="none">
          <doc xml:space="preserve">radius of the first circle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="x1" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the second circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y1" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the second circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="r1" transfer-ownership="none">
          <doc xml:space="preserve">radius of the second circle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="9">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_radial_gradient_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="paint_sweep_gradient" c:identifier="hb_paint_sweep_gradient" version="7.0.0">
      <doc xml:space="preserve">Perform a "sweep-gradient" paint operation.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">associated data passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">Color information for the gradient</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
        <parameter name="x0" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y0" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="start_angle" transfer-ownership="none">
          <doc xml:space="preserve">the start angle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="end_angle" transfer-ownership="none">
          <doc xml:space="preserve">the end angle</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <callback name="paint_sweep_gradient_func_t" c:type="hb_paint_sweep_gradient_func_t" version="7.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_paint_funcs_t to paint a sweep
gradient everywhere within the current clip.

The @color_line object contains information about the colors of the gradients.
It is only valid for the duration of the callback, you cannot keep it around.

The coordinates of the points are interpreted according
to the current transform.

See the OpenType spec [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr)
section for details on how the points define the direction
of the gradient, and how to interpret the @color_line.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="funcs" transfer-ownership="none">
          <doc xml:space="preserve">paint functions object</doc>
          <type name="paint_funcs_t" c:type="hb_paint_funcs_t*"/>
        </parameter>
        <parameter name="paint_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The data accompanying the paint functions in hb_font_paint_glyph()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="color_line" transfer-ownership="none">
          <doc xml:space="preserve">Color information for the gradient</doc>
          <type name="color_line_t" c:type="hb_color_line_t*"/>
        </parameter>
        <parameter name="x0" transfer-ownership="none">
          <doc xml:space="preserve">X coordinate of the circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="y0" transfer-ownership="none">
          <doc xml:space="preserve">Y coordinate of the circle's center</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="start_angle" transfer-ownership="none">
          <doc xml:space="preserve">the start angle, in radians</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="end_angle" transfer-ownership="none">
          <doc xml:space="preserve">the end angle, in radians</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
          <doc xml:space="preserve">User data pointer passed to hb_paint_funcs_set_sweep_gradient_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="realloc" c:identifier="hb_realloc" version="11.0.0">
      <doc xml:space="preserve">Reallocates the memory pointed to by @ptr to @size bytes, using the
allocator set at compile-time. Typically just realloc().</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the reallocated memory.</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="ptr" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">The pointer to the memory to reallocate.</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="size" transfer-ownership="none">
          <doc xml:space="preserve">The new size of the memory.</doc>
          <type name="gsize" c:type="size_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="reference_table_func_t" c:type="hb_reference_table_func_t" version="0.9.2">
      <doc xml:space="preserve">Callback function for hb_face_create_for_tables(). The @tag is the tag of the
table to reference, and the special tag #HB_TAG_NONE is used to reference the
blob of the face itself. If referencing the face blob is not possible, it is
recommended to set hb_get_table_tags_func_t on the @face to allow
hb_face_reference_blob() to create a face blob out of individual table blobs.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">A pointer to the @tag table within @face or
`NULL` if the table is not found or cannot be referenced.</doc>
        <type name="blob_t" c:type="hb_blob_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_face_t to reference table for</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:space="preserve">the tag of the table to reference</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="script_from_iso15924_tag" c:identifier="hb_script_from_iso15924_tag" version="0.9.2">
      <doc xml:space="preserve">Converts an ISO 15924 script tag to a corresponding #hb_script_t.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">An #hb_script_t corresponding to the ISO 15924 tag.</doc>
        <type name="script_t" c:type="hb_script_t"/>
      </return-value>
      <parameters>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_tag_t representing an ISO 15924 tag.</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="script_from_string" c:identifier="hb_script_from_string" version="0.9.2">
      <doc xml:space="preserve">Converts a string @str representing an ISO 15924 script tag to a
corresponding #hb_script_t. Shorthand for hb_tag_from_string() then
hb_script_from_iso15924_tag().</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">An #hb_script_t corresponding to the ISO 15924 tag.</doc>
        <type name="script_t" c:type="hb_script_t"/>
      </return-value>
      <parameters>
        <parameter name="str" transfer-ownership="none">
          <doc xml:space="preserve">a string representing an
      ISO 15924 tag.</doc>
          <array length="1" zero-terminated="0" c:type="const char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">length of the @str, or -1 if it is `NULL`-terminated.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="script_get_horizontal_direction" c:identifier="hb_script_get_horizontal_direction" version="0.9.2">
      <doc xml:space="preserve">Fetches the #hb_direction_t of a script when it is
set horizontally. All right-to-left scripts will return
#HB_DIRECTION_RTL. All left-to-right scripts will return
#HB_DIRECTION_LTR.

Scripts that can be written either right-to-left or
left-to-right will return #HB_DIRECTION_INVALID.

Unknown scripts will return #HB_DIRECTION_LTR.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The horizontal #hb_direction_t of @script</doc>
        <type name="direction_t" c:type="hb_direction_t"/>
      </return-value>
      <parameters>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_script_t to query</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="script_t" c:type="hb_script_t">
      <doc xml:space="preserve">Data type for scripts. Each #hb_script_t's value is an #hb_tag_t corresponding
to the four-letter values defined by [ISO 15924](https://unicode.org/iso15924/).

See also the Script (sc) property of the Unicode Character Database.</doc>
      <member name="b_script_common" value="1517910393" c:identifier="HB_SCRIPT_COMMON">
        <doc xml:space="preserve">`Zyyy`</doc>
      </member>
      <member name="b_script_inherited" value="1516858984" c:identifier="HB_SCRIPT_INHERITED">
        <doc xml:space="preserve">`Zinh`</doc>
      </member>
      <member name="b_script_unknown" value="1517976186" c:identifier="HB_SCRIPT_UNKNOWN">
        <doc xml:space="preserve">`Zzzz`</doc>
      </member>
      <member name="b_script_arabic" value="1098015074" c:identifier="HB_SCRIPT_ARABIC">
        <doc xml:space="preserve">`Arab`</doc>
      </member>
      <member name="b_script_armenian" value="1098018158" c:identifier="HB_SCRIPT_ARMENIAN">
        <doc xml:space="preserve">`Armn`</doc>
      </member>
      <member name="b_script_bengali" value="1113943655" c:identifier="HB_SCRIPT_BENGALI">
        <doc xml:space="preserve">`Beng`</doc>
      </member>
      <member name="b_script_cyrillic" value="1132032620" c:identifier="HB_SCRIPT_CYRILLIC">
        <doc xml:space="preserve">`Cyrl`</doc>
      </member>
      <member name="b_script_devanagari" value="1147500129" c:identifier="HB_SCRIPT_DEVANAGARI">
        <doc xml:space="preserve">`Deva`</doc>
      </member>
      <member name="b_script_georgian" value="1197830002" c:identifier="HB_SCRIPT_GEORGIAN">
        <doc xml:space="preserve">`Geor`</doc>
      </member>
      <member name="b_script_greek" value="1198679403" c:identifier="HB_SCRIPT_GREEK">
        <doc xml:space="preserve">`Grek`</doc>
      </member>
      <member name="b_script_gujarati" value="1198877298" c:identifier="HB_SCRIPT_GUJARATI">
        <doc xml:space="preserve">`Gujr`</doc>
      </member>
      <member name="b_script_gurmukhi" value="1198879349" c:identifier="HB_SCRIPT_GURMUKHI">
        <doc xml:space="preserve">`Guru`</doc>
      </member>
      <member name="b_script_hangul" value="1214344807" c:identifier="HB_SCRIPT_HANGUL">
        <doc xml:space="preserve">`Hang`</doc>
      </member>
      <member name="b_script_han" value="1214344809" c:identifier="HB_SCRIPT_HAN">
        <doc xml:space="preserve">`Hani`</doc>
      </member>
      <member name="b_script_hebrew" value="1214603890" c:identifier="HB_SCRIPT_HEBREW">
        <doc xml:space="preserve">`Hebr`</doc>
      </member>
      <member name="b_script_hiragana" value="1214870113" c:identifier="HB_SCRIPT_HIRAGANA">
        <doc xml:space="preserve">`Hira`</doc>
      </member>
      <member name="b_script_kannada" value="1265525857" c:identifier="HB_SCRIPT_KANNADA">
        <doc xml:space="preserve">`Knda`</doc>
      </member>
      <member name="b_script_katakana" value="1264676449" c:identifier="HB_SCRIPT_KATAKANA">
        <doc xml:space="preserve">`Kana`</doc>
      </member>
      <member name="b_script_lao" value="1281453935" c:identifier="HB_SCRIPT_LAO">
        <doc xml:space="preserve">`Laoo`</doc>
      </member>
      <member name="b_script_latin" value="1281455214" c:identifier="HB_SCRIPT_LATIN">
        <doc xml:space="preserve">`Latn`</doc>
      </member>
      <member name="b_script_malayalam" value="1298954605" c:identifier="HB_SCRIPT_MALAYALAM">
        <doc xml:space="preserve">`Mlym`</doc>
      </member>
      <member name="b_script_oriya" value="1332902241" c:identifier="HB_SCRIPT_ORIYA">
        <doc xml:space="preserve">`Orya`</doc>
      </member>
      <member name="b_script_tamil" value="1415671148" c:identifier="HB_SCRIPT_TAMIL">
        <doc xml:space="preserve">`Taml`</doc>
      </member>
      <member name="b_script_telugu" value="1415933045" c:identifier="HB_SCRIPT_TELUGU">
        <doc xml:space="preserve">`Telu`</doc>
      </member>
      <member name="b_script_thai" value="1416126825" c:identifier="HB_SCRIPT_THAI">
        <doc xml:space="preserve">`Thai`</doc>
      </member>
      <member name="b_script_tibetan" value="1416192628" c:identifier="HB_SCRIPT_TIBETAN">
        <doc xml:space="preserve">`Tibt`</doc>
      </member>
      <member name="b_script_bopomofo" value="1114599535" c:identifier="HB_SCRIPT_BOPOMOFO">
        <doc xml:space="preserve">`Bopo`</doc>
      </member>
      <member name="b_script_braille" value="1114792297" c:identifier="HB_SCRIPT_BRAILLE">
        <doc xml:space="preserve">`Brai`</doc>
      </member>
      <member name="b_script_canadian_syllabics" value="1130458739" c:identifier="HB_SCRIPT_CANADIAN_SYLLABICS">
        <doc xml:space="preserve">`Cans`</doc>
      </member>
      <member name="b_script_cherokee" value="1130915186" c:identifier="HB_SCRIPT_CHEROKEE">
        <doc xml:space="preserve">`Cher`</doc>
      </member>
      <member name="b_script_ethiopic" value="1165256809" c:identifier="HB_SCRIPT_ETHIOPIC">
        <doc xml:space="preserve">`Ethi`</doc>
      </member>
      <member name="b_script_khmer" value="1265134962" c:identifier="HB_SCRIPT_KHMER">
        <doc xml:space="preserve">`Khmr`</doc>
      </member>
      <member name="b_script_mongolian" value="1299148391" c:identifier="HB_SCRIPT_MONGOLIAN">
        <doc xml:space="preserve">`Mong`</doc>
      </member>
      <member name="b_script_myanmar" value="1299803506" c:identifier="HB_SCRIPT_MYANMAR">
        <doc xml:space="preserve">`Mymr`</doc>
      </member>
      <member name="b_script_ogham" value="1332175213" c:identifier="HB_SCRIPT_OGHAM">
        <doc xml:space="preserve">`Ogam`</doc>
      </member>
      <member name="b_script_runic" value="1383427698" c:identifier="HB_SCRIPT_RUNIC">
        <doc xml:space="preserve">`Runr`</doc>
      </member>
      <member name="b_script_sinhala" value="1399418472" c:identifier="HB_SCRIPT_SINHALA">
        <doc xml:space="preserve">`Sinh`</doc>
      </member>
      <member name="b_script_syriac" value="1400468067" c:identifier="HB_SCRIPT_SYRIAC">
        <doc xml:space="preserve">`Syrc`</doc>
      </member>
      <member name="b_script_thaana" value="1416126817" c:identifier="HB_SCRIPT_THAANA">
        <doc xml:space="preserve">`Thaa`</doc>
      </member>
      <member name="b_script_yi" value="1500080489" c:identifier="HB_SCRIPT_YI">
        <doc xml:space="preserve">`Yiii`</doc>
      </member>
      <member name="b_script_deseret" value="1148416628" c:identifier="HB_SCRIPT_DESERET">
        <doc xml:space="preserve">`Dsrt`</doc>
      </member>
      <member name="b_script_gothic" value="1198486632" c:identifier="HB_SCRIPT_GOTHIC">
        <doc xml:space="preserve">`Goth`</doc>
      </member>
      <member name="b_script_old_italic" value="1232363884" c:identifier="HB_SCRIPT_OLD_ITALIC">
        <doc xml:space="preserve">`Ital`</doc>
      </member>
      <member name="b_script_buhid" value="1114990692" c:identifier="HB_SCRIPT_BUHID">
        <doc xml:space="preserve">`Buhd`</doc>
      </member>
      <member name="b_script_hanunoo" value="1214344815" c:identifier="HB_SCRIPT_HANUNOO">
        <doc xml:space="preserve">`Hano`</doc>
      </member>
      <member name="b_script_tagalog" value="1416064103" c:identifier="HB_SCRIPT_TAGALOG">
        <doc xml:space="preserve">`Tglg`</doc>
      </member>
      <member name="b_script_tagbanwa" value="1415669602" c:identifier="HB_SCRIPT_TAGBANWA">
        <doc xml:space="preserve">`Tagb`</doc>
      </member>
      <member name="b_script_cypriot" value="1131442804" c:identifier="HB_SCRIPT_CYPRIOT">
        <doc xml:space="preserve">`Cprt`</doc>
      </member>
      <member name="b_script_limbu" value="1281977698" c:identifier="HB_SCRIPT_LIMBU">
        <doc xml:space="preserve">`Limb`</doc>
      </member>
      <member name="b_script_linear_b" value="1281977954" c:identifier="HB_SCRIPT_LINEAR_B">
        <doc xml:space="preserve">`Linb`</doc>
      </member>
      <member name="b_script_osmanya" value="1332964705" c:identifier="HB_SCRIPT_OSMANYA">
        <doc xml:space="preserve">`Osma`</doc>
      </member>
      <member name="b_script_shavian" value="1399349623" c:identifier="HB_SCRIPT_SHAVIAN">
        <doc xml:space="preserve">`Shaw`</doc>
      </member>
      <member name="b_script_tai_le" value="1415670885" c:identifier="HB_SCRIPT_TAI_LE">
        <doc xml:space="preserve">`Tale`</doc>
      </member>
      <member name="b_script_ugaritic" value="1432838514" c:identifier="HB_SCRIPT_UGARITIC">
        <doc xml:space="preserve">`Ugar`</doc>
      </member>
      <member name="b_script_buginese" value="1114990441" c:identifier="HB_SCRIPT_BUGINESE">
        <doc xml:space="preserve">`Bugi`</doc>
      </member>
      <member name="b_script_coptic" value="1131376756" c:identifier="HB_SCRIPT_COPTIC">
        <doc xml:space="preserve">`Copt`</doc>
      </member>
      <member name="b_script_glagolitic" value="1198285159" c:identifier="HB_SCRIPT_GLAGOLITIC">
        <doc xml:space="preserve">`Glag`</doc>
      </member>
      <member name="b_script_kharoshthi" value="1265131890" c:identifier="HB_SCRIPT_KHAROSHTHI">
        <doc xml:space="preserve">`Khar`</doc>
      </member>
      <member name="b_script_new_tai_lue" value="1415670901" c:identifier="HB_SCRIPT_NEW_TAI_LUE">
        <doc xml:space="preserve">`Talu`</doc>
      </member>
      <member name="b_script_old_persian" value="1483761007" c:identifier="HB_SCRIPT_OLD_PERSIAN">
        <doc xml:space="preserve">`Xpeo`</doc>
      </member>
      <member name="b_script_syloti_nagri" value="1400466543" c:identifier="HB_SCRIPT_SYLOTI_NAGRI">
        <doc xml:space="preserve">`Sylo`</doc>
      </member>
      <member name="b_script_tifinagh" value="1415999079" c:identifier="HB_SCRIPT_TIFINAGH">
        <doc xml:space="preserve">`Tfng`</doc>
      </member>
      <member name="b_script_balinese" value="1113681001" c:identifier="HB_SCRIPT_BALINESE">
        <doc xml:space="preserve">`Bali`</doc>
      </member>
      <member name="b_script_cuneiform" value="1483961720" c:identifier="HB_SCRIPT_CUNEIFORM">
        <doc xml:space="preserve">`Xsux`</doc>
      </member>
      <member name="b_script_nko" value="1315663727" c:identifier="HB_SCRIPT_NKO">
        <doc xml:space="preserve">`Nkoo`</doc>
      </member>
      <member name="b_script_phags_pa" value="1349017959" c:identifier="HB_SCRIPT_PHAGS_PA">
        <doc xml:space="preserve">`Phag`</doc>
      </member>
      <member name="b_script_phoenician" value="1349021304" c:identifier="HB_SCRIPT_PHOENICIAN">
        <doc xml:space="preserve">`Phnx`</doc>
      </member>
      <member name="b_script_carian" value="1130459753" c:identifier="HB_SCRIPT_CARIAN">
        <doc xml:space="preserve">`Cari`</doc>
      </member>
      <member name="b_script_cham" value="1130914157" c:identifier="HB_SCRIPT_CHAM">
        <doc xml:space="preserve">`Cham`</doc>
      </member>
      <member name="b_script_kayah_li" value="1264675945" c:identifier="HB_SCRIPT_KAYAH_LI">
        <doc xml:space="preserve">`Kali`</doc>
      </member>
      <member name="b_script_lepcha" value="1281716323" c:identifier="HB_SCRIPT_LEPCHA">
        <doc xml:space="preserve">`Lepc`</doc>
      </member>
      <member name="b_script_lycian" value="1283023721" c:identifier="HB_SCRIPT_LYCIAN">
        <doc xml:space="preserve">`Lyci`</doc>
      </member>
      <member name="b_script_lydian" value="1283023977" c:identifier="HB_SCRIPT_LYDIAN">
        <doc xml:space="preserve">`Lydi`</doc>
      </member>
      <member name="b_script_ol_chiki" value="1332503403" c:identifier="HB_SCRIPT_OL_CHIKI">
        <doc xml:space="preserve">`Olck`</doc>
      </member>
      <member name="b_script_rejang" value="1382706791" c:identifier="HB_SCRIPT_REJANG">
        <doc xml:space="preserve">`Rjng`</doc>
      </member>
      <member name="b_script_saurashtra" value="1398895986" c:identifier="HB_SCRIPT_SAURASHTRA">
        <doc xml:space="preserve">`Saur`</doc>
      </member>
      <member name="b_script_sundanese" value="1400204900" c:identifier="HB_SCRIPT_SUNDANESE">
        <doc xml:space="preserve">`Sund`</doc>
      </member>
      <member name="b_script_vai" value="1449224553" c:identifier="HB_SCRIPT_VAI">
        <doc xml:space="preserve">`Vaii`</doc>
      </member>
      <member name="b_script_avestan" value="1098281844" c:identifier="HB_SCRIPT_AVESTAN">
        <doc xml:space="preserve">`Avst`</doc>
      </member>
      <member name="b_script_bamum" value="1113681269" c:identifier="HB_SCRIPT_BAMUM">
        <doc xml:space="preserve">`Bamu`</doc>
      </member>
      <member name="b_script_egyptian_hieroglyphs" value="1164409200" c:identifier="HB_SCRIPT_EGYPTIAN_HIEROGLYPHS">
        <doc xml:space="preserve">`Egyp`</doc>
      </member>
      <member name="b_script_imperial_aramaic" value="1098018153" c:identifier="HB_SCRIPT_IMPERIAL_ARAMAIC">
        <doc xml:space="preserve">`Armi`</doc>
      </member>
      <member name="b_script_inscriptional_pahlavi" value="1349020777" c:identifier="HB_SCRIPT_INSCRIPTIONAL_PAHLAVI">
        <doc xml:space="preserve">`Phli`</doc>
      </member>
      <member name="b_script_inscriptional_parthian" value="1349678185" c:identifier="HB_SCRIPT_INSCRIPTIONAL_PARTHIAN">
        <doc xml:space="preserve">`Prti`</doc>
      </member>
      <member name="b_script_javanese" value="1247901281" c:identifier="HB_SCRIPT_JAVANESE">
        <doc xml:space="preserve">`Java`</doc>
      </member>
      <member name="b_script_kaithi" value="1265920105" c:identifier="HB_SCRIPT_KAITHI">
        <doc xml:space="preserve">`Kthi`</doc>
      </member>
      <member name="b_script_lisu" value="1281979253" c:identifier="HB_SCRIPT_LISU">
        <doc xml:space="preserve">`Lisu`</doc>
      </member>
      <member name="b_script_meetei_mayek" value="1299473769" c:identifier="HB_SCRIPT_MEETEI_MAYEK">
        <doc xml:space="preserve">`Mtei`</doc>
      </member>
      <member name="b_script_old_south_arabian" value="1398895202" c:identifier="HB_SCRIPT_OLD_SOUTH_ARABIAN">
        <doc xml:space="preserve">`Sarb`</doc>
      </member>
      <member name="b_script_old_turkic" value="1332898664" c:identifier="HB_SCRIPT_OLD_TURKIC">
        <doc xml:space="preserve">`Orkh`</doc>
      </member>
      <member name="b_script_samaritan" value="1398893938" c:identifier="HB_SCRIPT_SAMARITAN">
        <doc xml:space="preserve">`Samr`</doc>
      </member>
      <member name="b_script_tai_tham" value="1281453665" c:identifier="HB_SCRIPT_TAI_THAM">
        <doc xml:space="preserve">`Lana`</doc>
      </member>
      <member name="b_script_tai_viet" value="1415673460" c:identifier="HB_SCRIPT_TAI_VIET">
        <doc xml:space="preserve">`Tavt`</doc>
      </member>
      <member name="b_script_batak" value="1113683051" c:identifier="HB_SCRIPT_BATAK">
        <doc xml:space="preserve">`Batk`</doc>
      </member>
      <member name="b_script_brahmi" value="1114792296" c:identifier="HB_SCRIPT_BRAHMI">
        <doc xml:space="preserve">`Brah`</doc>
      </member>
      <member name="b_script_mandaic" value="1298230884" c:identifier="HB_SCRIPT_MANDAIC">
        <doc xml:space="preserve">`Mand`</doc>
      </member>
      <member name="b_script_chakma" value="1130457965" c:identifier="HB_SCRIPT_CHAKMA">
        <doc xml:space="preserve">`Cakm`</doc>
      </member>
      <member name="b_script_meroitic_cursive" value="1298494051" c:identifier="HB_SCRIPT_MEROITIC_CURSIVE">
        <doc xml:space="preserve">`Merc`</doc>
      </member>
      <member name="b_script_meroitic_hieroglyphs" value="1298494063" c:identifier="HB_SCRIPT_MEROITIC_HIEROGLYPHS">
        <doc xml:space="preserve">`Mero`</doc>
      </member>
      <member name="b_script_miao" value="1349284452" c:identifier="HB_SCRIPT_MIAO">
        <doc xml:space="preserve">`Plrd`</doc>
      </member>
      <member name="b_script_sharada" value="1399353956" c:identifier="HB_SCRIPT_SHARADA">
        <doc xml:space="preserve">`Shrd`</doc>
      </member>
      <member name="b_script_sora_sompeng" value="1399812705" c:identifier="HB_SCRIPT_SORA_SOMPENG">
        <doc xml:space="preserve">`Sora`</doc>
      </member>
      <member name="b_script_takri" value="1415670642" c:identifier="HB_SCRIPT_TAKRI">
        <doc xml:space="preserve">`Takr`</doc>
      </member>
      <member name="b_script_bassa_vah" value="1113682803" c:identifier="HB_SCRIPT_BASSA_VAH">
        <doc xml:space="preserve">`Bass`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_caucasian_albanian" value="1097295970" c:identifier="HB_SCRIPT_CAUCASIAN_ALBANIAN">
        <doc xml:space="preserve">`Aghb`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_duployan" value="1148547180" c:identifier="HB_SCRIPT_DUPLOYAN">
        <doc xml:space="preserve">`Dupl`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_elbasan" value="1164730977" c:identifier="HB_SCRIPT_ELBASAN">
        <doc xml:space="preserve">`Elba`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_grantha" value="1198678382" c:identifier="HB_SCRIPT_GRANTHA">
        <doc xml:space="preserve">`Gran`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_khojki" value="1265135466" c:identifier="HB_SCRIPT_KHOJKI">
        <doc xml:space="preserve">`Khoj`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_khudawadi" value="1399418468" c:identifier="HB_SCRIPT_KHUDAWADI">
        <doc xml:space="preserve">`Sind`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_linear_a" value="1281977953" c:identifier="HB_SCRIPT_LINEAR_A">
        <doc xml:space="preserve">`Lina`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_mahajani" value="1298229354" c:identifier="HB_SCRIPT_MAHAJANI">
        <doc xml:space="preserve">`Mahj`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_manichaean" value="1298230889" c:identifier="HB_SCRIPT_MANICHAEAN">
        <doc xml:space="preserve">`Mani`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_mende_kikakui" value="1298493028" c:identifier="HB_SCRIPT_MENDE_KIKAKUI">
        <doc xml:space="preserve">`Mend`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_modi" value="1299145833" c:identifier="HB_SCRIPT_MODI">
        <doc xml:space="preserve">`Modi`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_mro" value="1299345263" c:identifier="HB_SCRIPT_MRO">
        <doc xml:space="preserve">`Mroo`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_nabataean" value="1315070324" c:identifier="HB_SCRIPT_NABATAEAN">
        <doc xml:space="preserve">`Nbat`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_old_north_arabian" value="1315009122" c:identifier="HB_SCRIPT_OLD_NORTH_ARABIAN">
        <doc xml:space="preserve">`Narb`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_old_permic" value="1348825709" c:identifier="HB_SCRIPT_OLD_PERMIC">
        <doc xml:space="preserve">`Perm`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_pahawh_hmong" value="1215131239" c:identifier="HB_SCRIPT_PAHAWH_HMONG">
        <doc xml:space="preserve">`Hmng`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_palmyrene" value="1348562029" c:identifier="HB_SCRIPT_PALMYRENE">
        <doc xml:space="preserve">`Palm`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_pau_cin_hau" value="1348564323" c:identifier="HB_SCRIPT_PAU_CIN_HAU">
        <doc xml:space="preserve">`Pauc`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_psalter_pahlavi" value="1349020784" c:identifier="HB_SCRIPT_PSALTER_PAHLAVI">
        <doc xml:space="preserve">`Phlp`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_siddham" value="1399415908" c:identifier="HB_SCRIPT_SIDDHAM">
        <doc xml:space="preserve">`Sidd`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_tirhuta" value="1416196712" c:identifier="HB_SCRIPT_TIRHUTA">
        <doc xml:space="preserve">`Tirh`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_warang_citi" value="1466004065" c:identifier="HB_SCRIPT_WARANG_CITI">
        <doc xml:space="preserve">`Wara`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_ahom" value="1097363309" c:identifier="HB_SCRIPT_AHOM">
        <doc xml:space="preserve">`Ahom`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_anatolian_hieroglyphs" value="1215067511" c:identifier="HB_SCRIPT_ANATOLIAN_HIEROGLYPHS">
        <doc xml:space="preserve">`Hluw`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_hatran" value="1214346354" c:identifier="HB_SCRIPT_HATRAN">
        <doc xml:space="preserve">`Hatr`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_multani" value="1299541108" c:identifier="HB_SCRIPT_MULTANI">
        <doc xml:space="preserve">`Mult`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_old_hungarian" value="1215655527" c:identifier="HB_SCRIPT_OLD_HUNGARIAN">
        <doc xml:space="preserve">`Hung`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_signwriting" value="1399287415" c:identifier="HB_SCRIPT_SIGNWRITING">
        <doc xml:space="preserve">`Sgnw`, Since: 0.9.30</doc>
      </member>
      <member name="b_script_adlam" value="1097100397" c:identifier="HB_SCRIPT_ADLAM">
        <doc xml:space="preserve">`Adlm`, Since: 1.3.0</doc>
      </member>
      <member name="b_script_bhaiksuki" value="1114139507" c:identifier="HB_SCRIPT_BHAIKSUKI">
        <doc xml:space="preserve">`Bhks`, Since: 1.3.0</doc>
      </member>
      <member name="b_script_marchen" value="1298231907" c:identifier="HB_SCRIPT_MARCHEN">
        <doc xml:space="preserve">`Marc`, Since: 1.3.0</doc>
      </member>
      <member name="b_script_osage" value="1332963173" c:identifier="HB_SCRIPT_OSAGE">
        <doc xml:space="preserve">`Osge`, Since: 1.3.0</doc>
      </member>
      <member name="b_script_tangut" value="1415671399" c:identifier="HB_SCRIPT_TANGUT">
        <doc xml:space="preserve">`Tang`, Since: 1.3.0</doc>
      </member>
      <member name="b_script_newa" value="1315272545" c:identifier="HB_SCRIPT_NEWA">
        <doc xml:space="preserve">`Newa`, Since: 1.3.0</doc>
      </member>
      <member name="b_script_masaram_gondi" value="1198485101" c:identifier="HB_SCRIPT_MASARAM_GONDI">
        <doc xml:space="preserve">`Gonm`, Since: 1.6.0</doc>
      </member>
      <member name="b_script_nushu" value="1316186229" c:identifier="HB_SCRIPT_NUSHU">
        <doc xml:space="preserve">`Nshu`, Since: 1.6.0</doc>
      </member>
      <member name="b_script_soyombo" value="1399814511" c:identifier="HB_SCRIPT_SOYOMBO">
        <doc xml:space="preserve">`Soyo`, Since: 1.6.0</doc>
      </member>
      <member name="b_script_zanabazar_square" value="1516334690" c:identifier="HB_SCRIPT_ZANABAZAR_SQUARE">
        <doc xml:space="preserve">`Zanb`, Since: 1.6.0</doc>
      </member>
      <member name="b_script_dogra" value="1148151666" c:identifier="HB_SCRIPT_DOGRA">
        <doc xml:space="preserve">`Dogr`, Since: 1.8.0</doc>
      </member>
      <member name="b_script_gunjala_gondi" value="1198485095" c:identifier="HB_SCRIPT_GUNJALA_GONDI">
        <doc xml:space="preserve">`Gong`, Since: 1.8.0</doc>
      </member>
      <member name="b_script_hanifi_rohingya" value="1383032935" c:identifier="HB_SCRIPT_HANIFI_ROHINGYA">
        <doc xml:space="preserve">`Rohg`, Since: 1.8.0</doc>
      </member>
      <member name="b_script_makasar" value="1298230113" c:identifier="HB_SCRIPT_MAKASAR">
        <doc xml:space="preserve">`Maka`, Since: 1.8.0</doc>
      </member>
      <member name="b_script_medefaidrin" value="1298490470" c:identifier="HB_SCRIPT_MEDEFAIDRIN">
        <doc xml:space="preserve">`Medf`, Since: 1.8.0</doc>
      </member>
      <member name="b_script_old_sogdian" value="1399809903" c:identifier="HB_SCRIPT_OLD_SOGDIAN">
        <doc xml:space="preserve">`Sogo`, Since: 1.8.0</doc>
      </member>
      <member name="b_script_sogdian" value="1399809892" c:identifier="HB_SCRIPT_SOGDIAN">
        <doc xml:space="preserve">`Sogd`, Since: 1.8.0</doc>
      </member>
      <member name="b_script_elymaic" value="1164736877" c:identifier="HB_SCRIPT_ELYMAIC">
        <doc xml:space="preserve">`Elym`, Since: 2.4.0</doc>
      </member>
      <member name="b_script_nandinagari" value="1315008100" c:identifier="HB_SCRIPT_NANDINAGARI">
        <doc xml:space="preserve">`Nand`, Since: 2.4.0</doc>
      </member>
      <member name="b_script_nyiakeng_puachue_hmong" value="1215131248" c:identifier="HB_SCRIPT_NYIAKENG_PUACHUE_HMONG">
        <doc xml:space="preserve">`Hmnp`, Since: 2.4.0</doc>
      </member>
      <member name="b_script_wancho" value="1466132591" c:identifier="HB_SCRIPT_WANCHO">
        <doc xml:space="preserve">`Wcho`, Since: 2.4.0</doc>
      </member>
      <member name="b_script_chorasmian" value="1130918515" c:identifier="HB_SCRIPT_CHORASMIAN">
        <doc xml:space="preserve">`Chrs`, Since: 2.6.7</doc>
      </member>
      <member name="b_script_dives_akuru" value="1147756907" c:identifier="HB_SCRIPT_DIVES_AKURU">
        <doc xml:space="preserve">`Diak`, Since: 2.6.7</doc>
      </member>
      <member name="b_script_khitan_small_script" value="1265202291" c:identifier="HB_SCRIPT_KHITAN_SMALL_SCRIPT">
        <doc xml:space="preserve">`Kits`, Since: 2.6.7</doc>
      </member>
      <member name="b_script_yezidi" value="1499822697" c:identifier="HB_SCRIPT_YEZIDI">
        <doc xml:space="preserve">`Yezi`, Since: 2.6.7</doc>
      </member>
      <member name="b_script_cypro_minoan" value="1131441518" c:identifier="HB_SCRIPT_CYPRO_MINOAN">
        <doc xml:space="preserve">`Cpmn`, Since: 3.0.0</doc>
      </member>
      <member name="b_script_old_uyghur" value="1333094258" c:identifier="HB_SCRIPT_OLD_UYGHUR">
        <doc xml:space="preserve">`Ougr`, Since: 3.0.0</doc>
      </member>
      <member name="b_script_tangsa" value="1416524641" c:identifier="HB_SCRIPT_TANGSA">
        <doc xml:space="preserve">`Tnsa`, Since: 3.0.0</doc>
      </member>
      <member name="b_script_toto" value="1416590447" c:identifier="HB_SCRIPT_TOTO">
        <doc xml:space="preserve">`Toto`, Since: 3.0.0</doc>
      </member>
      <member name="b_script_vithkuqi" value="1449751656" c:identifier="HB_SCRIPT_VITHKUQI">
        <doc xml:space="preserve">`Vith`, Since: 3.0.0</doc>
      </member>
      <member name="b_script_math" value="1517122664" c:identifier="HB_SCRIPT_MATH">
        <doc xml:space="preserve">`Zmth`, Since: 3.4.0</doc>
      </member>
      <member name="b_script_kawi" value="1264678761" c:identifier="HB_SCRIPT_KAWI">
        <doc xml:space="preserve">`Kawi`, Since: 5.2.0</doc>
      </member>
      <member name="b_script_nag_mundari" value="1315006317" c:identifier="HB_SCRIPT_NAG_MUNDARI">
        <doc xml:space="preserve">`Nagm`, Since: 5.2.0</doc>
      </member>
      <member name="b_script_garay" value="1197568609" c:identifier="HB_SCRIPT_GARAY">
        <doc xml:space="preserve">`Gara`, Since: 10.0.0</doc>
      </member>
      <member name="b_script_gurung_khema" value="1198877544" c:identifier="HB_SCRIPT_GURUNG_KHEMA">
        <doc xml:space="preserve">`Gukh`, Since: 10.0.0</doc>
      </member>
      <member name="b_script_kirat_rai" value="1265787241" c:identifier="HB_SCRIPT_KIRAT_RAI">
        <doc xml:space="preserve">`Krai`, Since: 10.0.0</doc>
      </member>
      <member name="b_script_ol_onal" value="1332633967" c:identifier="HB_SCRIPT_OL_ONAL">
        <doc xml:space="preserve">`Onao`, Since: 10.0.0</doc>
      </member>
      <member name="b_script_sunuwar" value="1400204917" c:identifier="HB_SCRIPT_SUNUWAR">
        <doc xml:space="preserve">`Sunu`, Since: 10.0.0</doc>
      </member>
      <member name="b_script_todhri" value="1416586354" c:identifier="HB_SCRIPT_TODHRI">
        <doc xml:space="preserve">`Todr`, Since: 10.0.0</doc>
      </member>
      <member name="b_script_tulu_tigalari" value="1416983655" c:identifier="HB_SCRIPT_TULU_TIGALARI">
        <doc xml:space="preserve">`Tutg`, Since: 10.0.0</doc>
      </member>
      <member name="b_script_beria_erfe" value="1113944678" c:identifier="HB_SCRIPT_BERIA_ERFE">
        <doc xml:space="preserve">`Berf`, Since: 11.5.0</doc>
      </member>
      <member name="b_script_sidetic" value="1399415924" c:identifier="HB_SCRIPT_SIDETIC">
        <doc xml:space="preserve">`Sidt`, Since: 11.5.0</doc>
      </member>
      <member name="b_script_tai_yo" value="1415674223" c:identifier="HB_SCRIPT_TAI_YO">
        <doc xml:space="preserve">`Tayo`, Since: 11.5.0</doc>
      </member>
      <member name="b_script_tolong_siki" value="1416588403" c:identifier="HB_SCRIPT_TOLONG_SIKI">
        <doc xml:space="preserve">`Tols`, Since: 11.5.0</doc>
      </member>
      <member name="b_script_invalid" value="0" c:identifier="HB_SCRIPT_INVALID">
        <doc xml:space="preserve">No script set</doc>
      </member>
    </bitfield>
    <function name="script_to_iso15924_tag" c:identifier="hb_script_to_iso15924_tag" version="0.9.2">
      <doc xml:space="preserve">Converts an #hb_script_t to a corresponding ISO&#xA0;15924 script tag.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">An #hb_tag_t representing an ISO 15924 script tag.</doc>
        <type name="tag_t" c:type="hb_tag_t"/>
      </return-value>
      <parameters>
        <parameter name="script" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_script_t to convert.</doc>
          <type name="script_t" c:type="hb_script_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="segment_properties_equal" c:identifier="hb_segment_properties_equal" version="0.9.7">
      <doc xml:space="preserve">Checks the equality of two #hb_segment_properties_t's.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if all properties of @a equal those of @b, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="a" transfer-ownership="none">
          <doc xml:space="preserve">first #hb_segment_properties_t to compare.</doc>
          <type name="segment_properties_t" c:type="const hb_segment_properties_t*"/>
        </parameter>
        <parameter name="b" transfer-ownership="none">
          <doc xml:space="preserve">second #hb_segment_properties_t to compare.</doc>
          <type name="segment_properties_t" c:type="const hb_segment_properties_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="segment_properties_hash" c:identifier="hb_segment_properties_hash" version="0.9.7">
      <doc xml:space="preserve">Creates a hash representing @p.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">A hash of @p.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="p" transfer-ownership="none">
          <doc xml:space="preserve">#hb_segment_properties_t to hash.</doc>
          <type name="segment_properties_t" c:type="const hb_segment_properties_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="segment_properties_overlay" c:identifier="hb_segment_properties_overlay" version="3.3.0">
      <doc xml:space="preserve">Fills in missing fields of @p from @src in a considered manner.

First, if @p does not have direction set, direction is copied from @src.

Next, if @p and @src have the same direction (which can be unset), if @p
does not have script set, script is copied from @src.

Finally, if @p and @src have the same direction and script (which either
can be unset), if @p does not have language set, language is copied from
@src.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="p" transfer-ownership="none">
          <doc xml:space="preserve">#hb_segment_properties_t to fill in.</doc>
          <type name="segment_properties_t" c:type="hb_segment_properties_t*"/>
        </parameter>
        <parameter name="src" transfer-ownership="none">
          <doc xml:space="preserve">#hb_segment_properties_t to fill in from.</doc>
          <type name="segment_properties_t" c:type="const hb_segment_properties_t*"/>
        </parameter>
      </parameters>
    </function>
    <record name="segment_properties_t" c:type="hb_segment_properties_t" glib:type-name="hb_segment_properties_t" glib:get-type="hb_gobject_segment_properties_get_type" c:symbol-prefix="gobject_segment_properties">
      <doc xml:space="preserve">The structure that holds various text properties of an #hb_buffer_t. Can be
set and retrieved using hb_buffer_set_segment_properties() and
hb_buffer_get_segment_properties(), respectively.</doc>
      <field name="direction" writable="1">
        <doc xml:space="preserve">the #hb_direction_t of the buffer, see hb_buffer_set_direction().</doc>
        <type name="direction_t" c:type="hb_direction_t"/>
      </field>
      <field name="script" writable="1">
        <doc xml:space="preserve">the #hb_script_t of the buffer, see hb_buffer_set_script().</doc>
        <type name="script_t" c:type="hb_script_t"/>
      </field>
      <field name="language" writable="1">
        <doc xml:space="preserve">the #hb_language_t of the buffer, see hb_buffer_set_language().</doc>
        <type name="language_t" c:type="hb_language_t"/>
      </field>
      <field name="reserved1" readable="0" private="1">
        <type name="gpointer" c:type="void*"/>
      </field>
      <field name="reserved2" readable="0" private="1">
        <type name="gpointer" c:type="void*"/>
      </field>
    </record>
    <function name="set_add" c:identifier="hb_set_add" version="0.9.2">
      <doc xml:space="preserve">Adds @codepoint to @set.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="codepoint" transfer-ownership="none">
          <doc xml:space="preserve">The element to add to @set</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_add_range" c:identifier="hb_set_add_range" version="0.9.7">
      <doc xml:space="preserve">Adds all of the elements from @first to @last
(inclusive) to @set.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="first" transfer-ownership="none">
          <doc xml:space="preserve">The first element to add to @set</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="last" transfer-ownership="none">
          <doc xml:space="preserve">The final element to add to @set</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_add_sorted_array" c:identifier="hb_set_add_sorted_array" version="4.1.0">
      <doc xml:space="preserve">Adds @num_codepoints codepoints to a set at once.
The codepoints array must be in increasing order,
with size at least @num_codepoints.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="sorted_codepoints" transfer-ownership="none">
          <doc xml:space="preserve">Array of codepoints to add</doc>
          <array length="2" zero-terminated="0" c:type="const hb_codepoint_t*">
            <type name="codepoint_t" c:type="hb_codepoint_t"/>
          </array>
        </parameter>
        <parameter name="num_codepoints" transfer-ownership="none">
          <doc xml:space="preserve">Length of @sorted_codepoints</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_allocation_successful" c:identifier="hb_set_allocation_successful" version="0.9.2">
      <doc xml:space="preserve">Tests whether memory allocation for a set was successful.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if allocation succeeded, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_clear" c:identifier="hb_set_clear" version="0.9.2">
      <doc xml:space="preserve">Clears out the contents of a set.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_copy" c:identifier="hb_set_copy" version="2.8.2">
      <doc xml:space="preserve">Allocate a copy of @set.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">Newly-allocated set.</doc>
        <type name="set_t" c:type="hb_set_t*"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_create" c:identifier="hb_set_create" version="0.9.2">
      <doc xml:space="preserve">Creates a new, initially empty set.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The new #hb_set_t</doc>
        <type name="set_t" c:type="hb_set_t*"/>
      </return-value>
    </function>
    <function name="set_del" c:identifier="hb_set_del" version="0.9.2">
      <doc xml:space="preserve">Removes @codepoint from @set.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="codepoint" transfer-ownership="none">
          <doc xml:space="preserve">Removes @codepoint from @set</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_del_range" c:identifier="hb_set_del_range" version="0.9.7">
      <doc xml:space="preserve">Removes all of the elements from @first to @last
(inclusive) from @set.

If @last is #HB_SET_VALUE_INVALID, then all values
greater than or equal to @first are removed.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="first" transfer-ownership="none">
          <doc xml:space="preserve">The first element to remove from @set</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="last" transfer-ownership="none">
          <doc xml:space="preserve">The final element to remove from @set</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_destroy" c:identifier="hb_set_destroy" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Decreases the reference count on a set. When
the reference count reaches zero, the set is
destroyed, freeing all memory.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_get_empty" c:identifier="hb_set_get_empty" version="0.9.2">
      <doc xml:space="preserve">Fetches the singleton empty #hb_set_t.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty #hb_set_t</doc>
        <type name="set_t" c:type="hb_set_t*"/>
      </return-value>
    </function>
    <function name="set_get_max" c:identifier="hb_set_get_max" version="0.9.7">
      <doc xml:space="preserve">Finds the largest element in the set.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">maximum of @set, or #HB_SET_VALUE_INVALID if @set is empty.</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_get_min" c:identifier="hb_set_get_min" version="0.9.7">
      <doc xml:space="preserve">Finds the smallest element in the set.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">minimum of @set, or #HB_SET_VALUE_INVALID if @set is empty.</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_get_population" c:identifier="hb_set_get_population" version="0.9.7">
      <doc xml:space="preserve">Returns the number of elements in the set.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The population of @set</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_get_user_data" c:identifier="hb_set_get_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Fetches the user data associated with the specified key,
attached to the specified set.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_has" c:identifier="hb_set_has" version="0.9.2">
      <doc xml:space="preserve">Tests whether @codepoint belongs to @set.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @codepoint is in @set, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="codepoint" transfer-ownership="none">
          <doc xml:space="preserve">The element to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_hash" c:identifier="hb_set_hash" version="4.4.0">
      <doc xml:space="preserve">Creates a hash representing @set.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">A hash of @set.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_intersect" c:identifier="hb_set_intersect" version="0.9.2">
      <doc xml:space="preserve">Makes @set the intersection of @set and @other.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="other" transfer-ownership="none">
          <doc xml:space="preserve">Another set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_invert" c:identifier="hb_set_invert" version="3.0.0">
      <doc xml:space="preserve">Inverts the contents of @set.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_is_empty" c:identifier="hb_set_is_empty" version="0.9.7">
      <doc xml:space="preserve">Tests whether a set is empty (contains no elements).</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @set is empty</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">a set.</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_is_equal" c:identifier="hb_set_is_equal" version="0.9.7">
      <doc xml:space="preserve">Tests whether @set and @other are equal (contain the same
elements).</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the two sets are equal, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="other" transfer-ownership="none">
          <doc xml:space="preserve">Another set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_is_inverted" c:identifier="hb_set_is_inverted" version="7.0.0">
      <doc xml:space="preserve">Returns whether the set is inverted.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the set is inverted, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_is_subset" c:identifier="hb_set_is_subset" version="1.8.1">
      <doc xml:space="preserve">Tests whether @set is a subset of @larger_set.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if the @set is a subset of (or equal to) @larger_set, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="larger_set" transfer-ownership="none">
          <doc xml:space="preserve">Another set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_next" c:identifier="hb_set_next" version="0.9.2">
      <doc xml:space="preserve">Fetches the next element in @set that is greater than current value of @codepoint.

Set @codepoint to #HB_SET_VALUE_INVALID to get started.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if there was a next value, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="codepoint" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = Code point to query
            Output = Code point retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_next_many" c:identifier="hb_set_next_many" version="4.2.0">
      <doc xml:space="preserve">Finds the next element in @set that is greater than @codepoint. Writes out
codepoints to @out, until either the set runs out of elements, or @size
codepoints are written, whichever comes first.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">the number of values written.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="codepoint" transfer-ownership="none">
          <doc xml:space="preserve">Outputting codepoints starting after this one.
            Use #HB_SET_VALUE_INVALID to get started.</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="out" transfer-ownership="none">
          <doc xml:space="preserve">An array of codepoints to write to.</doc>
          <array length="3" zero-terminated="0" c:type="hb_codepoint_t*">
            <type name="codepoint_t" c:type="hb_codepoint_t"/>
          </array>
        </parameter>
        <parameter name="size" transfer-ownership="none">
          <doc xml:space="preserve">The maximum number of codepoints to write out.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_next_range" c:identifier="hb_set_next_range" version="0.9.7">
      <doc xml:space="preserve">Fetches the next consecutive range of elements in @set that
are greater than current value of @last.

Set @last to #HB_SET_VALUE_INVALID to get started.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if there was a next range, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="first" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first code point in the range</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="last" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = The current last code point in the range
        Output = The last code point in the range</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_previous" c:identifier="hb_set_previous" version="1.8.0">
      <doc xml:space="preserve">Fetches the previous element in @set that is lower than current value of @codepoint.

Set @codepoint to #HB_SET_VALUE_INVALID to get started.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if there was a previous value, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="codepoint" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = Code point to query
            Output = Code point retrieved</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_previous_range" c:identifier="hb_set_previous_range" version="1.8.0">
      <doc xml:space="preserve">Fetches the previous consecutive range of elements in @set that
are greater than current value of @last.

Set @first to #HB_SET_VALUE_INVALID to get started.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if there was a previous range, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
        <parameter name="first" direction="inout" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Input = The current first code point in the range
        Output = The first code point in the range</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="last" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The last code point in the range</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_reference" c:identifier="hb_set_reference" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on a set.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The set</doc>
        <type name="set_t" c:type="hb_set_t*"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_set" c:identifier="hb_set_set" version="0.9.2">
      <doc xml:space="preserve">Makes the contents of @set equal to the contents of @other.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="other" transfer-ownership="none">
          <doc xml:space="preserve">Another set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_set_user_data" c:identifier="hb_set_set_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the specified set.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to set</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data to set</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_subtract" c:identifier="hb_set_subtract" version="0.9.2">
      <doc xml:space="preserve">Subtracts the contents of @other from @set.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="other" transfer-ownership="none">
          <doc xml:space="preserve">Another set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="set_symmetric_difference" c:identifier="hb_set_symmetric_difference" version="0.9.2">
      <doc xml:space="preserve">Makes @set the symmetric difference of @set
and @other.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="other" transfer-ownership="none">
          <doc xml:space="preserve">Another set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <record name="set_t" c:type="hb_set_t" opaque="1" glib:type-name="hb_set_t" glib:get-type="hb_gobject_set_get_type" c:symbol-prefix="gobject_set">
      <doc xml:space="preserve">Data type for holding a set of integers. #hb_set_t's are
used to gather and contain glyph IDs, Unicode code
points, and various other collections of discrete
values.</doc>
    </record>
    <function name="set_union" c:identifier="hb_set_union" version="0.9.2">
      <doc xml:space="preserve">Makes @set the union of @set and @other.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="set" transfer-ownership="none">
          <doc xml:space="preserve">A set</doc>
          <type name="set_t" c:type="hb_set_t*"/>
        </parameter>
        <parameter name="other" transfer-ownership="none">
          <doc xml:space="preserve">Another set</doc>
          <type name="set_t" c:type="const hb_set_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="shape" c:identifier="hb_shape" version="0.9.2">
      <doc xml:space="preserve">Shapes @buffer using @font turning its Unicode characters content to
positioned glyphs. If @features is not `NULL`, it will be used to control the
features applied during shaping. If two @features have the same tag but
overlapping ranges the value of the feature with the higher index takes
precedence.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_font_t to use for shaping</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_buffer_t to shape</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="features" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">an array of user
   specified #hb_feature_t or `NULL`</doc>
          <array length="3" zero-terminated="0" c:type="const hb_feature_t*">
            <type name="feature_t" c:type="hb_feature_t"/>
          </array>
        </parameter>
        <parameter name="num_features" transfer-ownership="none">
          <doc xml:space="preserve">the length of @features array</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="shape_full" c:identifier="hb_shape_full" version="0.9.2">
      <doc xml:space="preserve">See hb_shape() for details. If @shaper_list is not `NULL`, the specified
shapers will be used in the given order, otherwise the default shapers list
will be used.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">false if all shapers failed, true otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_font_t to use for shaping</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_buffer_t to shape</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="features" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">an array of user
   specified #hb_feature_t or `NULL`</doc>
          <array length="3" zero-terminated="0" c:type="const hb_feature_t*">
            <type name="feature_t" c:type="hb_feature_t"/>
          </array>
        </parameter>
        <parameter name="num_features" transfer-ownership="none">
          <doc xml:space="preserve">the length of @features array</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="shaper_list" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">a `NULL`-terminated
   array of shapers to use or `NULL`</doc>
          <array c:type="const char* const*">
            <type name="utf8" c:type="char*"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="shape_list_shapers" c:identifier="hb_shape_list_shapers" version="0.9.2">
      <doc xml:space="preserve">Retrieves the list of shapers supported by HarfBuzz.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">a
   `NULL`-terminated array of supported shapers constant string.
   The returned array is owned by HarfBuzz and should not be
   modified or freed.</doc>
        <array c:type="const char**">
          <type name="utf8"/>
        </array>
      </return-value>
    </function>
    <function name="shape_plan_create" c:identifier="hb_shape_plan_create" version="0.9.7">
      <doc xml:space="preserve">Constructs a shaping plan for a combination of @face, @user_features, @props,
and @shaper_list.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The shaping plan</doc>
        <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to use</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="props" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_segment_properties_t of the segment</doc>
          <type name="segment_properties_t" c:type="const hb_segment_properties_t*"/>
        </parameter>
        <parameter name="user_features" transfer-ownership="none">
          <doc xml:space="preserve">The list of user-selected features</doc>
          <array length="3" zero-terminated="0" c:type="const hb_feature_t*">
            <type name="feature_t" c:type="hb_feature_t"/>
          </array>
        </parameter>
        <parameter name="num_user_features" transfer-ownership="none">
          <doc xml:space="preserve">The number of user-selected features</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="shaper_list" transfer-ownership="none">
          <doc xml:space="preserve">List of shapers to try</doc>
          <array c:type="const char* const*">
            <type name="utf8" c:type="char*"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="shape_plan_create2" c:identifier="hb_shape_plan_create2" version="1.4.0">
      <doc xml:space="preserve">The variable-font version of #hb_shape_plan_create.
Constructs a shaping plan for a combination of @face, @user_features, @props,
and @shaper_list, plus the variation-space coordinates @coords.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The shaping plan</doc>
        <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to use</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="props" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_segment_properties_t of the segment</doc>
          <type name="segment_properties_t" c:type="const hb_segment_properties_t*"/>
        </parameter>
        <parameter name="user_features" transfer-ownership="none">
          <doc xml:space="preserve">The list of user-selected features</doc>
          <array length="3" zero-terminated="0" c:type="const hb_feature_t*">
            <type name="feature_t" c:type="hb_feature_t"/>
          </array>
        </parameter>
        <parameter name="num_user_features" transfer-ownership="none">
          <doc xml:space="preserve">The number of user-selected features</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="coords" transfer-ownership="none">
          <doc xml:space="preserve">The list of variation-space coordinates</doc>
          <array length="5" zero-terminated="0" c:type="const int*">
            <type name="gint" c:type="int"/>
          </array>
        </parameter>
        <parameter name="num_coords" transfer-ownership="none">
          <doc xml:space="preserve">The number of variation-space coordinates</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="shaper_list" transfer-ownership="none">
          <doc xml:space="preserve">List of shapers to try</doc>
          <array c:type="const char* const*">
            <type name="utf8" c:type="char*"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="shape_plan_create_cached" c:identifier="hb_shape_plan_create_cached" version="0.9.7">
      <doc xml:space="preserve">Creates a cached shaping plan suitable for reuse, for a combination
of @face, @user_features, @props, and @shaper_list.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The shaping plan</doc>
        <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to use</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="props" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_segment_properties_t of the segment</doc>
          <type name="segment_properties_t" c:type="const hb_segment_properties_t*"/>
        </parameter>
        <parameter name="user_features" transfer-ownership="none">
          <doc xml:space="preserve">The list of user-selected features</doc>
          <array length="3" zero-terminated="0" c:type="const hb_feature_t*">
            <type name="feature_t" c:type="hb_feature_t"/>
          </array>
        </parameter>
        <parameter name="num_user_features" transfer-ownership="none">
          <doc xml:space="preserve">The number of user-selected features</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="shaper_list" transfer-ownership="none">
          <doc xml:space="preserve">List of shapers to try</doc>
          <array c:type="const char* const*">
            <type name="utf8" c:type="char*"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="shape_plan_create_cached2" c:identifier="hb_shape_plan_create_cached2" version="1.4.0">
      <doc xml:space="preserve">The variable-font version of #hb_shape_plan_create_cached.
Creates a cached shaping plan suitable for reuse, for a combination
of @face, @user_features, @props, and @shaper_list, plus the
variation-space coordinates @coords.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The shaping plan</doc>
        <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
      </return-value>
      <parameters>
        <parameter name="face" transfer-ownership="none">
          <doc xml:space="preserve">#hb_face_t to use</doc>
          <type name="face_t" c:type="hb_face_t*"/>
        </parameter>
        <parameter name="props" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_segment_properties_t of the segment</doc>
          <type name="segment_properties_t" c:type="const hb_segment_properties_t*"/>
        </parameter>
        <parameter name="user_features" transfer-ownership="none">
          <doc xml:space="preserve">The list of user-selected features</doc>
          <array length="3" zero-terminated="0" c:type="const hb_feature_t*">
            <type name="feature_t" c:type="hb_feature_t"/>
          </array>
        </parameter>
        <parameter name="num_user_features" transfer-ownership="none">
          <doc xml:space="preserve">The number of user-selected features</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="coords" transfer-ownership="none">
          <doc xml:space="preserve">The list of variation-space coordinates</doc>
          <array length="5" zero-terminated="0" c:type="const int*">
            <type name="gint" c:type="int"/>
          </array>
        </parameter>
        <parameter name="num_coords" transfer-ownership="none">
          <doc xml:space="preserve">The number of variation-space coordinates</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="shaper_list" transfer-ownership="none">
          <doc xml:space="preserve">List of shapers to try</doc>
          <array c:type="const char* const*">
            <type name="utf8" c:type="char*"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="shape_plan_destroy" c:identifier="hb_shape_plan_destroy" version="0.9.7" introspectable="0">
      <doc xml:space="preserve">Decreases the reference count on the given shaping plan. When the
reference count reaches zero, the shaping plan is destroyed,
freeing all memory.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="shape_plan" transfer-ownership="none">
          <doc xml:space="preserve">A shaping plan</doc>
          <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="shape_plan_execute" c:identifier="hb_shape_plan_execute" version="0.9.7">
      <doc xml:space="preserve">Executes the given shaping plan on the specified buffer, using
the given @font and @features.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="shape_plan" transfer-ownership="none">
          <doc xml:space="preserve">A shaping plan</doc>
          <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
        </parameter>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_font_t to use</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="buffer" transfer-ownership="none">
          <doc xml:space="preserve">The #hb_buffer_t to work upon</doc>
          <type name="buffer_t" c:type="hb_buffer_t*"/>
        </parameter>
        <parameter name="features" transfer-ownership="none">
          <doc xml:space="preserve">Features to enable</doc>
          <array length="4" zero-terminated="0" c:type="const hb_feature_t*">
            <type name="feature_t" c:type="hb_feature_t"/>
          </array>
        </parameter>
        <parameter name="num_features" transfer-ownership="none">
          <doc xml:space="preserve">The number of features to enable</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
    <function name="shape_plan_get_empty" c:identifier="hb_shape_plan_get_empty" version="0.9.7">
      <doc xml:space="preserve">Fetches the singleton empty shaping plan.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty shaping plan</doc>
        <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
      </return-value>
    </function>
    <function name="shape_plan_get_shaper" c:identifier="hb_shape_plan_get_shaper" version="0.9.7">
      <doc xml:space="preserve">Fetches the shaper from a given shaping plan.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The shaper</doc>
        <type name="utf8" c:type="const char*"/>
      </return-value>
      <parameters>
        <parameter name="shape_plan" transfer-ownership="none">
          <doc xml:space="preserve">A shaping plan</doc>
          <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="shape_plan_get_user_data" c:identifier="hb_shape_plan_get_user_data" version="0.9.7" introspectable="0">
      <doc xml:space="preserve">Fetches the user data associated with the specified key,
attached to the specified shaping plan.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="shape_plan" transfer-ownership="none">
          <doc xml:space="preserve">A shaping plan</doc>
          <type name="shape_plan_t" c:type="const hb_shape_plan_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="shape_plan_reference" c:identifier="hb_shape_plan_reference" version="0.9.7" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on the given shaping plan.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">@shape_plan</doc>
        <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
      </return-value>
      <parameters>
        <parameter name="shape_plan" transfer-ownership="none">
          <doc xml:space="preserve">A shaping plan</doc>
          <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="shape_plan_set_user_data" c:identifier="hb_shape_plan_set_user_data" version="0.9.7" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the given shaping plan.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise.</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="shape_plan" transfer-ownership="none">
          <doc xml:space="preserve">A shaping plan</doc>
          <type name="shape_plan_t" c:type="hb_shape_plan_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to set</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="shape_plan_t" c:type="hb_shape_plan_t" opaque="1" glib:type-name="hb_shape_plan_t" glib:get-type="hb_gobject_shape_plan_get_type" c:symbol-prefix="gobject_shape_plan">
      <doc xml:space="preserve">Data type for holding a shaping plan.

Shape plans contain information about how HarfBuzz will shape a
particular text segment, based on the segment's properties and the
capabilities in the font face in use.

Shape plans can be queried about how shaping will perform, given a set
of specific input parameters (script, language, direction, features,
etc.).</doc>
    </record>
    <function name="style_get_value" c:identifier="hb_style_get_value" version="3.0.0">
      <doc xml:space="preserve">Searches variation axes of a #hb_font_t object for a specific axis first,
if not set, first tries to get default style values in `STAT` table
then tries to polyfill from different tables of the font.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">Corresponding axis or default value to a style tag.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="font" transfer-ownership="none">
          <doc xml:space="preserve">a #hb_font_t object.</doc>
          <type name="font_t" c:type="hb_font_t*"/>
        </parameter>
        <parameter name="style_tag" transfer-ownership="none">
          <doc xml:space="preserve">a style tag.</doc>
          <type name="style_tag_t" c:type="hb_style_tag_t"/>
        </parameter>
      </parameters>
    </function>
    <bitfield name="style_tag_t" version="3.0.0" c:type="hb_style_tag_t">
      <doc xml:space="preserve">Defined by [OpenType Design-Variation Axis Tag Registry](https://docs.microsoft.com/en-us/typography/opentype/spec/dvaraxisreg).</doc>
      <member name="b_style_tag_italic" value="1769234796" c:identifier="HB_STYLE_TAG_ITALIC">
        <doc xml:space="preserve">Used to vary between non-italic and italic.
A value of 0 can be interpreted as "Roman" (non-italic); a value of 1 can
be interpreted as (fully) italic.</doc>
      </member>
      <member name="b_style_tag_optical_size" value="1869640570" c:identifier="HB_STYLE_TAG_OPTICAL_SIZE">
        <doc xml:space="preserve">Used to vary design to suit different text sizes.
Non-zero. Values can be interpreted as text size, in points.</doc>
      </member>
      <member name="b_style_tag_slant_angle" value="1936486004" c:identifier="HB_STYLE_TAG_SLANT_ANGLE">
        <doc xml:space="preserve">Used to vary between upright and slanted text. Values
must be greater than -90 and less than +90. Values can be interpreted as
the angle, in counter-clockwise degrees, of oblique slant from whatever the
designer considers to be upright for that font design. Typical right-leaning
Italic fonts have a negative slant angle (typically around -12)</doc>
      </member>
      <member name="b_style_tag_slant_ratio" value="1399615092" c:identifier="HB_STYLE_TAG_SLANT_RATIO">
        <doc xml:space="preserve">same as @HB_STYLE_TAG_SLANT_ANGLE expression as ratio.
Typical right-leaning Italic fonts have a positive slant ratio (typically around 0.2)</doc>
      </member>
      <member name="b_style_tag_width" value="2003072104" c:identifier="HB_STYLE_TAG_WIDTH">
        <doc xml:space="preserve">Used to vary width of text from narrower to wider.
Non-zero. Values can be interpreted as a percentage of whatever the font
designer considers &#x201C;normal width&#x201D; for that font design.</doc>
      </member>
      <member name="b_style_tag_weight" value="2003265652" c:identifier="HB_STYLE_TAG_WEIGHT">
        <doc xml:space="preserve">Used to vary stroke thicknesses or other design details
to give variation from lighter to blacker. Values can be interpreted in direct
comparison to values for usWeightClass in the OS/2 table,
or the CSS font-weight property.</doc>
      </member>
    </bitfield>
    <function name="tag_from_string" c:identifier="hb_tag_from_string" version="0.9.2">
      <doc xml:space="preserve">Converts a string into an #hb_tag_t. Valid tags
are four characters. Shorter input strings will be
padded with spaces. Longer input strings will be
truncated.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_tag_t corresponding to @str</doc>
        <type name="tag_t" c:type="hb_tag_t"/>
      </return-value>
      <parameters>
        <parameter name="str" transfer-ownership="none">
          <doc xml:space="preserve">String to convert</doc>
          <array length="1" zero-terminated="0" c:type="const char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">Length of @str, or -1 if it is `NULL`-terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="tag_to_string" c:identifier="hb_tag_to_string" version="0.9.5">
      <doc xml:space="preserve">Converts an #hb_tag_t to a string and returns it in @buf.
Strings will be four characters long.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:space="preserve">#hb_tag_t to convert</doc>
          <type name="tag_t" c:type="hb_tag_t"/>
        </parameter>
        <parameter name="buf" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">Converted string</doc>
          <array zero-terminated="0" c:type="char*" fixed-size="4">
            <type name="guint8"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_combining_class" c:identifier="hb_unicode_combining_class" version="0.9.2">
      <doc xml:space="preserve">Retrieves the Canonical Combining Class (ccc) property
of code point @unicode.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_unicode_combining_class_t of @unicode</doc>
        <type name="unicode_combining_class_t" c:type="hb_unicode_combining_class_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="unicode_combining_class_func_t" c:type="hb_unicode_combining_class_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_unicode_funcs_t structure.

This method should retrieve the Canonical Combining Class (ccc)
property for a specified Unicode code point.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_unicode_combining_class_t of @unicode</doc>
        <type name="unicode_combining_class_t" c:type="hb_unicode_combining_class_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <enumeration name="unicode_combining_class_t" c:type="hb_unicode_combining_class_t">
      <doc xml:space="preserve">Data type for the Canonical_Combining_Class (ccc) property
from the Unicode Character Database.

&lt;note&gt;Note: newer versions of Unicode may add new values.
Client programs should be ready to handle any value in the 0..254 range
being returned from hb_unicode_combining_class().&lt;/note&gt;</doc>
      <member name="not_reordered" value="0" c:identifier="HB_UNICODE_COMBINING_CLASS_NOT_REORDERED">
        <doc xml:space="preserve">Spacing and enclosing marks; also many vowel and consonant signs, even if nonspacing</doc>
      </member>
      <member name="overlay" value="1" c:identifier="HB_UNICODE_COMBINING_CLASS_OVERLAY">
        <doc xml:space="preserve">Marks which overlay a base letter or symbol</doc>
      </member>
      <member name="nukta" value="7" c:identifier="HB_UNICODE_COMBINING_CLASS_NUKTA">
        <doc xml:space="preserve">Diacritic nukta marks in Brahmi-derived scripts</doc>
      </member>
      <member name="kana_voicing" value="8" c:identifier="HB_UNICODE_COMBINING_CLASS_KANA_VOICING">
        <doc xml:space="preserve">Hiragana/Katakana voicing marks</doc>
      </member>
      <member name="virama" value="9" c:identifier="HB_UNICODE_COMBINING_CLASS_VIRAMA">
        <doc xml:space="preserve">Viramas</doc>
      </member>
      <member name="ccc10" value="10" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC10">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc11" value="11" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC11">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc12" value="12" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC12">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc13" value="13" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC13">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc14" value="14" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC14">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc15" value="15" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC15">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc16" value="16" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC16">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc17" value="17" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC17">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc18" value="18" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC18">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc19" value="19" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC19">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc20" value="20" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC20">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc21" value="21" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC21">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc22" value="22" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC22">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc23" value="23" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC23">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc24" value="24" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC24">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc25" value="25" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC25">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc26" value="26" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC26">
        <doc xml:space="preserve">[Hebrew]</doc>
      </member>
      <member name="ccc27" value="27" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC27">
        <doc xml:space="preserve">[Arabic]</doc>
      </member>
      <member name="ccc28" value="28" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC28">
        <doc xml:space="preserve">[Arabic]</doc>
      </member>
      <member name="ccc29" value="29" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC29">
        <doc xml:space="preserve">[Arabic]</doc>
      </member>
      <member name="ccc30" value="30" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC30">
        <doc xml:space="preserve">[Arabic]</doc>
      </member>
      <member name="ccc31" value="31" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC31">
        <doc xml:space="preserve">[Arabic]</doc>
      </member>
      <member name="ccc32" value="32" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC32">
        <doc xml:space="preserve">[Arabic]</doc>
      </member>
      <member name="ccc33" value="33" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC33">
        <doc xml:space="preserve">[Arabic]</doc>
      </member>
      <member name="ccc34" value="34" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC34">
        <doc xml:space="preserve">[Arabic]</doc>
      </member>
      <member name="ccc35" value="35" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC35">
        <doc xml:space="preserve">[Arabic]</doc>
      </member>
      <member name="ccc36" value="36" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC36">
        <doc xml:space="preserve">[Syriac]</doc>
      </member>
      <member name="ccc84" value="84" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC84">
        <doc xml:space="preserve">[Telugu]</doc>
      </member>
      <member name="ccc91" value="91" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC91">
        <doc xml:space="preserve">[Telugu]</doc>
      </member>
      <member name="ccc103" value="103" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC103">
        <doc xml:space="preserve">[Thai]</doc>
      </member>
      <member name="ccc107" value="107" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC107">
        <doc xml:space="preserve">[Thai]</doc>
      </member>
      <member name="ccc118" value="118" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC118">
        <doc xml:space="preserve">[Lao]</doc>
      </member>
      <member name="ccc122" value="122" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC122">
        <doc xml:space="preserve">[Lao]</doc>
      </member>
      <member name="ccc129" value="129" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC129">
        <doc xml:space="preserve">[Tibetan]</doc>
      </member>
      <member name="ccc130" value="130" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC130">
        <doc xml:space="preserve">[Tibetan]</doc>
      </member>
      <member name="ccc132" value="132" c:identifier="HB_UNICODE_COMBINING_CLASS_CCC132">
        <doc xml:space="preserve">[Tibetan] Since: 7.2.0</doc>
      </member>
      <member name="attached_below_left" value="200" c:identifier="HB_UNICODE_COMBINING_CLASS_ATTACHED_BELOW_LEFT">
        <doc xml:space="preserve">Marks attached at the bottom left</doc>
      </member>
      <member name="attached_below" value="202" c:identifier="HB_UNICODE_COMBINING_CLASS_ATTACHED_BELOW">
        <doc xml:space="preserve">Marks attached directly below</doc>
      </member>
      <member name="attached_above" value="214" c:identifier="HB_UNICODE_COMBINING_CLASS_ATTACHED_ABOVE">
        <doc xml:space="preserve">Marks attached directly above</doc>
      </member>
      <member name="attached_above_right" value="216" c:identifier="HB_UNICODE_COMBINING_CLASS_ATTACHED_ABOVE_RIGHT">
        <doc xml:space="preserve">Marks attached at the top right</doc>
      </member>
      <member name="below_left" value="218" c:identifier="HB_UNICODE_COMBINING_CLASS_BELOW_LEFT">
        <doc xml:space="preserve">Distinct marks at the bottom left</doc>
      </member>
      <member name="below" value="220" c:identifier="HB_UNICODE_COMBINING_CLASS_BELOW">
        <doc xml:space="preserve">Distinct marks directly below</doc>
      </member>
      <member name="below_right" value="222" c:identifier="HB_UNICODE_COMBINING_CLASS_BELOW_RIGHT">
        <doc xml:space="preserve">Distinct marks at the bottom right</doc>
      </member>
      <member name="left" value="224" c:identifier="HB_UNICODE_COMBINING_CLASS_LEFT">
        <doc xml:space="preserve">Distinct marks to the left</doc>
      </member>
      <member name="right" value="226" c:identifier="HB_UNICODE_COMBINING_CLASS_RIGHT">
        <doc xml:space="preserve">Distinct marks to the right</doc>
      </member>
      <member name="above_left" value="228" c:identifier="HB_UNICODE_COMBINING_CLASS_ABOVE_LEFT">
        <doc xml:space="preserve">Distinct marks at the top left</doc>
      </member>
      <member name="above" value="230" c:identifier="HB_UNICODE_COMBINING_CLASS_ABOVE">
        <doc xml:space="preserve">Distinct marks directly above</doc>
      </member>
      <member name="above_right" value="232" c:identifier="HB_UNICODE_COMBINING_CLASS_ABOVE_RIGHT">
        <doc xml:space="preserve">Distinct marks at the top right</doc>
      </member>
      <member name="double_below" value="233" c:identifier="HB_UNICODE_COMBINING_CLASS_DOUBLE_BELOW">
        <doc xml:space="preserve">Distinct marks subtending two bases</doc>
      </member>
      <member name="double_above" value="234" c:identifier="HB_UNICODE_COMBINING_CLASS_DOUBLE_ABOVE">
        <doc xml:space="preserve">Distinct marks extending above two bases</doc>
      </member>
      <member name="iota_subscript" value="240" c:identifier="HB_UNICODE_COMBINING_CLASS_IOTA_SUBSCRIPT">
        <doc xml:space="preserve">Greek iota subscript only</doc>
      </member>
      <member name="invalid" value="255" c:identifier="HB_UNICODE_COMBINING_CLASS_INVALID">
        <doc xml:space="preserve">Invalid combining class</doc>
      </member>
    </enumeration>
    <function name="unicode_compose" c:identifier="hb_unicode_compose" version="0.9.2">
      <doc xml:space="preserve">Fetches the composition of a sequence of two Unicode
code points.

Calls the composition function of the specified
Unicode-functions structure @ufuncs.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @a and @b composed, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="a" transfer-ownership="none">
          <doc xml:space="preserve">The first Unicode code point to compose</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="b" transfer-ownership="none">
          <doc xml:space="preserve">The second Unicode code point to compose</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="ab" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The composition of @a, @b</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="unicode_compose_func_t" c:type="hb_unicode_compose_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_unicode_funcs_t structure.

This method should compose a sequence of two input Unicode code
points by canonical equivalence, returning the composed code
point in a #hb_codepoint_t output parameter (if successful).
The method must return an #hb_bool_t indicating the success
of the composition.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` is @a,@b composed, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="a" transfer-ownership="none">
          <doc xml:space="preserve">The first code point to compose</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="b" transfer-ownership="none">
          <doc xml:space="preserve">The second code point to compose</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="ab" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The composed code point</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">user data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="unicode_decompose" c:identifier="hb_unicode_decompose" version="0.9.2">
      <doc xml:space="preserve">Fetches the decomposition of a Unicode code point.

Calls the decomposition function of the specified
Unicode-functions structure @ufuncs.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @ab was decomposed, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="ab" transfer-ownership="none">
          <doc xml:space="preserve">Unicode code point to decompose</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="a" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first code point of the decomposition of @ab</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="b" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The second code point of the decomposition of @ab</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_decompose_compatibility" c:identifier="hb_unicode_decompose_compatibility" version="0.9.2" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Fetches the compatibility decomposition of a Unicode
code point. Deprecated.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">length of @decomposed.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="u" transfer-ownership="none">
          <doc xml:space="preserve">Code point to decompose</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="decomposed" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">Compatibility decomposition of @u</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
      </parameters>
    </function>
    <callback name="unicode_decompose_compatibility_func_t" c:type="hb_unicode_decompose_compatibility_func_t" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Fully decompose @u to its Unicode compatibility decomposition. The codepoints of the decomposition will be written to @decomposed.
The complete length of the decomposition will be returned.

If @u has no compatibility decomposition, zero should be returned.

The Unicode standard guarantees that a buffer of length #HB_UNICODE_MAX_DECOMPOSITION_LEN codepoints will always be sufficient for any
compatibility decomposition plus an terminating value of 0.  Consequently, @decompose must be allocated by the caller to be at least this length.  Implementations
of this function type must ensure that they do not write past the provided array.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">number of codepoints in the full compatibility decomposition of @u, or 0 if no decomposition available.</doc>
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">a Unicode function structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="u" transfer-ownership="none">
          <doc xml:space="preserve">codepoint to decompose</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="decomposed" transfer-ownership="none">
          <doc xml:space="preserve">address of codepoint array (of length #HB_UNICODE_MAX_DECOMPOSITION_LEN) to write decomposition into</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
          <doc xml:space="preserve">user data pointer as passed to hb_unicode_funcs_set_decompose_compatibility_func()</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="unicode_decompose_func_t" c:type="hb_unicode_decompose_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_unicode_funcs_t structure.

This method should decompose an input Unicode code point,
returning the two decomposed code points in #hb_codepoint_t
output parameters (if successful). The method must return an
#hb_bool_t indicating the success of the composition.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @ab decomposed, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="ab" transfer-ownership="none">
          <doc xml:space="preserve">The code point to decompose</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="a" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The first decomposed code point</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="b" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">The second decomposed code point</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
          <doc xml:space="preserve">user data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="unicode_eastasian_width" c:identifier="hb_unicode_eastasian_width" version="0.9.2" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Don't use. Not used by HarfBuzz.</doc>
      <return-value transfer-ownership="none">
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">a Unicode-function structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="unicode_eastasian_width_func_t" c:type="hb_unicode_eastasian_width_func_t" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">A virtual method for the #hb_unicode_funcs_t structure.</doc>
      <return-value transfer-ownership="none">
        <type name="guint" c:type="unsigned int"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="unicode_funcs_create" c:identifier="hb_unicode_funcs_create" version="0.9.2">
      <doc xml:space="preserve">Creates a new #hb_unicode_funcs_t structure of Unicode functions.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The Unicode-functions structure</doc>
        <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
      </return-value>
      <parameters>
        <parameter name="parent" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Parent Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_destroy" c:identifier="hb_unicode_funcs_destroy" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Decreases the reference count on a Unicode-functions structure. When
the reference count reaches zero, the Unicode-functions structure is
destroyed, freeing all memory.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_get_default" c:identifier="hb_unicode_funcs_get_default" version="0.9.2">
      <doc xml:space="preserve">Fetches a pointer to the default Unicode-functions structure that is used
when no functions are explicitly set on #hb_buffer_t.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">a pointer to the #hb_unicode_funcs_t Unicode-functions structure</doc>
        <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
      </return-value>
    </function>
    <function name="unicode_funcs_get_empty" c:identifier="hb_unicode_funcs_get_empty" version="0.9.2">
      <doc xml:space="preserve">Fetches the singleton empty Unicode-functions structure.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The empty Unicode-functions structure</doc>
        <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
      </return-value>
    </function>
    <function name="unicode_funcs_get_parent" c:identifier="hb_unicode_funcs_get_parent" version="0.9.2">
      <doc xml:space="preserve">Fetches the parent of the Unicode-functions structure
@ufuncs.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The parent Unicode-functions structure</doc>
        <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_get_user_data" c:identifier="hb_unicode_funcs_get_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Fetches the user-data associated with the specified key,
attached to the specified Unicode-functions structure.</doc>
      <return-value transfer-ownership="none" nullable="1">
        <doc xml:space="preserve">A pointer to the user data</doc>
        <type name="gpointer" c:type="void*"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="const hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key to query</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_is_immutable" c:identifier="hb_unicode_funcs_is_immutable" version="0.9.2">
      <doc xml:space="preserve">Tests whether the specified Unicode-functions structure
is immutable.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @ufuncs is immutable, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_make_immutable" c:identifier="hb_unicode_funcs_make_immutable" version="0.9.2">
      <doc xml:space="preserve">Makes the specified Unicode-functions structure
immutable.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_reference" c:identifier="hb_unicode_funcs_reference" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Increases the reference count on a Unicode-functions structure.</doc>
      <return-value transfer-ownership="full">
        <doc xml:space="preserve">The Unicode-functions structure</doc>
        <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_set_combining_class_func" c:identifier="hb_unicode_funcs_set_combining_class_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_unicode_combining_class_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="unicode_combining_class_func_t" c:type="hb_unicode_combining_class_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_set_compose_func" c:identifier="hb_unicode_funcs_set_compose_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_unicode_compose_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="unicode_compose_func_t" c:type="hb_unicode_compose_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_set_decompose_compatibility_func" c:identifier="hb_unicode_funcs_set_decompose_compatibility_func" version="0.9.2" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_unicode_decompose_compatibility_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="unicode_decompose_compatibility_func_t" c:type="hb_unicode_decompose_compatibility_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_set_decompose_func" c:identifier="hb_unicode_funcs_set_decompose_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_unicode_decompose_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="unicode_decompose_func_t" c:type="hb_unicode_decompose_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_set_eastasian_width_func" c:identifier="hb_unicode_funcs_set_eastasian_width_func" version="0.9.2" deprecated="1" deprecated-version="2.0.0">
      <doc xml:space="preserve">Sets the implementation function for #hb_unicode_eastasian_width_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">a Unicode-function structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="unicode_eastasian_width_func_t" c:type="hb_unicode_eastasian_width_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_set_general_category_func" c:identifier="hb_unicode_funcs_set_general_category_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_unicode_general_category_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="unicode_general_category_func_t" c:type="hb_unicode_general_category_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_set_mirroring_func" c:identifier="hb_unicode_funcs_set_mirroring_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_unicode_mirroring_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="unicode_mirroring_func_t" c:type="hb_unicode_mirroring_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_set_script_func" c:identifier="hb_unicode_funcs_set_script_func" version="0.9.2">
      <doc xml:space="preserve">Sets the implementation function for #hb_unicode_script_func_t.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="func" transfer-ownership="none" scope="notified" closure="2" destroy="3">
          <doc xml:space="preserve">The callback function to assign</doc>
          <type name="unicode_script_func_t" c:type="hb_unicode_script_func_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">Data to pass to @func</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
          <doc xml:space="preserve">The function to call when @user_data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
      </parameters>
    </function>
    <function name="unicode_funcs_set_user_data" c:identifier="hb_unicode_funcs_set_user_data" version="0.9.2" introspectable="0">
      <doc xml:space="preserve">Attaches a user-data key/data pair to the specified Unicode-functions structure.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if success, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:space="preserve">The user-data key</doc>
          <type name="user_data_key_t" c:type="hb_user_data_key_t*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A pointer to the user data</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
        <parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1">
          <doc xml:space="preserve">A callback to call when @data is not needed anymore</doc>
          <type name="destroy_func_t" c:type="hb_destroy_func_t"/>
        </parameter>
        <parameter name="replace" transfer-ownership="none">
          <doc xml:space="preserve">Whether to replace an existing data with the same key</doc>
          <type name="bool_t" c:type="hb_bool_t"/>
        </parameter>
      </parameters>
    </function>
    <record name="unicode_funcs_t" c:type="hb_unicode_funcs_t" opaque="1" glib:type-name="hb_unicode_funcs_t" glib:get-type="hb_gobject_unicode_funcs_get_type" c:symbol-prefix="gobject_unicode_funcs">
      <doc xml:space="preserve">Data type containing a set of virtual methods used for
accessing various Unicode character properties.

HarfBuzz provides a default function for each of the
methods in #hb_unicode_funcs_t. Client programs can implement
their own replacements for the individual Unicode functions, as
needed, and replace the default by calling the setter for a
method.</doc>
    </record>
    <function name="unicode_general_category" c:identifier="hb_unicode_general_category" version="0.9.2">
      <doc xml:space="preserve">Retrieves the General Category (gc) property
of code point @unicode.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_unicode_general_category_t of @unicode</doc>
        <type name="unicode_general_category_t" c:type="hb_unicode_general_category_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="unicode_general_category_func_t" c:type="hb_unicode_general_category_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_unicode_funcs_t structure.

This method should retrieve the General Category property for
a specified Unicode code point.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_unicode_general_category_t of @unicode</doc>
        <type name="unicode_general_category_t" c:type="hb_unicode_general_category_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <enumeration name="unicode_general_category_t" c:type="hb_unicode_general_category_t">
      <doc xml:space="preserve">Data type for the "General_Category" (gc) property from
the Unicode Character Database.</doc>
      <member name="control" value="0" c:identifier="HB_UNICODE_GENERAL_CATEGORY_CONTROL">
        <doc xml:space="preserve">[Cc]</doc>
      </member>
      <member name="format" value="1" c:identifier="HB_UNICODE_GENERAL_CATEGORY_FORMAT">
        <doc xml:space="preserve">[Cf]</doc>
      </member>
      <member name="unassigned" value="2" c:identifier="HB_UNICODE_GENERAL_CATEGORY_UNASSIGNED">
        <doc xml:space="preserve">[Cn]</doc>
      </member>
      <member name="private_use" value="3" c:identifier="HB_UNICODE_GENERAL_CATEGORY_PRIVATE_USE">
        <doc xml:space="preserve">[Co]</doc>
      </member>
      <member name="surrogate" value="4" c:identifier="HB_UNICODE_GENERAL_CATEGORY_SURROGATE">
        <doc xml:space="preserve">[Cs]</doc>
      </member>
      <member name="lowercase_letter" value="5" c:identifier="HB_UNICODE_GENERAL_CATEGORY_LOWERCASE_LETTER">
        <doc xml:space="preserve">[Ll]</doc>
      </member>
      <member name="modifier_letter" value="6" c:identifier="HB_UNICODE_GENERAL_CATEGORY_MODIFIER_LETTER">
        <doc xml:space="preserve">[Lm]</doc>
      </member>
      <member name="other_letter" value="7" c:identifier="HB_UNICODE_GENERAL_CATEGORY_OTHER_LETTER">
        <doc xml:space="preserve">[Lo]</doc>
      </member>
      <member name="titlecase_letter" value="8" c:identifier="HB_UNICODE_GENERAL_CATEGORY_TITLECASE_LETTER">
        <doc xml:space="preserve">[Lt]</doc>
      </member>
      <member name="uppercase_letter" value="9" c:identifier="HB_UNICODE_GENERAL_CATEGORY_UPPERCASE_LETTER">
        <doc xml:space="preserve">[Lu]</doc>
      </member>
      <member name="spacing_mark" value="10" c:identifier="HB_UNICODE_GENERAL_CATEGORY_SPACING_MARK">
        <doc xml:space="preserve">[Mc]</doc>
      </member>
      <member name="enclosing_mark" value="11" c:identifier="HB_UNICODE_GENERAL_CATEGORY_ENCLOSING_MARK">
        <doc xml:space="preserve">[Me]</doc>
      </member>
      <member name="non_spacing_mark" value="12" c:identifier="HB_UNICODE_GENERAL_CATEGORY_NON_SPACING_MARK">
        <doc xml:space="preserve">[Mn]</doc>
      </member>
      <member name="decimal_number" value="13" c:identifier="HB_UNICODE_GENERAL_CATEGORY_DECIMAL_NUMBER">
        <doc xml:space="preserve">[Nd]</doc>
      </member>
      <member name="letter_number" value="14" c:identifier="HB_UNICODE_GENERAL_CATEGORY_LETTER_NUMBER">
        <doc xml:space="preserve">[Nl]</doc>
      </member>
      <member name="other_number" value="15" c:identifier="HB_UNICODE_GENERAL_CATEGORY_OTHER_NUMBER">
        <doc xml:space="preserve">[No]</doc>
      </member>
      <member name="connect_punctuation" value="16" c:identifier="HB_UNICODE_GENERAL_CATEGORY_CONNECT_PUNCTUATION">
        <doc xml:space="preserve">[Pc]</doc>
      </member>
      <member name="dash_punctuation" value="17" c:identifier="HB_UNICODE_GENERAL_CATEGORY_DASH_PUNCTUATION">
        <doc xml:space="preserve">[Pd]</doc>
      </member>
      <member name="close_punctuation" value="18" c:identifier="HB_UNICODE_GENERAL_CATEGORY_CLOSE_PUNCTUATION">
        <doc xml:space="preserve">[Pe]</doc>
      </member>
      <member name="final_punctuation" value="19" c:identifier="HB_UNICODE_GENERAL_CATEGORY_FINAL_PUNCTUATION">
        <doc xml:space="preserve">[Pf]</doc>
      </member>
      <member name="initial_punctuation" value="20" c:identifier="HB_UNICODE_GENERAL_CATEGORY_INITIAL_PUNCTUATION">
        <doc xml:space="preserve">[Pi]</doc>
      </member>
      <member name="other_punctuation" value="21" c:identifier="HB_UNICODE_GENERAL_CATEGORY_OTHER_PUNCTUATION">
        <doc xml:space="preserve">[Po]</doc>
      </member>
      <member name="open_punctuation" value="22" c:identifier="HB_UNICODE_GENERAL_CATEGORY_OPEN_PUNCTUATION">
        <doc xml:space="preserve">[Ps]</doc>
      </member>
      <member name="currency_symbol" value="23" c:identifier="HB_UNICODE_GENERAL_CATEGORY_CURRENCY_SYMBOL">
        <doc xml:space="preserve">[Sc]</doc>
      </member>
      <member name="modifier_symbol" value="24" c:identifier="HB_UNICODE_GENERAL_CATEGORY_MODIFIER_SYMBOL">
        <doc xml:space="preserve">[Sk]</doc>
      </member>
      <member name="math_symbol" value="25" c:identifier="HB_UNICODE_GENERAL_CATEGORY_MATH_SYMBOL">
        <doc xml:space="preserve">[Sm]</doc>
      </member>
      <member name="other_symbol" value="26" c:identifier="HB_UNICODE_GENERAL_CATEGORY_OTHER_SYMBOL">
        <doc xml:space="preserve">[So]</doc>
      </member>
      <member name="line_separator" value="27" c:identifier="HB_UNICODE_GENERAL_CATEGORY_LINE_SEPARATOR">
        <doc xml:space="preserve">[Zl]</doc>
      </member>
      <member name="paragraph_separator" value="28" c:identifier="HB_UNICODE_GENERAL_CATEGORY_PARAGRAPH_SEPARATOR">
        <doc xml:space="preserve">[Zp]</doc>
      </member>
      <member name="space_separator" value="29" c:identifier="HB_UNICODE_GENERAL_CATEGORY_SPACE_SEPARATOR">
        <doc xml:space="preserve">[Zs]</doc>
      </member>
    </enumeration>
    <function name="unicode_mirroring" c:identifier="hb_unicode_mirroring" version="0.9.2">
      <doc xml:space="preserve">Retrieves the Bi-directional Mirroring Glyph code
point defined for code point @unicode.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_codepoint_t of the Mirroring Glyph for @unicode</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="unicode_mirroring_func_t" c:type="hb_unicode_mirroring_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_unicode_funcs_t structure.

This method should retrieve the Bi-Directional Mirroring Glyph
code point for a specified Unicode code point.

&lt;note&gt;Note: If a code point does not have a specified
Bi-Directional Mirroring Glyph defined, the method should
return the original code point.&lt;/note&gt;</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_codepoint_t of the Mirroring Glyph for @unicode</doc>
        <type name="codepoint_t" c:type="hb_codepoint_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <function name="unicode_script" c:identifier="hb_unicode_script" version="0.9.2">
      <doc xml:space="preserve">Retrieves the #hb_script_t script to which code
point @unicode belongs.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_script_t of @unicode</doc>
        <type name="script_t" c:type="hb_script_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">The Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
      </parameters>
    </function>
    <callback name="unicode_script_func_t" c:type="hb_unicode_script_func_t">
      <doc xml:space="preserve">A virtual method for the #hb_unicode_funcs_t structure.

This method should retrieve the Script property for a
specified Unicode code point.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">The #hb_script_t of @unicode</doc>
        <type name="script_t" c:type="hb_script_t"/>
      </return-value>
      <parameters>
        <parameter name="ufuncs" transfer-ownership="none">
          <doc xml:space="preserve">A Unicode-functions structure</doc>
          <type name="unicode_funcs_t" c:type="hb_unicode_funcs_t*"/>
        </parameter>
        <parameter name="unicode" transfer-ownership="none">
          <doc xml:space="preserve">The code point to query</doc>
          <type name="codepoint_t" c:type="hb_codepoint_t"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
          <doc xml:space="preserve">User data pointer passed by the caller</doc>
          <type name="gpointer" c:type="void*"/>
        </parameter>
      </parameters>
    </callback>
    <record name="user_data_key_t" c:type="hb_user_data_key_t" glib:type-name="hb_user_data_key_t" glib:get-type="hb_gobject_user_data_key_get_type" c:symbol-prefix="gobject_user_data_key">
      <doc xml:space="preserve">Data structure for holding user-data keys.</doc>
      <field name="unused" readable="0" private="1">
        <type name="gchar" c:type="char"/>
      </field>
    </record>
    <union name="var_int_t" c:type="hb_var_int_t">
      <field name="u32" writable="1">
        <type name="guint32" c:type="uint32_t"/>
      </field>
      <field name="i32" writable="1">
        <type name="gint32" c:type="int32_t"/>
      </field>
      <field name="u16" writable="1">
        <array zero-terminated="0" fixed-size="2">
          <type name="guint16" c:type="uint16_t"/>
        </array>
      </field>
      <field name="i16" writable="1">
        <array zero-terminated="0" fixed-size="2">
          <type name="gint16" c:type="int16_t"/>
        </array>
      </field>
      <field name="u8" writable="1">
        <array zero-terminated="0" fixed-size="4">
          <type name="guint8" c:type="uint8_t"/>
        </array>
      </field>
      <field name="i8" writable="1">
        <array zero-terminated="0" fixed-size="4">
          <type name="gint8" c:type="int8_t"/>
        </array>
      </field>
    </union>
    <union name="var_num_t" c:type="hb_var_num_t">
      <field name="f" writable="1">
        <type name="gfloat" c:type="float"/>
      </field>
      <field name="u32" writable="1">
        <type name="guint32" c:type="uint32_t"/>
      </field>
      <field name="i32" writable="1">
        <type name="gint32" c:type="int32_t"/>
      </field>
      <field name="u16" writable="1">
        <array zero-terminated="0" fixed-size="2">
          <type name="guint16" c:type="uint16_t"/>
        </array>
      </field>
      <field name="i16" writable="1">
        <array zero-terminated="0" fixed-size="2">
          <type name="gint16" c:type="int16_t"/>
        </array>
      </field>
      <field name="u8" writable="1">
        <array zero-terminated="0" fixed-size="4">
          <type name="guint8" c:type="uint8_t"/>
        </array>
      </field>
      <field name="i8" writable="1">
        <array zero-terminated="0" fixed-size="4">
          <type name="gint8" c:type="int8_t"/>
        </array>
      </field>
    </union>
    <function name="variation_from_string" c:identifier="hb_variation_from_string" version="1.4.2">
      <doc xml:space="preserve">Parses a string into a #hb_variation_t.

The format for specifying variation settings follows. All valid CSS
font-variation-settings values other than 'normal' and 'inherited' are also
accepted, though, not documented below.

The format is a tag, optionally followed by an equals sign, followed by a
number. For example `wght=500`, or `slnt=-7.5`.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">`true` if @str is successfully parsed, `false` otherwise</doc>
        <type name="bool_t" c:type="hb_bool_t"/>
      </return-value>
      <parameters>
        <parameter name="str" transfer-ownership="none">
          <doc xml:space="preserve">a string to parse</doc>
          <array length="1" zero-terminated="0" c:type="const char*">
            <type name="guint8"/>
          </array>
        </parameter>
        <parameter name="len" transfer-ownership="none">
          <doc xml:space="preserve">length of @str, or -1 if string is `NULL` terminated</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="variation" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">the #hb_variation_t to initialize with the parsed values</doc>
          <type name="variation_t" c:type="hb_variation_t*"/>
        </parameter>
      </parameters>
    </function>
    <record name="variation_t" c:type="hb_variation_t" version="1.4.2">
      <doc xml:space="preserve">Data type for holding variation data. Registered OpenType
variation-axis tags are listed in
[OpenType Axis Tag Registry](https://docs.microsoft.com/en-us/typography/opentype/spec/dvaraxisreg).</doc>
      <field name="tag" writable="1">
        <doc xml:space="preserve">The #hb_tag_t tag of the variation-axis name</doc>
        <type name="tag_t" c:type="hb_tag_t"/>
      </field>
      <field name="value" writable="1">
        <doc xml:space="preserve">The value of the variation axis</doc>
        <type name="gfloat" c:type="float"/>
      </field>
      <method name="_string" c:identifier="hb_variation_to_string" moved-to="variation_to_string" version="1.4.2">
        <doc xml:space="preserve">Converts an #hb_variation_t into a `NULL`-terminated string in the format
understood by hb_variation_from_string(). The client in responsible for
allocating big enough size for @buf, 128 bytes is more than enough.

Note that the string won't include any whitespace.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="variation" transfer-ownership="none">
            <doc xml:space="preserve">an #hb_variation_t to convert</doc>
            <type name="variation_t" c:type="hb_variation_t*"/>
          </instance-parameter>
          <parameter name="buf" direction="out" caller-allocates="1" transfer-ownership="none">
            <doc xml:space="preserve">output string</doc>
            <array length="1" zero-terminated="0" c:type="char*">
              <type name="utf8" c:type="char"/>
            </array>
          </parameter>
          <parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
            <doc xml:space="preserve">the allocated size of @buf</doc>
            <type name="guint" c:type="unsigned int"/>
          </parameter>
        </parameters>
      </method>
    </record>
    <function name="variation_to_string" c:identifier="hb_variation_to_string" version="1.4.2">
      <doc xml:space="preserve">Converts an #hb_variation_t into a `NULL`-terminated string in the format
understood by hb_variation_from_string(). The client in responsible for
allocating big enough size for @buf, 128 bytes is more than enough.

Note that the string won't include any whitespace.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="variation" transfer-ownership="none">
          <doc xml:space="preserve">an #hb_variation_t to convert</doc>
          <type name="variation_t" c:type="hb_variation_t*"/>
        </parameter>
        <parameter name="buf" direction="out" caller-allocates="1" transfer-ownership="none">
          <doc xml:space="preserve">output string</doc>
          <array length="2" zero-terminated="0" c:type="char*">
            <type name="utf8" c:type="char"/>
          </array>
        </parameter>
        <parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
          <doc xml:space="preserve">the allocated size of @buf</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
      </parameters>
    </function>
  </namespace>
</repository>
