Reformat documentation into sgml for docbook, split into user/devel guides
This commit is contained in:
Keith Packard
parent
df43986cdc
commit
584ac89a01
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,559 @@
|
||||||
|
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
|
||||||
|
<!--
|
||||||
|
$Id$
|
||||||
|
|
||||||
|
Copyright © 2003 Keith Packard
|
||||||
|
|
||||||
|
Permission to use, copy, modify, distribute, and sell this software and its
|
||||||
|
documentation for any purpose is hereby granted without fee, provided that
|
||||||
|
the above copyright notice appear in all copies and that both that
|
||||||
|
copyright notice and this permission notice appear in supporting
|
||||||
|
documentation, and that the name of Keith Packard not be used in
|
||||||
|
advertising or publicity pertaining to distribution of the software without
|
||||||
|
specific, written prior permission. Keith Packard makes no
|
||||||
|
representations about the suitability of this software for any purpose. It
|
||||||
|
is provided "as is" without express or implied warranty.
|
||||||
|
|
||||||
|
KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
||||||
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
||||||
|
EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
||||||
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
||||||
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
||||||
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
||||||
|
PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
-->
|
||||||
|
<article>
|
||||||
|
<artheader>
|
||||||
|
<title>Fontconfig Users Guide</title>
|
||||||
|
<titleabbrev>Fontconfig</titleabbrev>
|
||||||
|
<author><firstname>Keith</><surname>Packard</></author>
|
||||||
|
<authorinitials>krp</authorinitials>
|
||||||
|
</artheader>
|
||||||
|
<sect1><title>NAME</title>
|
||||||
|
<para>
|
||||||
|
fontconfig - Font configuration and customization library
|
||||||
|
</para>
|
||||||
|
</sect1>
|
||||||
|
<sect1><title>DESCRIPTION</title>
|
||||||
|
<para>
|
||||||
|
Fontconfig is a library designed to provide system-wide font configuration,
|
||||||
|
customization and application access.
|
||||||
|
</para>
|
||||||
|
</sect1>
|
||||||
|
<sect1><title>FUNCTIONAL OVERVIEW</title>
|
||||||
|
<para>
|
||||||
|
Fontconfig contains two essential modules, the configuration module which
|
||||||
|
builds an internal configuration from XML files and the matching module
|
||||||
|
which accepts font patterns and returns the nearest matching font.
|
||||||
|
</para>
|
||||||
|
<sect2><title>FONT CONFIGURATION</title>
|
||||||
|
<para>
|
||||||
|
The configuration module consists of the FcConfig datatype, libexpat and
|
||||||
|
FcConfigParse which walks over an XML tree and ammends a configuration with
|
||||||
|
data found within. From an external perspective, configuration of the
|
||||||
|
library consists of generating a valid XML tree and feeding that to
|
||||||
|
FcConfigParse. The only other mechanism provided to applications for
|
||||||
|
changing the running configuration is to add fonts and directories to the
|
||||||
|
list of application-provided font files.
|
||||||
|
</para><para>
|
||||||
|
The intent is to make font configurations relatively static, and shared by
|
||||||
|
as many applications as possible. It is hoped that this will lead to more
|
||||||
|
stable font selection when passing names from one application to another.
|
||||||
|
XML was chosen as a configuration file format because it provides a format
|
||||||
|
which is easy for external agents to edit while retaining the correct
|
||||||
|
structure and syntax.
|
||||||
|
</para><para>
|
||||||
|
Font configuration is separate from font matching; applications needing to
|
||||||
|
do their own matching can access the available fonts from the library and
|
||||||
|
perform private matching. The intent is to permit applications to pick and
|
||||||
|
choose appropriate functionality from the library instead of forcing them to
|
||||||
|
choose between this library and a private configuration mechanism. The hope
|
||||||
|
is that this will ensure that configuration of fonts for all applications
|
||||||
|
can be centralized in one place. Centralizing font configuration will
|
||||||
|
simplify and regularize font installation and customization.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>FONT PROPERTIES</title>
|
||||||
|
<para>
|
||||||
|
While font patterns may contain essentially any properties, there are some
|
||||||
|
well known properties with associated types. Fontconfig uses some of these
|
||||||
|
properties for font matching and font completion. Others are provided as a
|
||||||
|
convenience for the applications rendering mechanism.
|
||||||
|
</para>
|
||||||
|
<table>
|
||||||
|
<title>Property Definitions</title>
|
||||||
|
<tgroup cols=3 align=left colsep=1 rowsep=1>
|
||||||
|
<colspec colname=Property>
|
||||||
|
<colspec colname=Type>
|
||||||
|
<colspec colname=Description>
|
||||||
|
<thead>
|
||||||
|
<row>
|
||||||
|
<entry>Property</entry>
|
||||||
|
<entry>Type</entry>
|
||||||
|
<entry>Description</entry>
|
||||||
|
</row>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
<row><entry>family</entry><entry>String</entry><entry>Font family name</entry></row>
|
||||||
|
<row><entry>style</entry><entry>String</entry><entry>Font style. Overrides weight and slant</entry></row>
|
||||||
|
<row><entry>slant</entry><entry>Int</entry><entry>Italic, oblique or roman</entry></row>
|
||||||
|
<row><entry>weight</entry><entry>Int</entry><entry>Light, medium, demibold, bold or black</entry></row>
|
||||||
|
<row><entry>size</entry><entry>Double</entry><entry>Point size</entry></row>
|
||||||
|
<row><entry>aspect</entry><entry>Double</entry><entry>Stretches glyphs horizontally before hinting</entry></row>
|
||||||
|
<row><entry>pixelsize</entry><entry>Double</entry><entry>Pixel size</entry></row>
|
||||||
|
<row><entry>spacing</entry><entry>Int</entry><entry>Proportional, monospace or charcell</entry></row>
|
||||||
|
<row><entry>foundry</entry><entry>String</entry><entry>Font foundry name</entry></row>
|
||||||
|
<row><entry>antialias</entry><entry>Bool</entry><entry>Whether glyphs can be antialiased</entry></row>
|
||||||
|
<row><entry>hinting</entry><entry>Bool</entry><entry>Whether the rasterizer should use hinting</entry></row>
|
||||||
|
<row><entry>verticallayout</entry><entry>Bool</entry><entry>Use vertical layout</entry></row>
|
||||||
|
<row><entry>autohint</entry><entry>Bool</entry><entry>Use autohinter instead of normal hinter</entry></row>
|
||||||
|
<row><entry>globaladvance</entry><entry>Bool</entry><entry>Use font global advance data</entry></row>
|
||||||
|
<row><entry>file</entry><entry>String</entry><entry>The filename holding the font</entry></row>
|
||||||
|
<row><entry>index</entry><entry>Int</entry><entry>The index of the font within the file</entry></row>
|
||||||
|
<row><entry>ftface</entry><entry>FT_Face</entry><entry>Use the specified FreeType face object</entry></row>
|
||||||
|
<row><entry>rasterizer</entry><entry>String</entry><entry>Which rasterizer is in use</entry></row>
|
||||||
|
<row><entry>outline</entry><entry>Bool</entry><entry>Whether the glyphs are outlines</entry></row>
|
||||||
|
<row><entry>scalable</entry><entry>Bool</entry><entry>Whether glyphs can be scaled</entry></row>
|
||||||
|
<row><entry>scale</entry><entry>Double</entry><entry>Scale factor for point->pixel conversions</entry></row>
|
||||||
|
<row><entry>dpi</entry><entry>Double</entry><entry>Target dots per inch</entry></row>
|
||||||
|
<row><entry>rgba</entry><entry>Int</entry><entry>unknown, rgb, bgr, vrgb, vbgr, none - subpixel geometry</entry></row>
|
||||||
|
<row><entry>minspace</entry><entry>Bool</entry><entry>Eliminate leading from line spacing</entry></row>
|
||||||
|
<row><entry>charset</entry><entry>CharSet</entry><entry>Unicode chars encoded by the font</entry></row>
|
||||||
|
<row><entry>lang</entry><entry>String</entry><entry>List of RFC-3066-style languages this font supports</entry></row>
|
||||||
|
</tbody>
|
||||||
|
</tgroup>
|
||||||
|
</table>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>FONT MATCHING</title>
|
||||||
|
<para>
|
||||||
|
Fontconfig performs matching by measuring the distance from a provided
|
||||||
|
pattern to all of the available fonts in the system. The closest matching
|
||||||
|
font is selected. This ensures that a font will always be returned, but
|
||||||
|
doesn't ensure that it is anything like the requested pattern.
|
||||||
|
</para><para>
|
||||||
|
Font matching starts with an application constructed pattern. The desired
|
||||||
|
attributes of the resulting font are collected together in a pattern. Each
|
||||||
|
property of the pattern can contain one or more values; these are listed in
|
||||||
|
priority order; matches earlier in the list are considered "closer" than
|
||||||
|
matches later in the list.
|
||||||
|
</para><para>
|
||||||
|
The initial pattern is modified by applying the list of editing instructions
|
||||||
|
specific to patterns found in the configuration; each consists of a match
|
||||||
|
predicate and a set of editing operations. They are executed in the order
|
||||||
|
they appeared in the configuration. Each match causes the associated
|
||||||
|
sequence of editing operations to be applied.
|
||||||
|
</para><para>
|
||||||
|
After the pattern has been edited, a sequence of default substitutions are
|
||||||
|
performed to canonicalize the set of available properties; this avoids the
|
||||||
|
need for the lower layers to constantly provide default values for various
|
||||||
|
font properties during rendering.
|
||||||
|
</para><para>
|
||||||
|
The canonical font pattern is finally matched against all available fonts.
|
||||||
|
The distance from the pattern to the font is measured for each of several
|
||||||
|
properties: foundry, charset, family, lang, spacing, pixelsize, style,
|
||||||
|
slant, weight, antialias, rasterizer and outline. This list is in priority
|
||||||
|
order -- results of comparing earlier elements of this list weigh more
|
||||||
|
heavily than later elements.
|
||||||
|
</para><para>
|
||||||
|
There is one special case to this rule; family names are split into two
|
||||||
|
bindings; strong and weak. Strong family names are given greater precedence
|
||||||
|
in the match than lang elements while weak family names are given lower
|
||||||
|
precedence than lang elements. This permits the document language to drive
|
||||||
|
font selection when any document specified font is unavailable.
|
||||||
|
</para><para>
|
||||||
|
The pattern representing that font is augmented to include any properties
|
||||||
|
found in the pattern but not found in the font itself; this permits the
|
||||||
|
application to pass rendering instructions or any other data through the
|
||||||
|
matching system. Finally, the list of editing instructions specific to
|
||||||
|
fonts found in the configuration are applied to the pattern. This modified
|
||||||
|
pattern is returned to the application.
|
||||||
|
</para><para>
|
||||||
|
The return value contains sufficient information to locate and rasterize the
|
||||||
|
font, including the file name, pixel size and other rendering data. As
|
||||||
|
none of the information involved pertains to the FreeType library,
|
||||||
|
applications are free to use any rasterization engine or even to take
|
||||||
|
the identified font file and access it directly.
|
||||||
|
</para><para>
|
||||||
|
The match/edit sequences in the configuration are performed in two passes
|
||||||
|
because there are essentially two different operations necessary -- the
|
||||||
|
first is to modify how fonts are selected; aliasing families and adding
|
||||||
|
suitable defaults. The second is to modify how the selected fonts are
|
||||||
|
rasterized. Those must apply to the selected font, not the original pattern
|
||||||
|
as false matches will often occur.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2><title>FONT NAMES</title>
|
||||||
|
<para>
|
||||||
|
Fontconfig provides a textual representation for patterns that the library
|
||||||
|
can both accept and generate. The representation is in three parts, first a
|
||||||
|
list of family names, second a list of point sizes and finally a list of
|
||||||
|
additional properties:
|
||||||
|
</para>
|
||||||
|
<programlisting>
|
||||||
|
<families>-<point sizes>:<name1>=<values1>:<name2>=<values2>...
|
||||||
|
</programlisting>
|
||||||
|
<para>
|
||||||
|
Values in a list are separated with commas. The name needn't include either
|
||||||
|
families or point sizes; they can be elided. In addition, there are
|
||||||
|
symbolic constants that simultaneously indicate both a name and a value.
|
||||||
|
Here are some examples:
|
||||||
|
</para>
|
||||||
|
<table colsep=0 rowsep=0>
|
||||||
|
<title>Sample Font Names</title>
|
||||||
|
<tgroup cols=2 align=left colsep=0 rowsep=0>
|
||||||
|
<thead><row>
|
||||||
|
<entry>Name</entry>
|
||||||
|
<entry>Meaning</entry>
|
||||||
|
</row></thead>
|
||||||
|
<tbody>
|
||||||
|
<row><entry>Times-12</entry><entry>12 point Times Roman</entry></row>
|
||||||
|
<row><entry>Times-12:bold</entry><entry>12 point Times Bold</entry></row>
|
||||||
|
<row><entry>Courier:italic</entry><entry>Courier Italic in the default size</entry></row>
|
||||||
|
<row><entry>Monospace:matrix=1 .1 0 1</entry><entry>The users preferred monospace font
|
||||||
|
with artificial obliquing</entry></row>
|
||||||
|
</tbody>
|
||||||
|
</tgroup>
|
||||||
|
</table>
|
||||||
|
</sect2>
|
||||||
|
</sect1>
|
||||||
|
<sect1><title>LANG TAGS</title>
|
||||||
|
<para>
|
||||||
|
Each font in the database contains a list of languages it supports. This is
|
||||||
|
computed by comparing the Unicode coverage of the font with the orthography
|
||||||
|
of each language. Languages are tagged using an RFC-3066 compatible naming
|
||||||
|
and occur in two parts -- the ISO639 language tag followed a hyphen and then
|
||||||
|
by the ISO 3166 country code. The hyphen and country code may be elided.
|
||||||
|
</para><para>
|
||||||
|
Fontconfig has orthographies for several languages built into the library.
|
||||||
|
No provision has been made for adding new ones aside from rebuilding the
|
||||||
|
library. It currently supports 122 of the 139 languages named in ISO 639-1,
|
||||||
|
141 of the languages with two-letter codes from ISO 639-2 and another 30
|
||||||
|
languages with only three-letter codes.
|
||||||
|
</para>
|
||||||
|
</sect1>
|
||||||
|
<sect1><title>CONFIGURATION FILE FORMAT</title>
|
||||||
|
<para>
|
||||||
|
Configuration files for fontconfig are stored in XML format; this
|
||||||
|
format makes external configuration tools easier to write and ensures that
|
||||||
|
they will generate syntactically correct configuration files. As XML
|
||||||
|
files are plain text, they can also be manipulated by the expert user using
|
||||||
|
a text editor.
|
||||||
|
</para><para>
|
||||||
|
The fontconfig document type definition resides in the external entity
|
||||||
|
"fonts.dtd"; this is normally stored in the default font configuration
|
||||||
|
directory (/etc/fonts). Each configuration file should contain the
|
||||||
|
following structure:
|
||||||
|
<programlisting>
|
||||||
|
<?xml version="1.0"?>
|
||||||
|
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
|
||||||
|
<fontconfig>
|
||||||
|
...
|
||||||
|
</fontconfig>
|
||||||
|
</programlisting>
|
||||||
|
</para><para>
|
||||||
|
<sect2><title><fontconfig></title><para>
|
||||||
|
This is the top level element for a font configuration and can contain
|
||||||
|
<dir>, <cache>, <include>, <match> and <alias> elements in any order.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><dir></title><para>
|
||||||
|
This element contains a directory name which will be scanned for font files
|
||||||
|
to include in the set of available fonts.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><cache></title><para>
|
||||||
|
This element contains a file name for the per-user cache of font
|
||||||
|
information. If it starts with '~', it refers to a file in the users
|
||||||
|
home directory. This file is used to hold information about fonts that
|
||||||
|
isn't present in the per-directory cache files. It is automatically
|
||||||
|
maintained by the fontconfig library. The default for this file
|
||||||
|
is ``~/.fonts.cache-<version>'', where <version> is the font configuration
|
||||||
|
file version number (currently 1).
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><include ignore_missing="no"></title><para>
|
||||||
|
This element contains the name of an additional configuration file. When
|
||||||
|
the XML datatype is traversed by FcConfigParse, the contents of the file
|
||||||
|
will also be incorporated into the configuration by passing the filename to
|
||||||
|
FcConfigLoadAndParse. If 'ignore_missing' is set to "yes" instead of the
|
||||||
|
default "no", a missing file will elicit no warning message from the library.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><config></title><para>
|
||||||
|
This element provides a place to consolodate additional configuration
|
||||||
|
information. <config> can contain <blank> and <rescan> elements in any
|
||||||
|
order.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><blank></title><para>
|
||||||
|
Fonts often include "broken" glyphs which appear in the encoding but are
|
||||||
|
drawn as blanks on the screen. Within the <blank> element, place each
|
||||||
|
Unicode characters which is supposed to be blank in an <int> element.
|
||||||
|
Characters outside of this set which are drawn as blank will be elided from
|
||||||
|
the set of characters supported by the font.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><rescan></title><para>
|
||||||
|
The <rescan> element holds an <int> element which indicates the default
|
||||||
|
interval between automatic checks for font configuration changes.
|
||||||
|
Fontconfig will validate all of the configuration files and directories and
|
||||||
|
automatically rebuild the internal datastructures when this interval passes.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><match target="pattern"></title><para>
|
||||||
|
This element holds first a (possibly empty) list of <test> elements and then
|
||||||
|
a (possibly empty) list of <edit> elements. Patterns which match all of the
|
||||||
|
tests are subjected to all the edits. If 'target' is set to "font" instead
|
||||||
|
of the default "pattern", then this element applies to the font name
|
||||||
|
resulting from a match rather than a font pattern to be matched.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><test qual="any" name="property" compare="eq"></title><para>
|
||||||
|
This element contains a single value which is compared with the pattern
|
||||||
|
property "property" (substitute any of the property names seen
|
||||||
|
above). 'compare' can be one of "eq", "not_eq", "less", "less_eq", "more", or
|
||||||
|
"more_eq". 'qual' may either be the default, "any", in which case the match
|
||||||
|
succeeds if any value associated with the property matches the test value, or
|
||||||
|
"all", in which case all of the values associated with the property must
|
||||||
|
match the test value.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><edit name="property" mode="assign" binding="weak"></title><para>
|
||||||
|
This element contains a list of expression elements (any of the value or
|
||||||
|
operator elements). The expression elements are evaluated at run-time and
|
||||||
|
modify the property "property". The modification depends on whether
|
||||||
|
"property" was matched by one of the associated <test> elements, if so, the
|
||||||
|
modification may affect the first matched value. Any values inserted into
|
||||||
|
the property are given the indicated binding. 'mode' is one of:
|
||||||
|
<table>
|
||||||
|
<title>Edit Element Modes</title>
|
||||||
|
<tgroup cols=3 align=left colsep=0 rowsep=0>
|
||||||
|
<thead>
|
||||||
|
<row>
|
||||||
|
<entry>Mode</entry>
|
||||||
|
<entry>Operation With Match</entry>
|
||||||
|
<entry>Operation Without Match</entry>
|
||||||
|
</row>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
<row><entry>"assign"</entry><entry>Replace matching value</entry><entry>Replace all values</entry></row>
|
||||||
|
<row><entry>"assign_replace"</entry><entry>Replace all values</entry><entry>Replace all values</entry></row>
|
||||||
|
<row><entry>"prepend"</entry><entry>Insert before matching value</entry><entry>Insert at head of list</entry></row>
|
||||||
|
<row><entry>"prepend_first"</entry><entry>Insert at head of list</entry><entry>Insert at head of list</entry></row>
|
||||||
|
<row><entry>"append"</entry><entry>Append after matching value</entry><entry>Append at end of list</entry></row>
|
||||||
|
<row><entry>"append_last"</entry><entry>Append at end of list</entry><entry>Append at end of list</entry></row>
|
||||||
|
</tbody>
|
||||||
|
</tgroup>
|
||||||
|
</table>
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><int>, <double>, <string>, <bool></title><para>
|
||||||
|
These elements hold a single value of the indicated type. <bool> elements
|
||||||
|
hold either true or false.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><matrix></title><para>
|
||||||
|
This element holds the four <double> elements of an affine
|
||||||
|
transformation.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><name></title><para>
|
||||||
|
Holds a property name. Evaluates to the first value from the property of
|
||||||
|
the font, not the pattern.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><const></title><para>
|
||||||
|
Holds the name of a constant; these are always integers and serve as
|
||||||
|
symbolic names for common font values:
|
||||||
|
<table>
|
||||||
|
<title>Symbolic Constants</title>
|
||||||
|
<tgroup cols=3 align=left colsep=0 rowsep=0>
|
||||||
|
<thead>
|
||||||
|
<row>
|
||||||
|
<entry>Constant</entry>
|
||||||
|
<entry>Property</entry>
|
||||||
|
<entry>CPP Symbol</entry>
|
||||||
|
</row>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
<row><entry>light</entry><entry>weight</entry></row>
|
||||||
|
<row><entry>medium</entry><entry>weight</entry></row>
|
||||||
|
<row><entry>demibold</entry><entry>weight</entry></row>
|
||||||
|
<row><entry>bold</entry><entry>weight</entry></row>
|
||||||
|
<row><entry>black</entry><entry>weight</entry></row>
|
||||||
|
<row><entry>roman</entry><entry>slant</entry></row>
|
||||||
|
<row><entry>italic</entry><entry>slant</entry></row>
|
||||||
|
<row><entry>oblique</entry><entry>slant</entry></row>
|
||||||
|
<row><entry>proportional</entry><entry>spacing</entry></row>
|
||||||
|
<row><entry>mono</entry><entry>spacing</entry></row>
|
||||||
|
<row><entry>charcell</entry><entry>spacing</entry></row>
|
||||||
|
<row><entry>unknown</entry><entry>rgba</entry></row>
|
||||||
|
<row><entry>rgb</entry><entry>rgba</entry></row>
|
||||||
|
<row><entry>bgr</entry><entry>rgba</entry></row>
|
||||||
|
<row><entry>vrgb</entry><entry>rgba</entry></row>
|
||||||
|
<row><entry>vbgr</entry><entry>rgba</entry></row>
|
||||||
|
<row><entry>none</entry><entry>rgba</entry></row>
|
||||||
|
</tbody>
|
||||||
|
</tgroup>
|
||||||
|
</table>
|
||||||
|
<sect2><title><or>,
|
||||||
|
<and>,
|
||||||
|
<plus>,
|
||||||
|
<minus>,
|
||||||
|
<times>,
|
||||||
|
<divide></title><para>
|
||||||
|
These elements perform the specified operation on a list of expression
|
||||||
|
elements. <or> and <and> are boolean, not bitwise.
|
||||||
|
<sect2><title><eq>,
|
||||||
|
<not_eq>,
|
||||||
|
<less>,
|
||||||
|
<less_eq>,
|
||||||
|
<more>,
|
||||||
|
<more_eq></title><para>
|
||||||
|
These elements compare two values, producing a boolean result.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><not></title><para>
|
||||||
|
Inverts the boolean sense of its one expression element
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><if></title><para>
|
||||||
|
This element takes three expression elements; if the value of the first is
|
||||||
|
true, it produces the value of the second, otherwise it produces the value
|
||||||
|
of the third.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><alias></title><para>
|
||||||
|
Alias elements provide a shorthand notation for the set of common match
|
||||||
|
operations needed to substitute one font family for another. They contain a
|
||||||
|
<family> element followed by optional <prefer>, <accept> and <default>
|
||||||
|
elements. Fonts matching the <family> element are edited to prepend the
|
||||||
|
list of <prefer>ed families before the matching <family>, append the
|
||||||
|
<accept>able familys after the matching <family> and append the <default>
|
||||||
|
families to the end of the family list.
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><family></title><para>
|
||||||
|
Holds a single font family name
|
||||||
|
</para></sect2>
|
||||||
|
<sect2><title><prefer>, <accept>, <default></title><para>
|
||||||
|
These hold a list of <family> elements to be used by the <alias> element.
|
||||||
|
</article>
|
||||||
|
</para></sect2>
|
||||||
|
</sect1>
|
||||||
|
<sect1><title>EXAMPLE CONFIGURATION FILE</title>
|
||||||
|
<sect2><title>System configuration file</title>
|
||||||
|
<para>
|
||||||
|
This is an example of a system-wide configuration file
|
||||||
|
</para>
|
||||||
|
<programlisting>
|
||||||
|
<?xml version="1.0"?>
|
||||||
|
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
|
||||||
|
<!-- /etc/fonts/fonts.conf file to configure system font access -->
|
||||||
|
<fontconfig>
|
||||||
|
<!--
|
||||||
|
Find fonts in these directories
|
||||||
|
-->
|
||||||
|
<dir>/usr/X11R6/lib/X11/fonts/truetype</dir>
|
||||||
|
<dir>/usr/X11R6/lib/X11/fonts/Type1</dir>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Accept deprecated 'mono' alias, replacing it with 'monospace'
|
||||||
|
-->
|
||||||
|
<match target="pattern">
|
||||||
|
<test qual="any" name="family"><string>mono</string></test>
|
||||||
|
<edit name="family" mode="assign"><string>monospace</string></edit>
|
||||||
|
</match>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Names not including any well known alias are given 'sans'
|
||||||
|
-->
|
||||||
|
<match target="pattern">
|
||||||
|
<test qual="all" name="family" mode="not_eq">sans</test>
|
||||||
|
<test qual="all" name="family" mode="not_eq">serif</test>
|
||||||
|
<test qual="all" name="family" mode="not_eq">monospace</test>
|
||||||
|
<edit name="family" mode="append_last"><string>sans</string></edit>
|
||||||
|
</match>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Load per-user customization file, but don't complain
|
||||||
|
if it doesn't exist
|
||||||
|
-->
|
||||||
|
<include ignore_missing="yes">~/.fonts.conf</include>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Alias well known font names to available TrueType fonts.
|
||||||
|
These substitute TrueType faces for similar Type1
|
||||||
|
faces to improve screen appearance.
|
||||||
|
-->
|
||||||
|
<alias>
|
||||||
|
<family>Times</family>
|
||||||
|
<prefer><family>Times New Roman</family></prefer>
|
||||||
|
<default><family>serif</family></default>
|
||||||
|
</alias>
|
||||||
|
<alias>
|
||||||
|
<family>Helvetica</family>
|
||||||
|
<prefer><family>Verdana</family></prefer>
|
||||||
|
<default><family>sans</family></default>
|
||||||
|
</alias>
|
||||||
|
<alias>
|
||||||
|
<family>Courier</family>
|
||||||
|
<prefer><family>Courier New</family></prefer>
|
||||||
|
<default><family>monospace</family></default>
|
||||||
|
</alias>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Provide required aliases for standard names
|
||||||
|
Do these after the users configuration file so that
|
||||||
|
any aliases there are used preferentially
|
||||||
|
-->
|
||||||
|
<alias>
|
||||||
|
<family>serif</family>
|
||||||
|
<prefer><family>Times New Roman</family></prefer>
|
||||||
|
</alias>
|
||||||
|
<alias>
|
||||||
|
<family>sans</family>
|
||||||
|
<prefer><family>Verdana</family></prefer>
|
||||||
|
</alias>
|
||||||
|
<alias>
|
||||||
|
<family>monospace</family>
|
||||||
|
<prefer><family>Andale Mono</family></prefer>
|
||||||
|
</alias>
|
||||||
|
</fontconfig>
|
||||||
|
</programlisting>
|
||||||
|
<sect2><title>User configuration file</title>
|
||||||
|
<para>
|
||||||
|
This is an example of a per-user configuration file that lives in
|
||||||
|
~/.fonts.conf
|
||||||
|
</para>
|
||||||
|
<programlisting>
|
||||||
|
<?xml version="1.0"?>
|
||||||
|
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
|
||||||
|
<!-- ~/.fonts.conf for per-user font configuration -->
|
||||||
|
<fontconfig>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Private font directory
|
||||||
|
-->
|
||||||
|
<dir>~/misc/fonts</dir>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
use rgb sub-pixel ordering to improve glyph appearance on
|
||||||
|
LCD screens. Changes affecting rendering, but not matching
|
||||||
|
should always use target="font".
|
||||||
|
-->
|
||||||
|
<match target="font">
|
||||||
|
<edit name="rgba" mode="assign"><const>rgb</const></edit>
|
||||||
|
</match>
|
||||||
|
</fontconfig>
|
||||||
|
</programlisting>
|
||||||
|
</sect2>
|
||||||
|
<sect1><title>FILES</title>
|
||||||
|
<para>
|
||||||
|
<emphasis>fonts.conf</emphasis>
|
||||||
|
contains configuration information for the fontconfig library
|
||||||
|
consisting of directories to look at for font information as well as
|
||||||
|
instructions on editing program specified font patterns before attempting to
|
||||||
|
match the available fonts. It is in xml format.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
<emphasis>fonts.dtd</emphasis>
|
||||||
|
is a DTD that describes the format of the configuration files.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
<emphasis>~/.fonts.conf</emphasis>
|
||||||
|
is the conventional location for per-user font configuration, although the
|
||||||
|
actual location is specified in the global fonts.conf file.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
<emphasis> ~/.fonts.cache-*</emphasis>
|
||||||
|
is the conventional repository of font information that isn't found in the
|
||||||
|
per-directory caches. This file is automatically maintained by fontconfig.
|
||||||
|
</para>
|
||||||
|
</sect1>
|
||||||
|
</article>
|
||||||
|
|
@ -1,55 +0,0 @@
|
||||||
\documentclass[10pt]{article}
|
|
||||||
\usepackage{latexsym}
|
|
||||||
\usepackage{epsfig}
|
|
||||||
\usepackage{times}
|
|
||||||
|
|
||||||
\begin{document}
|
|
||||||
\date{}
|
|
||||||
\title{The Fontconfig Library:\\
|
|
||||||
Architecture and Users Guide}
|
|
||||||
\author{Keith Packard\\
|
|
||||||
{\em XFree86 Core Team}\\
|
|
||||||
keithp@keithp.com}
|
|
||||||
\maketitle
|
|
||||||
\thispagestyle{empty}
|
|
||||||
|
|
||||||
\abstract
|
|
||||||
|
|
||||||
The Fontconfig library provides for central administration and configuration
|
|
||||||
of fonts in a POSIX system. All font consumers can share a common database
|
|
||||||
of fonts and use common matching rules for font names. The set of available
|
|
||||||
fonts can be configured for each user and a set of configurable matching
|
|
||||||
rules allow for customizing the selection of fonts and configuring various
|
|
||||||
parameters related to rasterizing of those fonts for display in a variety of
|
|
||||||
media. The Fontconfig library is designed to co-exist peacefully with
|
|
||||||
existing font configuration and rasterization mechanisms; while it uses the
|
|
||||||
FreeType library to discover characteristics of available fonts, there
|
|
||||||
is no requirement to use FreeType for rasterization.
|
|
||||||
|
|
||||||
\section {Introduction}
|
|
||||||
|
|
||||||
\section {Configuration Files}
|
|
||||||
|
|
||||||
\section {Application Interface}
|
|
||||||
|
|
||||||
\subsection {Datatypes}
|
|
||||||
|
|
||||||
\subsection {Font Set Interface}
|
|
||||||
|
|
||||||
\subsection {Font Patterns}
|
|
||||||
|
|
||||||
\subsection {Listing Available Fonts}
|
|
||||||
|
|
||||||
\subsection {Using Font Names}
|
|
||||||
|
|
||||||
\subsection {Manipulating Matrices}
|
|
||||||
|
|
||||||
\subsection {UTF-8 Helper Functions}
|
|
||||||
|
|
||||||
\section {Font Sub-System Interface}
|
|
||||||
|
|
||||||
\subsection {Extending Font Names}
|
|
||||||
|
|
||||||
\subsection {Executing Configuration Rules}
|
|
||||||
|
|
||||||
\end{document}
|
|
||||||
Loading…
Reference in New Issue