Fontconfig

The library  is intended to provide uniform font selection and configuration amongst all GUI applications. Although it is common for a desktop environment to provide its own font overrides and configuration utilities, is still the underlying library.

Installing
When is needed, it will almost certainly be installed already. If not, make sure to set up the graphical subsystem (i.e., X or Wayland) and desktop environment properly.

USE flags
doesn't know many USE flags.

Generic
uses XML files in the directory to generate its internal configuration. By default it parses (users should not edit this file!) which sets some sane defaults and usually contains code to also parse  content. In addition there is the directory that contains various possible configuration files that each cover some aspect of. It's customary to symlink necessary files to. These files are executed in order they are named; for this reason their names start with a two digit number with the first digit (tens) indicating what the file affects (called the class).

Gentoo specific
Gentoo ships an eselect module that does exactly what was described in generic way - it manages symlinks of files in  by adding or removing them from the  directory. For obvious reasons changing system wide configuration requires appropriate permissions.

The following subsections explain how to deal with the eselect module.

Listing available files
The command shows the available  files, and marks the enabled ones with an asterisk.

Enabling a file
Files can be enabled either by filename or by the number in brackets. These two do the same thing:

Disabling a file
Files can be disabled likewise:

Custom system wide configuration
To create a custom, system-wide file, enable  and create  (this is an XML file).

To be clear, this says that when it comes to sans-serif fonts, we prefer using Ubuntu, TakaoPGothic, and Droid Sans fonts (in that order) over DejaVu Sans (which can be used as a default choice only when necessary). Obviously, different choices can be made here.

Per-user configuration
To create per-user files, enable  (which might be enabled by default), and have the end users use the  file. This file has the same XML format as.

Checking configuration
Check the default font replacement, for example for Arial, by typing:

Anti-aliasing, hinting, and sub-pixel rendering
Rendering aspects can be tuned as well. In the following sections the Anti-aliasing, Hinting and Sub-pixel rendering features are tuned.

Forcing hinting
The default behavior regarding hinting is rather undocumented, but it can be made deterministically sub-optimal by making a system wide default.


 * 1) First enable
 * 2) Edit the  file to include full hinting by default

This snippet enables full hinting:

Using sub-pixel rendering
It's important to determine the sub-pixel layout of the LCD matrix. It's usually RGB but the only way to be sure is to either consult display specification or use this sub-pixel layout test to determine it.

Once determined, enable the appropriate file.

It's strongly advised that, if available, is used with sub-pixel rendering. It comes in different varieties but the default should be appropriate for all common fonts.

Regarding autohinter
Autohinter attempts to do automatic hinting disregarding any existing hinting information. Until recently it was the default because TrueType2 was covered by patents but now that they have expired there's very little reason to use it. From technical point of view it does better than broken or no hinting information but it will be strongly sub-optimal for fonts with good hinting information. Generally system fonts are of the second kind so autohinter should not be used.

Infinality
Infinality is a (somewhat controversial) set of patches for FreeType and accompanying files. The goal of Infinality is to provide higher quality font rendering including emulation of other OS font rendering styles.

Enabling Infinality
Enable the 'infinality' USE flag by editing either manually or by using the  tool.

Next, rebuild the affected programs.

Unless messages shown after rebuild tell otherwise, enable.

Configuring Infinality
Infinality can be configured in various ways including custom configurations, but easiest is to use pre-made profiles shipped in that along with eselect modules should have been installed as dependencies of the   USE flag.

Quick and reasonable config
It's also recommended to disable all settings except for  as they interfere with the rendering of infinality styles:

Certain settings do not interfere with how the fonts are rendered, but rather determine the default fonts for font-types (such as Monospace, sans-serif, etc.). Such settings (for example the configurations) can be left enabled.

Explanation
Infinality provides FreeType environment variables that can be used to configure features introduced with its patches as well as files to be used with these changes. file sets are administrated on Gentoo via while the FreeType behaviour is set using.

These eselect modules function as usual:


 * Listing available file sets.


 * Listing available FreeType variable sets.


 * Both sets should match of course except when there are multiple matches possible such as shown below.

Picking fonts
Choosing the right font can be trickier than deciding on the right hinting type. For one reason or another, some fonts will never be perfect — but it's certainly possible to make them look better than, say, the Windows 7 default font configuration.

Here are some recommendations regarding well known fonts in Gentoo:

Fontconfig warnings and errors
Fontconfig warning: line 5: unknown element "its:rules" Fontconfig warning: line 6: unknown element "its:translateRule" Fontconfig error: line 6: invalid attribute 'translate' Fontconfig error: line 6: invalid attribute 'selector' Fontconfig error: line 7: invalid attribute 'xmlns:its' Fontconfig error: line 7: invalid attribute 'version' Fontconfig warning: line 9: unknown element "description" Fontconfig error: Cannot load default config file

Unknown.. Bug? Kreyren (talk) 23:50, 30 September 2018 (UTC)

External resources

 * In-depth articles from Arch Linux wiki on:
 * Font configuration
 * Infinality
 * Official documentation for users
 * Wikipedia article on font hinting