

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  <title>Font substitution &mdash; libgdtl latest documentation</title>
  

  
  
  
  

  
  <script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
  
    
      <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
        <script type="text/javascript" src="../_static/jquery.js"></script>
        <script type="text/javascript" src="../_static/underscore.js"></script>
        <script type="text/javascript" src="../_static/doctools.js"></script>
        <script type="text/javascript" src="../_static/language_data.js"></script>
    
    <script type="text/javascript" src="../_static/js/theme.js"></script>

    

  
  <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
  <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="Rich text typesetting" href="rich_text_typesetting.html" />
    <link rel="prev" title="Installation" href="installation.html" /> 
</head>

<body class="wy-body-for-nav">

   
  <div class="wy-grid-for-nav">
    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search" >
          

          
            <a href="../index.html">
          

          
            
            <img src="../_static/docs_logo.png" class="logo" alt="Logo"/>
          
          </a>

          
            
            
              <div class="version">
                latest
              </div>
            
          

          
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>

          
        </div>

        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
            
              
            
            
              <p class="caption"><span class="caption-text">General</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../about/index.html">libgdtl introduction</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../about/index.html#dependencies">Dependencies</a></li>
<li class="toctree-l2"><a class="reference internal" href="../about/index.html#compiling-as-builtin-module">Compiling (as builtin module)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../about/index.html#build-options">Build options</a></li>
<li class="toctree-l3"><a class="reference internal" href="../about/index.html#building-libdgtl-module">Building <cite>libdgtl</cite> module</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../about/index.html#compiling-as-gdnative-module">Compiling (as gdnative module)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../about/index.html#id1">Build options</a></li>
<li class="toctree-l3"><a class="reference internal" href="../about/index.html#building-godot-cpp-static-library">Building <cite>godot-cpp</cite> static library</a></li>
<li class="toctree-l3"><a class="reference internal" href="../about/index.html#id2">Building <cite>libdgtl</cite> module</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../about/index.html#license">License</a></li>
<li class="toctree-l2"><a class="reference internal" href="../about/index.html#demo-data">Demo data</a></li>
</ul>
</li>
</ul>
<p class="caption"><span class="caption-text">Getting started</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a><ul>
<li class="toctree-l2"><a class="reference internal" href="installation.html#module">Module</a></li>
<li class="toctree-l2"><a class="reference internal" href="installation.html#gdnative">GDNative</a></li>
</ul>
</li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Font substitution</a></li>
<li class="toctree-l1"><a class="reference internal" href="rich_text_typesetting.html">Rich text typesetting</a><ul>
<li class="toctree-l2"><a class="reference internal" href="rich_text_typesetting.html#setting-formatting-for-the-range-of-text">Setting formatting for the range of text</a></li>
<li class="toctree-l2"><a class="reference internal" href="rich_text_typesetting.html#removing-formatting">Removing formatting</a></li>
<li class="toctree-l2"><a class="reference internal" href="rich_text_typesetting.html#embedding-child-control-into-the-text-flow">Embedding child control into the text flow</a></li>
</ul>
</li>
</ul>
<p class="caption"><span class="caption-text">Development</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../development/compiling_desktop.html">Compiling GDNative module for Windows, macOS and Linux</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_desktop.html#requirements">Requirements</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_desktop.html#building-godot-cpp-static-library">Building <cite>godot-cpp</cite> static library</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_desktop.html#building-libgdtl-static-library-and-built-in-dependencies">Building <cite>libgdtl</cite> static library and built-in dependencies</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../development/compiling_android.html">Compiling GDNative module for Android</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_android.html#requirements">Requirements</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_android.html#building-godot-cpp-static-library">Building <cite>godot-cpp</cite> static library</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_android.html#building-libgdtl-static-library-and-built-in-dependencies">Building <cite>libgdtl</cite> static library and built-in dependencies</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../development/compiling_ios.html">Compiling GDNative module for iOS</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_ios.html#requirements">Requirements</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_ios.html#building-godot-cpp-static-library">Building <cite>godot-cpp</cite> static library</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_ios.html#building-libgdtl-static-library-and-built-in-dependencies">Building <cite>libgdtl</cite> static library and built-in dependencies</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/compiling_ios.html#adding-libgdtl-static-library-to-the-exported-xcode-project">Adding <cite>libgdtl</cite> static library to the exported Xcode project</a></li>
</ul>
</li>
</ul>
<p class="caption"><span class="caption-text">Class reference</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../classes/index.html">libgdtl API</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlbitmapfontface.html">TLBitmapFontFace</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlbitmapfontface.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlbitmapfontface.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlbitmapfontface.html#description">Description</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tldynamicfontface.html">TLDynamicFontFace</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tldynamicfontface.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tldynamicfontface.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tldynamicfontface.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tldynamicfontface.html#enumerations">Enumerations</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tldynamicfontface.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tldynamicfontface.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlfontface.html">TLFontFace</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontface.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontface.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontface.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontface.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontface.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlfontfamily.html">TLFontFamily</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontfamily.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontfamily.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontfamily.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontfamily.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontfamily.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlfontiterator.html">TLFontIterator</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontiterator.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontiterator.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlfontiterator.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlgdfontwrapper.html">TLGDFontWrapper</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlgdfontwrapper.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlgdfontwrapper.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlgdfontwrapper.html#description">Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlgdfontwrapper.html#property-descriptions">Property Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlicudataloader.html">TLICUDataLoader</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlicudataloader.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlicudataloader.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlicudataloader.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlicudataloader.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlicudataloader.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tllabel.html">TLLabel</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllabel.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllabel.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllabel.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllabel.html#enumerations">Enumerations</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllabel.html#description">Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllabel.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllabel.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tllineedit.html">TLLineEdit</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllineedit.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllineedit.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllineedit.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllineedit.html#signals">Signals</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllineedit.html#enumerations">Enumerations</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllineedit.html#description">Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllineedit.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tllineedit.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlrichtextedit.html">TLRichTextEdit</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtextedit.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtextedit.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtextedit.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtextedit.html#signals">Signals</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtextedit.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtextedit.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlrichtexteditselection.html">TLRichTextEditSelection</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtexteditselection.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtexteditselection.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtexteditselection.html#signals">Signals</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlrichtexteditselection.html#property-descriptions">Property Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlshapedattributedstring.html">TLShapedAttributedString</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedattributedstring.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedattributedstring.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedattributedstring.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedattributedstring.html#enumerations">Enumerations</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedattributedstring.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedattributedstring.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlshapedparagraph.html">TLShapedParagraph</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedparagraph.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedparagraph.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedparagraph.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedparagraph.html#signals">Signals</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedparagraph.html#enumerations">Enumerations</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedparagraph.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedparagraph.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../classes/class_tlshapedstring.html">TLShapedString</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedstring.html#brief-description">Brief Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedstring.html#properties">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedstring.html#methods">Methods</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedstring.html#signals">Signals</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedstring.html#enumerations">Enumerations</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedstring.html#description">Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedstring.html#property-descriptions">Property Descriptions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../classes/class_tlshapedstring.html#method-descriptions">Method Descriptions</a></li>
</ul>
</li>
</ul>
</li>
</ul>

            
          
        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" aria-label="top navigation">
        
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../index.html">libgdtl</a>
        
      </nav>


      <div class="wy-nav-content">
        
        <div class="rst-content">
        
          















