Functions
=========

.. currentmodule:: gi.repository.PangoOT



.. function:: tag_from_language(language: ~gi.repository.Pango.Language | None = None) -> int

   Finds the OpenType language-system tag best describing ``language``.



   .. versionadded:: 1.18





   :param language: A ``PangoLanguage``



   :return: ``PangoOTTag`` best matching ``language`` or
      ``%PANGO_OT_TAG_DEFAULT_LANGUAGE`` if none found or if ``language``
      is :const:`None`.





.. function:: tag_from_script(script: ~gi.repository.Pango.Script) -> int

   Finds the OpenType script tag corresponding to ``script``.

   The ``%PANGO_SCRIPT_COMMON``, ``%PANGO_SCRIPT_INHERITED``, and
   ``%PANGO_SCRIPT_UNKNOWN`` scripts are mapped to the OpenType
   'DFLT' script tag that is also defined as
   ``%PANGO_OT_TAG_DEFAULT_SCRIPT``.

   Note that multiple ``PangoScript`` values may map to the same
   OpenType script tag.  In particular, ``%PANGO_SCRIPT_HIRAGANA``
   and ``%PANGO_SCRIPT_KATAKANA`` both map to the OT tag 'kana'.



   .. versionadded:: 1.18





   :param script: A ``PangoScript``



   :return: ``PangoOTTag`` corresponding to ``script`` or
      ``%PANGO_OT_TAG_DEFAULT_SCRIPT`` if none found.





.. function:: tag_to_language(language_tag: int) -> ~gi.repository.Pango.Language

   Finds a ``PangoLanguage`` corresponding to ``language_tag``.



   .. versionadded:: 1.18





   :param language_tag: A ``PangoOTTag`` OpenType language-system tag



   :return: ``PangoLanguage`` best matching ``language_tag`` or
      ``PangoLanguage`` corresponding to the string "xx" if none found.





.. function:: tag_to_script(script_tag: int) -> ~gi.repository.Pango.Script

   Finds the ``PangoScript`` corresponding to ``script_tag``.

   The 'DFLT' script tag is mapped to ``%PANGO_SCRIPT_COMMON``.

   Note that an OpenType script tag may correspond to multiple
   ``PangoScript`` values.  In such cases, the ``PangoScript`` value
   with the smallest value is returned.
   In particular, ``%PANGO_SCRIPT_HIRAGANA``
   and ``%PANGO_SCRIPT_KATAKANA`` both map to the OT tag 'kana'.
   This function will return ``%PANGO_SCRIPT_HIRAGANA`` for
   'kana'.



   .. versionadded:: 1.18





   :param script_tag: A ``PangoOTTag`` OpenType script tag



   :return: ``PangoScript`` corresponding to ``script_tag`` or
      ``%PANGO_SCRIPT_UNKNOWN`` if none found.