hinting.conf

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>


    <description>Sets most appropriate hinting for specific fonts</description>


    <!-- Checked with FreeType 2.10.4 and default settings. -->

    <!-- Enables BCI (the bytecode-interpreter) for well-hinted fonts. Also,
         makes sure it is disabled where the results are worse with BCI. More
         at https://www.freetype.org/freetype2/docs/hinting/hinting.html. -->


    <!-- Overall, slightly worse with hintfull. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Archivo Black</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Bitter</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <!-- Hintfull distorts lower case letters at smallest antialiased sizes. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Cabin</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <!-- Enabling BCI results in lots of artifacts. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Charis SIL</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <!-- Matthew Butterick's Charter font files. An older version (from 2013?)
         has better hinting, but BCI is still problematic at some sizes. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Charter</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Cinzel</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <!-- Hintfull distorts lower case letters at around 16 pt. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Code New Roman</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Comic Relief</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <!-- URW fonts have distorted shapes with hintfull. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>D050000L</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>P052</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Standard Symbols PS</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>URW Gothic</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <!-- Distorted with hintfull. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>DejaVu Serif</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>EB Garamond</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <!-- Distorted with hintfull. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Inconsolata</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <!-- Slightly worse with hintfull. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Garamond Libre</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Gentium Plus</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Liberation Mono</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Liberation Sans</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Liberation Serif</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <!-- Small improvements. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Libre Baskerville</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <!-- No differences with hintfull? -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Lingua Franca</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <!-- Enabling BCI gives some artifacts. Lucida Bright looks uneven. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Lucida Bright</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Lucida Sans</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Lucida Sans Typewriter</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Luculent</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Kaushan Script</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <!-- Very small improvements. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Miju Goudy</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Noto Mono</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Oswald</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>PT Mono</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>PT Sans</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>PT Sans Caption</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>PT Sans Narrow</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>PT Serif</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>PT Serif Caption</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <!-- The hinted variants are generated with Fontographer, according to
         https://lists.fedoraproject.org/pipermail/devel/2015-March/208795.html,
         and apparently, FreeType has issues interpreting these hints. -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Symbola</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Musica</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Unidings</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintslight</const>
        </edit>
    </match>

    <!-- Is Wine's Tahoma metric compatibility broken by this? -->
    <match target="font">
        <test name="family" compare="eq" ignore-blanks="true">
            <string>Tahoma</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>

    <match target="font">
        <test name="family" compare="contains">
            <string>Ubuntu</string>
        </test>
        <edit name="hintstyle" mode="assign">
            <const>hintfull</const>
        </edit>
    </match>


</fontconfig>