<div role="navigation" aria-label="breadcrumbs navigation">

  <ul class="wy-breadcrumbs">
    
      <li><a href="../index.html">Docs</a> &raquo;</li>
        
      <li>Font substitution</li>
    
    


      <li class="wy-breadcrumbs-aside">
        
            
        
      </li>
    


  </ul>

  
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <div class="section" id="font-substitution">
<span id="doc-font-substitution"></span><h1>Font substitution<a class="headerlink" href="#font-substitution" title="Permalink to this headline">¶</a></h1>
<p>Font substitution is used to find a replacement for an unavailable character.</p>
<p>In addition to main list of the substitution fonts, you can specify preferred fonts for the script (writing system) and language.</p>
<p>Use <a class="reference external" href="https://en.wikipedia.org/wiki/ISO_639-1">ISO 639-1</a> codes for the language names, and <a class="reference external" href="https://en.wikipedia.org/wiki/ISO_15924">ISO 15924</a> for the script names.</p>
<p>Substitution lists have following priority: <cite>Language</cite>, <cite>Script</cite>, <cite>Main List</cite>. Providing script and language information is not required, module will try to detect script (but not the language) automatically, but detection is not always successful and correct. Manual config can improve shaping speed if large number of fonts used.</p>
<img alt="../_images/font_inspector.png" src="../_images/font_inspector.png" />
</div>


           </div>
           
          </div>
          <footer>
  
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
      
        <a href="rich_text_typesetting.html" class="btn btn-neutral float-right" title="Rich text typesetting" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
      
      
        <a href="installation.html" class="btn btn-neutral float-left" title="Installation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
      
    </div>
  

  <hr/>

  <div role="contentinfo">
    <p>

    </p>
  </div>
  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 

</footer>

        </div>
      </div>

    </section>

  </div>
  


  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script>

  
  
    
   

</body>
</html>