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.