fontconfig-user.html revision 2c393a42
12c393a42Smrg<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> 22c393a42Smrg<HTML 32c393a42Smrg><HEAD 42c393a42Smrg><TITLE 52c393a42Smrg>fonts-conf</TITLE 62c393a42Smrg><META 72c393a42SmrgNAME="GENERATOR" 82c393a42SmrgCONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD 92c393a42Smrg><BODY 102c393a42SmrgCLASS="REFENTRY" 112c393a42SmrgBGCOLOR="#FFFFFF" 122c393a42SmrgTEXT="#000000" 132c393a42SmrgLINK="#0000FF" 142c393a42SmrgVLINK="#840084" 152c393a42SmrgALINK="#0000FF" 162c393a42Smrg><H1 172c393a42Smrg><A 182c393a42SmrgNAME="AEN1" 192c393a42Smrg></A 202c393a42Smrg>fonts-conf</H1 212c393a42Smrg><DIV 222c393a42SmrgCLASS="REFNAMEDIV" 232c393a42Smrg><A 242c393a42SmrgNAME="AEN5" 252c393a42Smrg></A 262c393a42Smrg><H2 272c393a42Smrg>Name</H2 282c393a42Smrg>fonts.conf -- Font configuration files</DIV 292c393a42Smrg><DIV 302c393a42SmrgCLASS="REFSYNOPSISDIV" 312c393a42Smrg><A 322c393a42SmrgNAME="AEN8" 332c393a42Smrg></A 342c393a42Smrg><H2 352c393a42Smrg>Synopsis</H2 362c393a42Smrg><PRE 372c393a42SmrgCLASS="SYNOPSIS" 382c393a42Smrg> /etc/fonts/fonts.conf 392c393a42Smrg /etc/fonts/fonts.dtd 402c393a42Smrg /etc/fonts/conf.d 412c393a42Smrg ~/.fonts.conf</PRE 422c393a42Smrg></DIV 432c393a42Smrg><DIV 442c393a42SmrgCLASS="REFSECT1" 452c393a42Smrg><A 462c393a42SmrgNAME="AEN10" 472c393a42Smrg></A 482c393a42Smrg><H2 492c393a42Smrg>Description</H2 502c393a42Smrg><P 512c393a42Smrg>Fontconfig is a library designed to provide system-wide font configuration, 522c393a42Smrgcustomization and application access. 532c393a42Smrg </P 542c393a42Smrg></DIV 552c393a42Smrg><DIV 562c393a42SmrgCLASS="REFSECT1" 572c393a42Smrg><A 582c393a42SmrgNAME="AEN13" 592c393a42Smrg></A 602c393a42Smrg><H2 612c393a42Smrg>Functional Overview</H2 622c393a42Smrg><P 632c393a42Smrg>Fontconfig contains two essential modules, the configuration module which 642c393a42Smrgbuilds an internal configuration from XML files and the matching module 652c393a42Smrgwhich accepts font patterns and returns the nearest matching font. 662c393a42Smrg </P 672c393a42Smrg><DIV 682c393a42SmrgCLASS="REFSECT2" 692c393a42Smrg><A 702c393a42SmrgNAME="AEN16" 712c393a42Smrg></A 722c393a42Smrg><H3 732c393a42Smrg>Font Configuration</H3 742c393a42Smrg><P 752c393a42Smrg>The configuration module consists of the FcConfig datatype, libexpat and 762c393a42SmrgFcConfigParse which walks over an XML tree and amends a configuration with 772c393a42Smrgdata found within. From an external perspective, configuration of the 782c393a42Smrglibrary consists of generating a valid XML tree and feeding that to 792c393a42SmrgFcConfigParse. The only other mechanism provided to applications for 802c393a42Smrgchanging the running configuration is to add fonts and directories to the 812c393a42Smrglist of application-provided font files. 822c393a42Smrg </P 832c393a42Smrg><P 842c393a42Smrg>The intent is to make font configurations relatively static, and shared by 852c393a42Smrgas many applications as possible. It is hoped that this will lead to more 862c393a42Smrgstable font selection when passing names from one application to another. 872c393a42SmrgXML was chosen as a configuration file format because it provides a format 882c393a42Smrgwhich is easy for external agents to edit while retaining the correct 892c393a42Smrgstructure and syntax. 902c393a42Smrg </P 912c393a42Smrg><P 922c393a42Smrg>Font configuration is separate from font matching; applications needing to 932c393a42Smrgdo their own matching can access the available fonts from the library and 942c393a42Smrgperform private matching. The intent is to permit applications to pick and 952c393a42Smrgchoose appropriate functionality from the library instead of forcing them to 962c393a42Smrgchoose between this library and a private configuration mechanism. The hope 972c393a42Smrgis that this will ensure that configuration of fonts for all applications 982c393a42Smrgcan be centralized in one place. Centralizing font configuration will 992c393a42Smrgsimplify and regularize font installation and customization. 1002c393a42Smrg </P 1012c393a42Smrg></DIV 1022c393a42Smrg><DIV 1032c393a42SmrgCLASS="REFSECT2" 1042c393a42Smrg><A 1052c393a42SmrgNAME="AEN21" 1062c393a42Smrg></A 1072c393a42Smrg><H3 1082c393a42Smrg>Font Properties</H3 1092c393a42Smrg><P 1102c393a42Smrg>While font patterns may contain essentially any properties, there are some 1112c393a42Smrgwell known properties with associated types. Fontconfig uses some of these 1122c393a42Smrgproperties for font matching and font completion. Others are provided as a 1132c393a42Smrgconvenience for the applications' rendering mechanism. 1142c393a42Smrg </P 1152c393a42Smrg><PRE 1162c393a42SmrgCLASS="PROGRAMLISTING" 1172c393a42Smrg> Property Type Description 1182c393a42Smrg -------------------------------------------------------------- 1192c393a42Smrg family String Font family names 1202c393a42Smrg familylang String Languages corresponding to each family 1212c393a42Smrg style String Font style. Overrides weight and slant 1222c393a42Smrg stylelang String Languages corresponding to each style 1232c393a42Smrg fullname String Font full names (often includes style) 1242c393a42Smrg fullnamelang String Languages corresponding to each fullname 1252c393a42Smrg slant Int Italic, oblique or roman 1262c393a42Smrg weight Int Light, medium, demibold, bold or black 1272c393a42Smrg size Double Point size 1282c393a42Smrg width Int Condensed, normal or expanded 1292c393a42Smrg aspect Double Stretches glyphs horizontally before hinting 1302c393a42Smrg pixelsize Double Pixel size 1312c393a42Smrg spacing Int Proportional, dual-width, monospace or charcell 1322c393a42Smrg foundry String Font foundry name 1332c393a42Smrg antialias Bool Whether glyphs can be antialiased 1342c393a42Smrg hinting Bool Whether the rasterizer should use hinting 1352c393a42Smrg hintstyle Int Automatic hinting style 1362c393a42Smrg verticallayout Bool Use vertical layout 1372c393a42Smrg autohint Bool Use autohinter instead of normal hinter 1382c393a42Smrg globaladvance Bool Use font global advance data 1392c393a42Smrg file String The filename holding the font 1402c393a42Smrg index Int The index of the font within the file 1412c393a42Smrg ftface FT_Face Use the specified FreeType face object 1422c393a42Smrg rasterizer String Which rasterizer is in use 1432c393a42Smrg outline Bool Whether the glyphs are outlines 1442c393a42Smrg scalable Bool Whether glyphs can be scaled 1452c393a42Smrg scale Double Scale factor for point->pixel conversions 1462c393a42Smrg dpi Double Target dots per inch 1472c393a42Smrg rgba Int unknown, rgb, bgr, vrgb, vbgr, 1482c393a42Smrg none - subpixel geometry 1492c393a42Smrg lcdfilter Int Type of LCD filter 1502c393a42Smrg minspace Bool Eliminate leading from line spacing 1512c393a42Smrg charset CharSet Unicode chars encoded by the font 1522c393a42Smrg lang String List of RFC-3066-style languages this 1532c393a42Smrg font supports 1542c393a42Smrg fontversion Int Version number of the font 1552c393a42Smrg capability String List of layout capabilities in the font 1562c393a42Smrg embolden Bool Rasterizer should synthetically embolden the font 1572c393a42Smrg </PRE 1582c393a42Smrg></DIV 1592c393a42Smrg><DIV 1602c393a42SmrgCLASS="REFSECT2" 1612c393a42Smrg><A 1622c393a42SmrgNAME="AEN25" 1632c393a42Smrg></A 1642c393a42Smrg><H3 1652c393a42Smrg>Font Matching</H3 1662c393a42Smrg><P 1672c393a42Smrg>Fontconfig performs matching by measuring the distance from a provided 1682c393a42Smrgpattern to all of the available fonts in the system. The closest matching 1692c393a42Smrgfont is selected. This ensures that a font will always be returned, but 1702c393a42Smrgdoesn't ensure that it is anything like the requested pattern. 1712c393a42Smrg </P 1722c393a42Smrg><P 1732c393a42Smrg> 1742c393a42SmrgFont matching starts with an application constructed pattern. The desired 1752c393a42Smrgattributes of the resulting font are collected together in a pattern. Each 1762c393a42Smrgproperty of the pattern can contain one or more values; these are listed in 1772c393a42Smrgpriority order; matches earlier in the list are considered "closer" than 1782c393a42Smrgmatches later in the list. 1792c393a42Smrg </P 1802c393a42Smrg><P 1812c393a42Smrg>The initial pattern is modified by applying the list of editing instructions 1822c393a42Smrgspecific to patterns found in the configuration; each consists of a match 1832c393a42Smrgpredicate and a set of editing operations. They are executed in the order 1842c393a42Smrgthey appeared in the configuration. Each match causes the associated 1852c393a42Smrgsequence of editing operations to be applied. 1862c393a42Smrg </P 1872c393a42Smrg><P 1882c393a42Smrg>After the pattern has been edited, a sequence of default substitutions are 1892c393a42Smrgperformed to canonicalize the set of available properties; this avoids the 1902c393a42Smrgneed for the lower layers to constantly provide default values for various 1912c393a42Smrgfont properties during rendering. 1922c393a42Smrg </P 1932c393a42Smrg><P 1942c393a42Smrg>The canonical font pattern is finally matched against all available fonts. 1952c393a42SmrgThe distance from the pattern to the font is measured for each of several 1962c393a42Smrgproperties: foundry, charset, family, lang, spacing, pixelsize, style, 1972c393a42Smrgslant, weight, antialias, rasterizer and outline. This list is in priority 1982c393a42Smrgorder -- results of comparing earlier elements of this list weigh more 1992c393a42Smrgheavily than later elements. 2002c393a42Smrg </P 2012c393a42Smrg><P 2022c393a42Smrg>There is one special case to this rule; family names are split into two 2032c393a42Smrgbindings; strong and weak. Strong family names are given greater precedence 2042c393a42Smrgin the match than lang elements while weak family names are given lower 2052c393a42Smrgprecedence than lang elements. This permits the document language to drive 2062c393a42Smrgfont selection when any document specified font is unavailable. 2072c393a42Smrg </P 2082c393a42Smrg><P 2092c393a42Smrg>The pattern representing that font is augmented to include any properties 2102c393a42Smrgfound in the pattern but not found in the font itself; this permits the 2112c393a42Smrgapplication to pass rendering instructions or any other data through the 2122c393a42Smrgmatching system. Finally, the list of editing instructions specific to 2132c393a42Smrgfonts found in the configuration are applied to the pattern. This modified 2142c393a42Smrgpattern is returned to the application. 2152c393a42Smrg </P 2162c393a42Smrg><P 2172c393a42Smrg>The return value contains sufficient information to locate and rasterize the 2182c393a42Smrgfont, including the file name, pixel size and other rendering data. As 2192c393a42Smrgnone of the information involved pertains to the FreeType library, 2202c393a42Smrgapplications are free to use any rasterization engine or even to take 2212c393a42Smrgthe identified font file and access it directly. 2222c393a42Smrg </P 2232c393a42Smrg><P 2242c393a42Smrg>The match/edit sequences in the configuration are performed in two passes 2252c393a42Smrgbecause there are essentially two different operations necessary -- the 2262c393a42Smrgfirst is to modify how fonts are selected; aliasing families and adding 2272c393a42Smrgsuitable defaults. The second is to modify how the selected fonts are 2282c393a42Smrgrasterized. Those must apply to the selected font, not the original pattern 2292c393a42Smrgas false matches will often occur. 2302c393a42Smrg </P 2312c393a42Smrg></DIV 2322c393a42Smrg><DIV 2332c393a42SmrgCLASS="REFSECT2" 2342c393a42Smrg><A 2352c393a42SmrgNAME="AEN36" 2362c393a42Smrg></A 2372c393a42Smrg><H3 2382c393a42Smrg>Font Names</H3 2392c393a42Smrg><P 2402c393a42Smrg>Fontconfig provides a textual representation for patterns that the library 2412c393a42Smrgcan both accept and generate. The representation is in three parts, first a 2422c393a42Smrglist of family names, second a list of point sizes and finally a list of 2432c393a42Smrgadditional properties: 2442c393a42Smrg </P 2452c393a42Smrg><PRE 2462c393a42SmrgCLASS="PROGRAMLISTING" 2472c393a42Smrg> <families>-<point sizes>:<name1>=<values1>:<name2>=<values2>... 2482c393a42Smrg </PRE 2492c393a42Smrg><P 2502c393a42Smrg>Values in a list are separated with commas. The name needn't include either 2512c393a42Smrgfamilies or point sizes; they can be elided. In addition, there are 2522c393a42Smrgsymbolic constants that simultaneously indicate both a name and a value. 2532c393a42SmrgHere are some examples: 2542c393a42Smrg </P 2552c393a42Smrg><PRE 2562c393a42SmrgCLASS="PROGRAMLISTING" 2572c393a42Smrg> Name Meaning 2582c393a42Smrg ---------------------------------------------------------- 2592c393a42Smrg Times-12 12 point Times Roman 2602c393a42Smrg Times-12:bold 12 point Times Bold 2612c393a42Smrg Courier:italic Courier Italic in the default size 2622c393a42Smrg Monospace:matrix=1 .1 0 1 The users preferred monospace font 2632c393a42Smrg with artificial obliquing 2642c393a42Smrg </PRE 2652c393a42Smrg><P 2662c393a42Smrg>The '\', '-', ':' and ',' characters in family names must be preceeded by a 2672c393a42Smrg'\' character to avoid having them misinterpreted. Similarly, values 2682c393a42Smrgcontaining '\', '=', '_', ':' and ',' must also have them preceeded by a 2692c393a42Smrg'\' character. The '\' characters are stripped out of the family name and 2702c393a42Smrgvalues as the font name is read. 2712c393a42Smrg </P 2722c393a42Smrg></DIV 2732c393a42Smrg></DIV 2742c393a42Smrg><DIV 2752c393a42SmrgCLASS="REFSECT1" 2762c393a42Smrg><A 2772c393a42SmrgNAME="AEN43" 2782c393a42Smrg></A 2792c393a42Smrg><H2 2802c393a42Smrg>Debugging Applications</H2 2812c393a42Smrg><P 2822c393a42Smrg>To help diagnose font and applications problems, fontconfig is built with a 2832c393a42Smrglarge amount of internal debugging left enabled. It is controlled by means 2842c393a42Smrgof the FC_DEBUG environment variable. The value of this variable is 2852c393a42Smrginterpreted as a number, and each bit within that value controls different 2862c393a42Smrgdebugging messages. 2872c393a42Smrg </P 2882c393a42Smrg><PRE 2892c393a42SmrgCLASS="PROGRAMLISTING" 2902c393a42Smrg> Name Value Meaning 2912c393a42Smrg --------------------------------------------------------- 2922c393a42Smrg MATCH 1 Brief information about font matching 2932c393a42Smrg MATCHV 2 Extensive font matching information 2942c393a42Smrg EDIT 4 Monitor match/test/edit execution 2952c393a42Smrg FONTSET 8 Track loading of font information at startup 2962c393a42Smrg CACHE 16 Watch cache files being written 2972c393a42Smrg CACHEV 32 Extensive cache file writing information 2982c393a42Smrg PARSE 64 (no longer in use) 2992c393a42Smrg SCAN 128 Watch font files being scanned to build caches 3002c393a42Smrg SCANV 256 Verbose font file scanning information 3012c393a42Smrg MEMORY 512 Monitor fontconfig memory usage 3022c393a42Smrg CONFIG 1024 Monitor which config files are loaded 3032c393a42Smrg LANGSET 2048 Dump char sets used to construct lang values 3042c393a42Smrg OBJTYPES 4096 Display message when value typechecks fail 3052c393a42Smrg </PRE 3062c393a42Smrg><P 3072c393a42Smrg>Add the value of the desired debug levels together and assign that (in 3082c393a42Smrgbase 10) to the FC_DEBUG environment variable before running the 3092c393a42Smrgapplication. Output from these statements is sent to stdout. 3102c393a42Smrg </P 3112c393a42Smrg></DIV 3122c393a42Smrg><DIV 3132c393a42SmrgCLASS="REFSECT1" 3142c393a42Smrg><A 3152c393a42SmrgNAME="AEN48" 3162c393a42Smrg></A 3172c393a42Smrg><H2 3182c393a42Smrg>Lang Tags</H2 3192c393a42Smrg><P 3202c393a42Smrg>Each font in the database contains a list of languages it supports. This is 3212c393a42Smrgcomputed by comparing the Unicode coverage of the font with the orthography 3222c393a42Smrgof each language. Languages are tagged using an RFC-3066 compatible naming 3232c393a42Smrgand occur in two parts -- the ISO 639 language tag followed a hyphen and then 3242c393a42Smrgby the ISO 3166 country code. The hyphen and country code may be elided. 3252c393a42Smrg </P 3262c393a42Smrg><P 3272c393a42Smrg>Fontconfig has orthographies for several languages built into the library. 3282c393a42SmrgNo provision has been made for adding new ones aside from rebuilding the 3292c393a42Smrglibrary. It currently supports 122 of the 139 languages named in ISO 639-1, 3302c393a42Smrg141 of the languages with two-letter codes from ISO 639-2 and another 30 3312c393a42Smrglanguages with only three-letter codes. Languages with both two and three 3322c393a42Smrgletter codes are provided with only the two letter code. 3332c393a42Smrg </P 3342c393a42Smrg><P 3352c393a42Smrg>For languages used in multiple territories with radically different 3362c393a42Smrgcharacter sets, fontconfig includes per-territory orthographies. This 3372c393a42Smrgincludes Azerbaijani, Kurdish, Pashto, Tigrinya and Chinese. 3382c393a42Smrg </P 3392c393a42Smrg></DIV 3402c393a42Smrg><DIV 3412c393a42SmrgCLASS="REFSECT1" 3422c393a42Smrg><A 3432c393a42SmrgNAME="AEN53" 3442c393a42Smrg></A 3452c393a42Smrg><H2 3462c393a42Smrg>Configuration File Format</H2 3472c393a42Smrg><P 3482c393a42Smrg>Configuration files for fontconfig are stored in XML format; this 3492c393a42Smrgformat makes external configuration tools easier to write and ensures that 3502c393a42Smrgthey will generate syntactically correct configuration files. As XML 3512c393a42Smrgfiles are plain text, they can also be manipulated by the expert user using 3522c393a42Smrga text editor. 3532c393a42Smrg </P 3542c393a42Smrg><P 3552c393a42Smrg>The fontconfig document type definition resides in the external entity 3562c393a42Smrg"fonts.dtd"; this is normally stored in the default font configuration 3572c393a42Smrgdirectory (/etc/fonts). Each configuration file should contain the 3582c393a42Smrgfollowing structure: 3592c393a42Smrg <PRE 3602c393a42SmrgCLASS="PROGRAMLISTING" 3612c393a42Smrg> <?xml version="1.0"?> 3622c393a42Smrg <!DOCTYPE fontconfig SYSTEM "fonts.dtd"> 3632c393a42Smrg <fontconfig> 3642c393a42Smrg ... 3652c393a42Smrg </fontconfig> 3662c393a42Smrg </PRE 3672c393a42Smrg> 3682c393a42Smrg </P 3692c393a42Smrg><DIV 3702c393a42SmrgCLASS="REFSECT2" 3712c393a42Smrg><A 3722c393a42SmrgNAME="AEN58" 3732c393a42Smrg></A 3742c393a42Smrg><H3 3752c393a42Smrg><TT 3762c393a42SmrgCLASS="LITERAL" 3772c393a42Smrg><fontconfig></TT 3782c393a42Smrg></H3 3792c393a42Smrg><P 3802c393a42Smrg>This is the top level element for a font configuration and can contain 3812c393a42Smrg<TT 3822c393a42SmrgCLASS="LITERAL" 3832c393a42Smrg><dir></TT 3842c393a42Smrg>, <TT 3852c393a42SmrgCLASS="LITERAL" 3862c393a42Smrg><cache></TT 3872c393a42Smrg>, <TT 3882c393a42SmrgCLASS="LITERAL" 3892c393a42Smrg><include></TT 3902c393a42Smrg>, <TT 3912c393a42SmrgCLASS="LITERAL" 3922c393a42Smrg><match></TT 3932c393a42Smrg> and <TT 3942c393a42SmrgCLASS="LITERAL" 3952c393a42Smrg><alias></TT 3962c393a42Smrg> elements in any order. 3972c393a42Smrg </P 3982c393a42Smrg></DIV 3992c393a42Smrg><DIV 4002c393a42SmrgCLASS="REFSECT2" 4012c393a42Smrg><A 4022c393a42SmrgNAME="AEN67" 4032c393a42Smrg></A 4042c393a42Smrg><H3 4052c393a42Smrg><TT 4062c393a42SmrgCLASS="LITERAL" 4072c393a42Smrg><dir></TT 4082c393a42Smrg></H3 4092c393a42Smrg><P 4102c393a42Smrg>This element contains a directory name which will be scanned for font files 4112c393a42Smrgto include in the set of available fonts. 4122c393a42Smrg </P 4132c393a42Smrg></DIV 4142c393a42Smrg><DIV 4152c393a42SmrgCLASS="REFSECT2" 4162c393a42Smrg><A 4172c393a42SmrgNAME="AEN71" 4182c393a42Smrg></A 4192c393a42Smrg><H3 4202c393a42Smrg><TT 4212c393a42SmrgCLASS="LITERAL" 4222c393a42Smrg><cache></TT 4232c393a42Smrg></H3 4242c393a42Smrg><P 4252c393a42Smrg>This element contains a file name for the per-user cache of font 4262c393a42Smrginformation. If it starts with '~', it refers to a file in the users 4272c393a42Smrghome directory. This file is used to hold information about fonts that 4282c393a42Smrgisn't present in the per-directory cache files. It is automatically 4292c393a42Smrgmaintained by the fontconfig library. The default for this file 4302c393a42Smrgis ``~/.fonts.cache-<TT 4312c393a42SmrgCLASS="LITERAL" 4322c393a42Smrg><version></TT 4332c393a42Smrg>'', where <TT 4342c393a42SmrgCLASS="LITERAL" 4352c393a42Smrg><version></TT 4362c393a42Smrg> is the font configuration 4372c393a42Smrgfile version number (currently 2). 4382c393a42Smrg </P 4392c393a42Smrg></DIV 4402c393a42Smrg><DIV 4412c393a42SmrgCLASS="REFSECT2" 4422c393a42Smrg><A 4432c393a42SmrgNAME="AEN77" 4442c393a42Smrg></A 4452c393a42Smrg><H3 4462c393a42Smrg><TT 4472c393a42SmrgCLASS="LITERAL" 4482c393a42Smrg><include ignore_missing="no"></TT 4492c393a42Smrg></H3 4502c393a42Smrg><P 4512c393a42Smrg>This element contains the name of an additional configuration file or 4522c393a42Smrgdirectory. If a directory, every file within that directory starting with an 4532c393a42SmrgASCII digit (U+0030 - U+0039) and ending with the string ``.conf'' will be processed in sorted order. When 4542c393a42Smrgthe XML datatype is traversed by FcConfigParse, the contents of the file(s) 4552c393a42Smrgwill also be incorporated into the configuration by passing the filename(s) to 4562c393a42SmrgFcConfigLoadAndParse. If 'ignore_missing' is set to "yes" instead of the 4572c393a42Smrgdefault "no", a missing file or directory will elicit no warning message from 4582c393a42Smrgthe library. 4592c393a42Smrg </P 4602c393a42Smrg></DIV 4612c393a42Smrg><DIV 4622c393a42SmrgCLASS="REFSECT2" 4632c393a42Smrg><A 4642c393a42SmrgNAME="AEN81" 4652c393a42Smrg></A 4662c393a42Smrg><H3 4672c393a42Smrg><TT 4682c393a42SmrgCLASS="LITERAL" 4692c393a42Smrg><config></TT 4702c393a42Smrg></H3 4712c393a42Smrg><P 4722c393a42Smrg>This element provides a place to consolidate additional configuration 4732c393a42Smrginformation. <TT 4742c393a42SmrgCLASS="LITERAL" 4752c393a42Smrg><config></TT 4762c393a42Smrg> can contain <TT 4772c393a42SmrgCLASS="LITERAL" 4782c393a42Smrg><blank></TT 4792c393a42Smrg> and <TT 4802c393a42SmrgCLASS="LITERAL" 4812c393a42Smrg><rescan></TT 4822c393a42Smrg> elements in any 4832c393a42Smrgorder. 4842c393a42Smrg </P 4852c393a42Smrg></DIV 4862c393a42Smrg><DIV 4872c393a42SmrgCLASS="REFSECT2" 4882c393a42Smrg><A 4892c393a42SmrgNAME="AEN88" 4902c393a42Smrg></A 4912c393a42Smrg><H3 4922c393a42Smrg><TT 4932c393a42SmrgCLASS="LITERAL" 4942c393a42Smrg><blank></TT 4952c393a42Smrg></H3 4962c393a42Smrg><P 4972c393a42Smrg>Fonts often include "broken" glyphs which appear in the encoding but are 4982c393a42Smrgdrawn as blanks on the screen. Within the <TT 4992c393a42SmrgCLASS="LITERAL" 5002c393a42Smrg><blank></TT 5012c393a42Smrg> element, place each 5022c393a42SmrgUnicode characters which is supposed to be blank in an <TT 5032c393a42SmrgCLASS="LITERAL" 5042c393a42Smrg><int></TT 5052c393a42Smrg> element. 5062c393a42SmrgCharacters outside of this set which are drawn as blank will be elided from 5072c393a42Smrgthe set of characters supported by the font. 5082c393a42Smrg </P 5092c393a42Smrg></DIV 5102c393a42Smrg><DIV 5112c393a42SmrgCLASS="REFSECT2" 5122c393a42Smrg><A 5132c393a42SmrgNAME="AEN94" 5142c393a42Smrg></A 5152c393a42Smrg><H3 5162c393a42Smrg><TT 5172c393a42SmrgCLASS="LITERAL" 5182c393a42Smrg><rescan></TT 5192c393a42Smrg></H3 5202c393a42Smrg><P 5212c393a42Smrg>The <TT 5222c393a42SmrgCLASS="LITERAL" 5232c393a42Smrg><rescan></TT 5242c393a42Smrg> element holds an <TT 5252c393a42SmrgCLASS="LITERAL" 5262c393a42Smrg><int></TT 5272c393a42Smrg> element which indicates the default 5282c393a42Smrginterval between automatic checks for font configuration changes. 5292c393a42SmrgFontconfig will validate all of the configuration files and directories and 5302c393a42Smrgautomatically rebuild the internal datastructures when this interval passes. 5312c393a42Smrg </P 5322c393a42Smrg></DIV 5332c393a42Smrg><DIV 5342c393a42SmrgCLASS="REFSECT2" 5352c393a42Smrg><A 5362c393a42SmrgNAME="AEN100" 5372c393a42Smrg></A 5382c393a42Smrg><H3 5392c393a42Smrg><TT 5402c393a42SmrgCLASS="LITERAL" 5412c393a42Smrg><selectfont></TT 5422c393a42Smrg></H3 5432c393a42Smrg><P 5442c393a42Smrg>This element is used to black/white list fonts from being listed or matched 5452c393a42Smrgagainst. It holds acceptfont and rejectfont elements. 5462c393a42Smrg </P 5472c393a42Smrg></DIV 5482c393a42Smrg><DIV 5492c393a42SmrgCLASS="REFSECT2" 5502c393a42Smrg><A 5512c393a42SmrgNAME="AEN104" 5522c393a42Smrg></A 5532c393a42Smrg><H3 5542c393a42Smrg><TT 5552c393a42SmrgCLASS="LITERAL" 5562c393a42Smrg><acceptfont></TT 5572c393a42Smrg></H3 5582c393a42Smrg><P 5592c393a42Smrg>Fonts matched by an acceptfont element are "whitelisted"; such fonts are 5602c393a42Smrgexplicitly included in the set of fonts used to resolve list and match 5612c393a42Smrgrequests; including them in this list protects them from being "blacklisted" 5622c393a42Smrgby a rejectfont element. Acceptfont elements include glob and pattern 5632c393a42Smrgelements which are used to match fonts. 5642c393a42Smrg </P 5652c393a42Smrg></DIV 5662c393a42Smrg><DIV 5672c393a42SmrgCLASS="REFSECT2" 5682c393a42Smrg><A 5692c393a42SmrgNAME="AEN108" 5702c393a42Smrg></A 5712c393a42Smrg><H3 5722c393a42Smrg><TT 5732c393a42SmrgCLASS="LITERAL" 5742c393a42Smrg><rejectfont></TT 5752c393a42Smrg></H3 5762c393a42Smrg><P 5772c393a42Smrg>Fonts matched by an rejectfont element are "blacklisted"; such fonts are 5782c393a42Smrgexcluded from the set of fonts used to resolve list and match requests as if 5792c393a42Smrgthey didn't exist in the system. Rejectfont elements include glob and 5802c393a42Smrgpattern elements which are used to match fonts. 5812c393a42Smrg </P 5822c393a42Smrg></DIV 5832c393a42Smrg><DIV 5842c393a42SmrgCLASS="REFSECT2" 5852c393a42Smrg><A 5862c393a42SmrgNAME="AEN112" 5872c393a42Smrg></A 5882c393a42Smrg><H3 5892c393a42Smrg><TT 5902c393a42SmrgCLASS="LITERAL" 5912c393a42Smrg><glob></TT 5922c393a42Smrg></H3 5932c393a42Smrg><P 5942c393a42Smrg>Glob elements hold shell-style filename matching patterns (including ? and 5952c393a42Smrg*) which match fonts based on their complete pathnames. This can be used to 5962c393a42Smrgexclude a set of directories (/usr/share/fonts/uglyfont*), or particular 5972c393a42Smrgfont file types (*.pcf.gz), but the latter mechanism relies rather heavily 5982c393a42Smrgon filenaming conventions which can't be relied upon. Note that globs 5992c393a42Smrgonly apply to directories, not to individual fonts. 6002c393a42Smrg </P 6012c393a42Smrg></DIV 6022c393a42Smrg><DIV 6032c393a42SmrgCLASS="REFSECT2" 6042c393a42Smrg><A 6052c393a42SmrgNAME="AEN116" 6062c393a42Smrg></A 6072c393a42Smrg><H3 6082c393a42Smrg><TT 6092c393a42SmrgCLASS="LITERAL" 6102c393a42Smrg><pattern></TT 6112c393a42Smrg></H3 6122c393a42Smrg><P 6132c393a42Smrg>Pattern elements perform list-style matching on incoming fonts; that is, 6142c393a42Smrgthey hold a list of elements and associated values. If all of those 6152c393a42Smrgelements have a matching value, then the pattern matches the font. This can 6162c393a42Smrgbe used to select fonts based on attributes of the font (scalable, bold, 6172c393a42Smrgetc), which is a more reliable mechanism than using file extensions. 6182c393a42SmrgPattern elements include patelt elements. 6192c393a42Smrg </P 6202c393a42Smrg></DIV 6212c393a42Smrg><DIV 6222c393a42SmrgCLASS="REFSECT2" 6232c393a42Smrg><A 6242c393a42SmrgNAME="AEN120" 6252c393a42Smrg></A 6262c393a42Smrg><H3 6272c393a42Smrg><TT 6282c393a42SmrgCLASS="LITERAL" 6292c393a42Smrg><patelt name="property"></TT 6302c393a42Smrg></H3 6312c393a42Smrg><P 6322c393a42Smrg>Patelt elements hold a single pattern element and list of values. They must 6332c393a42Smrghave a 'name' attribute which indicates the pattern element name. Patelt 6342c393a42Smrgelements include int, double, string, matrix, bool, charset and const 6352c393a42Smrgelements. 6362c393a42Smrg </P 6372c393a42Smrg></DIV 6382c393a42Smrg><DIV 6392c393a42SmrgCLASS="REFSECT2" 6402c393a42Smrg><A 6412c393a42SmrgNAME="AEN124" 6422c393a42Smrg></A 6432c393a42Smrg><H3 6442c393a42Smrg><TT 6452c393a42SmrgCLASS="LITERAL" 6462c393a42Smrg><match target="pattern"></TT 6472c393a42Smrg></H3 6482c393a42Smrg><P 6492c393a42Smrg>This element holds first a (possibly empty) list of <TT 6502c393a42SmrgCLASS="LITERAL" 6512c393a42Smrg><test></TT 6522c393a42Smrg> elements and then 6532c393a42Smrga (possibly empty) list of <TT 6542c393a42SmrgCLASS="LITERAL" 6552c393a42Smrg><edit></TT 6562c393a42Smrg> elements. Patterns which match all of the 6572c393a42Smrgtests are subjected to all the edits. If 'target' is set to "font" instead 6582c393a42Smrgof the default "pattern", then this element applies to the font name 6592c393a42Smrgresulting from a match rather than a font pattern to be matched. If 'target' 6602c393a42Smrgis set to "scan", then this element applies when the font is scanned to 6612c393a42Smrgbuild the fontconfig database. 6622c393a42Smrg </P 6632c393a42Smrg></DIV 6642c393a42Smrg><DIV 6652c393a42SmrgCLASS="REFSECT2" 6662c393a42Smrg><A 6672c393a42SmrgNAME="AEN130" 6682c393a42Smrg></A 6692c393a42Smrg><H3 6702c393a42Smrg><TT 6712c393a42SmrgCLASS="LITERAL" 6722c393a42Smrg><test qual="any" name="property" target="default" compare="eq"></TT 6732c393a42Smrg></H3 6742c393a42Smrg><P 6752c393a42Smrg>This element contains a single value which is compared with the target 6762c393a42Smrg('pattern', 'font', 'scan' or 'default') property "property" (substitute any of the property names seen 6772c393a42Smrgabove). 'compare' can be one of "eq", "not_eq", "less", "less_eq", "more", or 6782c393a42Smrg"more_eq". 'qual' may either be the default, "any", in which case the match 6792c393a42Smrgsucceeds if any value associated with the property matches the test value, or 6802c393a42Smrg"all", in which case all of the values associated with the property must 6812c393a42Smrgmatch the test value. When used in a <match target="font"> element, 6822c393a42Smrgthe target= attribute in the <test> element selects between matching 6832c393a42Smrgthe original pattern or the font. "default" selects whichever target the 6842c393a42Smrgouter <match> element has selected. 6852c393a42Smrg </P 6862c393a42Smrg></DIV 6872c393a42Smrg><DIV 6882c393a42SmrgCLASS="REFSECT2" 6892c393a42Smrg><A 6902c393a42SmrgNAME="AEN134" 6912c393a42Smrg></A 6922c393a42Smrg><H3 6932c393a42Smrg><TT 6942c393a42SmrgCLASS="LITERAL" 6952c393a42Smrg><edit name="property" mode="assign" binding="weak"></TT 6962c393a42Smrg></H3 6972c393a42Smrg><P 6982c393a42Smrg>This element contains a list of expression elements (any of the value or 6992c393a42Smrgoperator elements). The expression elements are evaluated at run-time and 7002c393a42Smrgmodify the property "property". The modification depends on whether 7012c393a42Smrg"property" was matched by one of the associated <TT 7022c393a42SmrgCLASS="LITERAL" 7032c393a42Smrg><test></TT 7042c393a42Smrg> elements, if so, the 7052c393a42Smrgmodification may affect the first matched value. Any values inserted into 7062c393a42Smrgthe property are given the indicated binding ("strong", "weak" or "same") 7072c393a42Smrgwith "same" binding using the value from the matched pattern element. 7082c393a42Smrg'mode' is one of: 7092c393a42Smrg <PRE 7102c393a42SmrgCLASS="PROGRAMLISTING" 7112c393a42Smrg> Mode With Match Without Match 7122c393a42Smrg --------------------------------------------------------------------- 7132c393a42Smrg "assign" Replace matching value Replace all values 7142c393a42Smrg "assign_replace" Replace all values Replace all values 7152c393a42Smrg "prepend" Insert before matching Insert at head of list 7162c393a42Smrg "prepend_first" Insert at head of list Insert at head of list 7172c393a42Smrg "append" Append after matching Append at end of list 7182c393a42Smrg "append_last" Append at end of list Append at end of list 7192c393a42Smrg </PRE 7202c393a42Smrg> 7212c393a42Smrg </P 7222c393a42Smrg></DIV 7232c393a42Smrg><DIV 7242c393a42SmrgCLASS="REFSECT2" 7252c393a42Smrg><A 7262c393a42SmrgNAME="AEN140" 7272c393a42Smrg></A 7282c393a42Smrg><H3 7292c393a42Smrg><TT 7302c393a42SmrgCLASS="LITERAL" 7312c393a42Smrg><int></TT 7322c393a42Smrg>, <TT 7332c393a42SmrgCLASS="LITERAL" 7342c393a42Smrg><double></TT 7352c393a42Smrg>, <TT 7362c393a42SmrgCLASS="LITERAL" 7372c393a42Smrg><string></TT 7382c393a42Smrg>, <TT 7392c393a42SmrgCLASS="LITERAL" 7402c393a42Smrg><bool></TT 7412c393a42Smrg></H3 7422c393a42Smrg><P 7432c393a42Smrg>These elements hold a single value of the indicated type. <TT 7442c393a42SmrgCLASS="LITERAL" 7452c393a42Smrg><bool></TT 7462c393a42Smrg> 7472c393a42Smrgelements hold either true or false. An important limitation exists in 7482c393a42Smrgthe parsing of floating point numbers -- fontconfig requires that 7492c393a42Smrgthe mantissa start with a digit, not a decimal point, so insert a leading 7502c393a42Smrgzero for purely fractional values (e.g. use 0.5 instead of .5 and -0.5 7512c393a42Smrginstead of -.5). 7522c393a42Smrg </P 7532c393a42Smrg></DIV 7542c393a42Smrg><DIV 7552c393a42SmrgCLASS="REFSECT2" 7562c393a42Smrg><A 7572c393a42SmrgNAME="AEN148" 7582c393a42Smrg></A 7592c393a42Smrg><H3 7602c393a42Smrg><TT 7612c393a42SmrgCLASS="LITERAL" 7622c393a42Smrg><matrix></TT 7632c393a42Smrg></H3 7642c393a42Smrg><P 7652c393a42Smrg>This element holds the four <TT 7662c393a42SmrgCLASS="LITERAL" 7672c393a42Smrg><double></TT 7682c393a42Smrg> elements of an affine 7692c393a42Smrgtransformation. 7702c393a42Smrg </P 7712c393a42Smrg></DIV 7722c393a42Smrg><DIV 7732c393a42SmrgCLASS="REFSECT2" 7742c393a42Smrg><A 7752c393a42SmrgNAME="AEN153" 7762c393a42Smrg></A 7772c393a42Smrg><H3 7782c393a42Smrg><TT 7792c393a42SmrgCLASS="LITERAL" 7802c393a42Smrg><name></TT 7812c393a42Smrg></H3 7822c393a42Smrg><P 7832c393a42Smrg>Holds a property name. Evaluates to the first value from the property of 7842c393a42Smrgthe font, not the pattern. 7852c393a42Smrg </P 7862c393a42Smrg></DIV 7872c393a42Smrg><DIV 7882c393a42SmrgCLASS="REFSECT2" 7892c393a42Smrg><A 7902c393a42SmrgNAME="AEN157" 7912c393a42Smrg></A 7922c393a42Smrg><H3 7932c393a42Smrg><TT 7942c393a42SmrgCLASS="LITERAL" 7952c393a42Smrg><const></TT 7962c393a42Smrg></H3 7972c393a42Smrg><P 7982c393a42Smrg>Holds the name of a constant; these are always integers and serve as 7992c393a42Smrgsymbolic names for common font values: 8002c393a42Smrg <PRE 8012c393a42SmrgCLASS="PROGRAMLISTING" 8022c393a42Smrg> Constant Property Value 8032c393a42Smrg ------------------------------------- 8042c393a42Smrg thin weight 0 8052c393a42Smrg extralight weight 40 8062c393a42Smrg ultralight weight 40 8072c393a42Smrg light weight 50 8082c393a42Smrg book weight 75 8092c393a42Smrg regular weight 80 8102c393a42Smrg normal weight 80 8112c393a42Smrg medium weight 100 8122c393a42Smrg demibold weight 180 8132c393a42Smrg semibold weight 180 8142c393a42Smrg bold weight 200 8152c393a42Smrg extrabold weight 205 8162c393a42Smrg black weight 210 8172c393a42Smrg heavy weight 210 8182c393a42Smrg roman slant 0 8192c393a42Smrg italic slant 100 8202c393a42Smrg oblique slant 110 8212c393a42Smrg ultracondensed width 50 8222c393a42Smrg extracondensed width 63 8232c393a42Smrg condensed width 75 8242c393a42Smrg semicondensed width 87 8252c393a42Smrg normal width 100 8262c393a42Smrg semiexpanded width 113 8272c393a42Smrg expanded width 125 8282c393a42Smrg extraexpanded width 150 8292c393a42Smrg ultraexpanded width 200 8302c393a42Smrg proportional spacing 0 8312c393a42Smrg dual spacing 90 8322c393a42Smrg mono spacing 100 8332c393a42Smrg charcell spacing 110 8342c393a42Smrg unknown rgba 0 8352c393a42Smrg rgb rgba 1 8362c393a42Smrg bgr rgba 2 8372c393a42Smrg vrgb rgba 3 8382c393a42Smrg vbgr rgba 4 8392c393a42Smrg none rgba 5 8402c393a42Smrg lcdnone lcdfilter 0 8412c393a42Smrg lcddefault lcdfilter 1 8422c393a42Smrg lcdlight lcdfilter 2 8432c393a42Smrg lcdlegacy lcdfilter 3 8442c393a42Smrg hintnone hintstyle 0 8452c393a42Smrg hintslight hintstyle 1 8462c393a42Smrg hintmedium hintstyle 2 8472c393a42Smrg hintfull hintstyle 3 8482c393a42Smrg </PRE 8492c393a42Smrg> 8502c393a42Smrg </P 8512c393a42Smrg></DIV 8522c393a42Smrg><DIV 8532c393a42SmrgCLASS="REFSECT2" 8542c393a42Smrg><A 8552c393a42SmrgNAME="AEN162" 8562c393a42Smrg></A 8572c393a42Smrg><H3 8582c393a42Smrg><TT 8592c393a42SmrgCLASS="LITERAL" 8602c393a42Smrg><or></TT 8612c393a42Smrg>, <TT 8622c393a42SmrgCLASS="LITERAL" 8632c393a42Smrg><and></TT 8642c393a42Smrg>, <TT 8652c393a42SmrgCLASS="LITERAL" 8662c393a42Smrg><plus></TT 8672c393a42Smrg>, <TT 8682c393a42SmrgCLASS="LITERAL" 8692c393a42Smrg><minus></TT 8702c393a42Smrg>, <TT 8712c393a42SmrgCLASS="LITERAL" 8722c393a42Smrg><times></TT 8732c393a42Smrg>, <TT 8742c393a42SmrgCLASS="LITERAL" 8752c393a42Smrg><divide></TT 8762c393a42Smrg></H3 8772c393a42Smrg><P 8782c393a42Smrg>These elements perform the specified operation on a list of expression 8792c393a42Smrgelements. <TT 8802c393a42SmrgCLASS="LITERAL" 8812c393a42Smrg><or></TT 8822c393a42Smrg> and <TT 8832c393a42SmrgCLASS="LITERAL" 8842c393a42Smrg><and></TT 8852c393a42Smrg> are boolean, not bitwise. 8862c393a42Smrg </P 8872c393a42Smrg></DIV 8882c393a42Smrg><DIV 8892c393a42SmrgCLASS="REFSECT2" 8902c393a42Smrg><A 8912c393a42SmrgNAME="AEN173" 8922c393a42Smrg></A 8932c393a42Smrg><H3 8942c393a42Smrg><TT 8952c393a42SmrgCLASS="LITERAL" 8962c393a42Smrg><eq></TT 8972c393a42Smrg>, <TT 8982c393a42SmrgCLASS="LITERAL" 8992c393a42Smrg><not_eq></TT 9002c393a42Smrg>, <TT 9012c393a42SmrgCLASS="LITERAL" 9022c393a42Smrg><less></TT 9032c393a42Smrg>, <TT 9042c393a42SmrgCLASS="LITERAL" 9052c393a42Smrg><less_eq></TT 9062c393a42Smrg>, <TT 9072c393a42SmrgCLASS="LITERAL" 9082c393a42Smrg><more></TT 9092c393a42Smrg>, <TT 9102c393a42SmrgCLASS="LITERAL" 9112c393a42Smrg><more_eq></TT 9122c393a42Smrg></H3 9132c393a42Smrg><P 9142c393a42Smrg>These elements compare two values, producing a boolean result. 9152c393a42Smrg </P 9162c393a42Smrg></DIV 9172c393a42Smrg><DIV 9182c393a42SmrgCLASS="REFSECT2" 9192c393a42Smrg><A 9202c393a42SmrgNAME="AEN182" 9212c393a42Smrg></A 9222c393a42Smrg><H3 9232c393a42Smrg><TT 9242c393a42SmrgCLASS="LITERAL" 9252c393a42Smrg><not></TT 9262c393a42Smrg></H3 9272c393a42Smrg><P 9282c393a42Smrg>Inverts the boolean sense of its one expression element 9292c393a42Smrg </P 9302c393a42Smrg></DIV 9312c393a42Smrg><DIV 9322c393a42SmrgCLASS="REFSECT2" 9332c393a42Smrg><A 9342c393a42SmrgNAME="AEN186" 9352c393a42Smrg></A 9362c393a42Smrg><H3 9372c393a42Smrg><TT 9382c393a42SmrgCLASS="LITERAL" 9392c393a42Smrg><if></TT 9402c393a42Smrg></H3 9412c393a42Smrg><P 9422c393a42Smrg>This element takes three expression elements; if the value of the first is 9432c393a42Smrgtrue, it produces the value of the second, otherwise it produces the value 9442c393a42Smrgof the third. 9452c393a42Smrg </P 9462c393a42Smrg></DIV 9472c393a42Smrg><DIV 9482c393a42SmrgCLASS="REFSECT2" 9492c393a42Smrg><A 9502c393a42SmrgNAME="AEN190" 9512c393a42Smrg></A 9522c393a42Smrg><H3 9532c393a42Smrg><TT 9542c393a42SmrgCLASS="LITERAL" 9552c393a42Smrg><alias></TT 9562c393a42Smrg></H3 9572c393a42Smrg><P 9582c393a42Smrg>Alias elements provide a shorthand notation for the set of common match 9592c393a42Smrgoperations needed to substitute one font family for another. They contain a 9602c393a42Smrg<TT 9612c393a42SmrgCLASS="LITERAL" 9622c393a42Smrg><family></TT 9632c393a42Smrg> element followed by optional <TT 9642c393a42SmrgCLASS="LITERAL" 9652c393a42Smrg><prefer></TT 9662c393a42Smrg>, <TT 9672c393a42SmrgCLASS="LITERAL" 9682c393a42Smrg><accept></TT 9692c393a42Smrg> and <TT 9702c393a42SmrgCLASS="LITERAL" 9712c393a42Smrg><default></TT 9722c393a42Smrg> 9732c393a42Smrgelements. Fonts matching the <TT 9742c393a42SmrgCLASS="LITERAL" 9752c393a42Smrg><family></TT 9762c393a42Smrg> element are edited to prepend the 9772c393a42Smrglist of <TT 9782c393a42SmrgCLASS="LITERAL" 9792c393a42Smrg><prefer></TT 9802c393a42Smrg>ed families before the matching <TT 9812c393a42SmrgCLASS="LITERAL" 9822c393a42Smrg><family></TT 9832c393a42Smrg>, append the 9842c393a42Smrg<TT 9852c393a42SmrgCLASS="LITERAL" 9862c393a42Smrg><accept></TT 9872c393a42Smrg>able families after the matching <TT 9882c393a42SmrgCLASS="LITERAL" 9892c393a42Smrg><family></TT 9902c393a42Smrg> and append the <TT 9912c393a42SmrgCLASS="LITERAL" 9922c393a42Smrg><default></TT 9932c393a42Smrg> 9942c393a42Smrgfamilies to the end of the family list. 9952c393a42Smrg </P 9962c393a42Smrg></DIV 9972c393a42Smrg><DIV 9982c393a42SmrgCLASS="REFSECT2" 9992c393a42Smrg><A 10002c393a42SmrgNAME="AEN204" 10012c393a42Smrg></A 10022c393a42Smrg><H3 10032c393a42Smrg><TT 10042c393a42SmrgCLASS="LITERAL" 10052c393a42Smrg><family></TT 10062c393a42Smrg></H3 10072c393a42Smrg><P 10082c393a42Smrg>Holds a single font family name 10092c393a42Smrg </P 10102c393a42Smrg></DIV 10112c393a42Smrg><DIV 10122c393a42SmrgCLASS="REFSECT2" 10132c393a42Smrg><A 10142c393a42SmrgNAME="AEN208" 10152c393a42Smrg></A 10162c393a42Smrg><H3 10172c393a42Smrg><TT 10182c393a42SmrgCLASS="LITERAL" 10192c393a42Smrg><prefer></TT 10202c393a42Smrg>, <TT 10212c393a42SmrgCLASS="LITERAL" 10222c393a42Smrg><accept></TT 10232c393a42Smrg>, <TT 10242c393a42SmrgCLASS="LITERAL" 10252c393a42Smrg><default></TT 10262c393a42Smrg></H3 10272c393a42Smrg><P 10282c393a42Smrg>These hold a list of <TT 10292c393a42SmrgCLASS="LITERAL" 10302c393a42Smrg><family></TT 10312c393a42Smrg> elements to be used by the <TT 10322c393a42SmrgCLASS="LITERAL" 10332c393a42Smrg><alias></TT 10342c393a42Smrg> element. 10352c393a42Smrg </P 10362c393a42Smrg></DIV 10372c393a42Smrg></DIV 10382c393a42Smrg><DIV 10392c393a42SmrgCLASS="REFSECT1" 10402c393a42Smrg><A 10412c393a42SmrgNAME="AEN216" 10422c393a42Smrg></A 10432c393a42Smrg><H2 10442c393a42Smrg>EXAMPLE CONFIGURATION FILE</H2 10452c393a42Smrg><DIV 10462c393a42SmrgCLASS="REFSECT2" 10472c393a42Smrg><A 10482c393a42SmrgNAME="AEN218" 10492c393a42Smrg></A 10502c393a42Smrg><H3 10512c393a42Smrg>System configuration file</H3 10522c393a42Smrg><P 10532c393a42Smrg>This is an example of a system-wide configuration file 10542c393a42Smrg </P 10552c393a42Smrg><PRE 10562c393a42SmrgCLASS="PROGRAMLISTING" 10572c393a42Smrg><?xml version="1.0"?> 10582c393a42Smrg<!DOCTYPE fontconfig SYSTEM "fonts.dtd"> 10592c393a42Smrg<!-- /etc/fonts/fonts.conf file to configure system font access --> 10602c393a42Smrg<fontconfig> 10612c393a42Smrg<!-- 10622c393a42Smrg Find fonts in these directories 10632c393a42Smrg--> 10642c393a42Smrg<dir>/usr/share/fonts</dir> 10652c393a42Smrg<dir>/usr/X11R6/lib/X11/fonts</dir> 10662c393a42Smrg 10672c393a42Smrg<!-- 10682c393a42Smrg Accept deprecated 'mono' alias, replacing it with 'monospace' 10692c393a42Smrg--> 10702c393a42Smrg<match target="pattern"> 10712c393a42Smrg <test qual="any" name="family"><string>mono</string></test> 10722c393a42Smrg <edit name="family" mode="assign"><string>monospace</string></edit> 10732c393a42Smrg</match> 10742c393a42Smrg 10752c393a42Smrg<!-- 10762c393a42Smrg Names not including any well known alias are given 'sans' 10772c393a42Smrg--> 10782c393a42Smrg<match target="pattern"> 10792c393a42Smrg <test qual="all" name="family" mode="not_eq">sans</test> 10802c393a42Smrg <test qual="all" name="family" mode="not_eq">serif</test> 10812c393a42Smrg <test qual="all" name="family" mode="not_eq">monospace</test> 10822c393a42Smrg <edit name="family" mode="append_last"><string>sans</string></edit> 10832c393a42Smrg</match> 10842c393a42Smrg 10852c393a42Smrg<!-- 10862c393a42Smrg Load per-user customization file, but don't complain 10872c393a42Smrg if it doesn't exist 10882c393a42Smrg--> 10892c393a42Smrg<include ignore_missing="yes">~/.fonts.conf</include> 10902c393a42Smrg 10912c393a42Smrg<!-- 10922c393a42Smrg Load local customization files, but don't complain 10932c393a42Smrg if there aren't any 10942c393a42Smrg--> 10952c393a42Smrg<include ignore_missing="yes">conf.d</include> 10962c393a42Smrg<include ignore_missing="yes">local.conf</include> 10972c393a42Smrg 10982c393a42Smrg<!-- 10992c393a42Smrg Alias well known font names to available TrueType fonts. 11002c393a42Smrg These substitute TrueType faces for similar Type1 11012c393a42Smrg faces to improve screen appearance. 11022c393a42Smrg--> 11032c393a42Smrg<alias> 11042c393a42Smrg <family>Times</family> 11052c393a42Smrg <prefer><family>Times New Roman</family></prefer> 11062c393a42Smrg <default><family>serif</family></default> 11072c393a42Smrg</alias> 11082c393a42Smrg<alias> 11092c393a42Smrg <family>Helvetica</family> 11102c393a42Smrg <prefer><family>Arial</family></prefer> 11112c393a42Smrg <default><family>sans</family></default> 11122c393a42Smrg</alias> 11132c393a42Smrg<alias> 11142c393a42Smrg <family>Courier</family> 11152c393a42Smrg <prefer><family>Courier New</family></prefer> 11162c393a42Smrg <default><family>monospace</family></default> 11172c393a42Smrg</alias> 11182c393a42Smrg 11192c393a42Smrg<!-- 11202c393a42Smrg Provide required aliases for standard names 11212c393a42Smrg Do these after the users configuration file so that 11222c393a42Smrg any aliases there are used preferentially 11232c393a42Smrg--> 11242c393a42Smrg<alias> 11252c393a42Smrg <family>serif</family> 11262c393a42Smrg <prefer><family>Times New Roman</family></prefer> 11272c393a42Smrg</alias> 11282c393a42Smrg<alias> 11292c393a42Smrg <family>sans</family> 11302c393a42Smrg <prefer><family>Arial</family></prefer> 11312c393a42Smrg</alias> 11322c393a42Smrg<alias> 11332c393a42Smrg <family>monospace</family> 11342c393a42Smrg <prefer><family>Andale Mono</family></prefer> 11352c393a42Smrg</alias> 11362c393a42Smrg</fontconfig> 11372c393a42Smrg </PRE 11382c393a42Smrg></DIV 11392c393a42Smrg><DIV 11402c393a42SmrgCLASS="REFSECT2" 11412c393a42Smrg><A 11422c393a42SmrgNAME="AEN222" 11432c393a42Smrg></A 11442c393a42Smrg><H3 11452c393a42Smrg>User configuration file</H3 11462c393a42Smrg><P 11472c393a42Smrg>This is an example of a per-user configuration file that lives in 11482c393a42Smrg~/.fonts.conf 11492c393a42Smrg </P 11502c393a42Smrg><PRE 11512c393a42SmrgCLASS="PROGRAMLISTING" 11522c393a42Smrg><?xml version="1.0"?> 11532c393a42Smrg<!DOCTYPE fontconfig SYSTEM "fonts.dtd"> 11542c393a42Smrg<!-- ~/.fonts.conf for per-user font configuration --> 11552c393a42Smrg<fontconfig> 11562c393a42Smrg 11572c393a42Smrg<!-- 11582c393a42Smrg Private font directory 11592c393a42Smrg--> 11602c393a42Smrg<dir>~/.fonts</dir> 11612c393a42Smrg 11622c393a42Smrg<!-- 11632c393a42Smrg use rgb sub-pixel ordering to improve glyph appearance on 11642c393a42Smrg LCD screens. Changes affecting rendering, but not matching 11652c393a42Smrg should always use target="font". 11662c393a42Smrg--> 11672c393a42Smrg<match target="font"> 11682c393a42Smrg <edit name="rgba" mode="assign"><const>rgb</const></edit> 11692c393a42Smrg</match> 11702c393a42Smrg</fontconfig> 11712c393a42Smrg </PRE 11722c393a42Smrg></DIV 11732c393a42Smrg></DIV 11742c393a42Smrg><DIV 11752c393a42SmrgCLASS="REFSECT1" 11762c393a42Smrg><A 11772c393a42SmrgNAME="AEN226" 11782c393a42Smrg></A 11792c393a42Smrg><H2 11802c393a42Smrg>Files</H2 11812c393a42Smrg><P 11822c393a42Smrg><SPAN 11832c393a42SmrgCLASS="emphasis" 11842c393a42Smrg><I 11852c393a42SmrgCLASS="EMPHASIS" 11862c393a42Smrg>fonts.conf</I 11872c393a42Smrg></SPAN 11882c393a42Smrg> 11892c393a42Smrgcontains configuration information for the fontconfig library 11902c393a42Smrgconsisting of directories to look at for font information as well as 11912c393a42Smrginstructions on editing program specified font patterns before attempting to 11922c393a42Smrgmatch the available fonts. It is in xml format. 11932c393a42Smrg </P 11942c393a42Smrg><P 11952c393a42Smrg><SPAN 11962c393a42SmrgCLASS="emphasis" 11972c393a42Smrg><I 11982c393a42SmrgCLASS="EMPHASIS" 11992c393a42Smrg>conf.d</I 12002c393a42Smrg></SPAN 12012c393a42Smrg> 12022c393a42Smrgis the conventional name for a directory of additional configuration files 12032c393a42Smrgmanaged by external applications or the local administrator. The 12042c393a42Smrgfilenames starting with decimal digits are sorted in lexicographic order 12052c393a42Smrgand used as additional configuration files. All of these files are in xml 12062c393a42Smrgformat. The master fonts.conf file references this directory in an 12072c393a42Smrg<include> directive. 12082c393a42Smrg </P 12092c393a42Smrg><P 12102c393a42Smrg><SPAN 12112c393a42SmrgCLASS="emphasis" 12122c393a42Smrg><I 12132c393a42SmrgCLASS="EMPHASIS" 12142c393a42Smrg>fonts.dtd</I 12152c393a42Smrg></SPAN 12162c393a42Smrg> 12172c393a42Smrgis a DTD that describes the format of the configuration files. 12182c393a42Smrg </P 12192c393a42Smrg><P 12202c393a42Smrg><SPAN 12212c393a42SmrgCLASS="emphasis" 12222c393a42Smrg><I 12232c393a42SmrgCLASS="EMPHASIS" 12242c393a42Smrg>~/.fonts.conf</I 12252c393a42Smrg></SPAN 12262c393a42Smrg> 12272c393a42Smrgis the conventional location for per-user font configuration, although the 12282c393a42Smrgactual location is specified in the global fonts.conf file. 12292c393a42Smrg </P 12302c393a42Smrg><P 12312c393a42Smrg><SPAN 12322c393a42SmrgCLASS="emphasis" 12332c393a42Smrg><I 12342c393a42SmrgCLASS="EMPHASIS" 12352c393a42Smrg> ~/.fonts.cache-*</I 12362c393a42Smrg></SPAN 12372c393a42Smrg> 12382c393a42Smrgis the conventional repository of font information that isn't found in the 12392c393a42Smrgper-directory caches. This file is automatically maintained by fontconfig. 12402c393a42Smrg </P 12412c393a42Smrg></DIV 12422c393a42Smrg><DIV 12432c393a42SmrgCLASS="REFSECT1" 12442c393a42Smrg><A 12452c393a42SmrgNAME="AEN238" 12462c393a42Smrg></A 12472c393a42Smrg><H2 12482c393a42Smrg>See Also</H2 12492c393a42Smrg><P 12502c393a42Smrg>fc-cache(1), fc-match(1), fc-list(1) 12512c393a42Smrg </P 12522c393a42Smrg></DIV 12532c393a42Smrg><DIV 12542c393a42SmrgCLASS="REFSECT1" 12552c393a42Smrg><A 12562c393a42SmrgNAME="AEN241" 12572c393a42Smrg></A 12582c393a42Smrg><H2 12592c393a42Smrg>Version</H2 12602c393a42Smrg><P 12612c393a42Smrg>Fontconfig version 2.6.0 12622c393a42Smrg 12632c393a42Smrg </P 12642c393a42Smrg></DIV 12652c393a42Smrg></BODY 12662c393a42Smrg></HTML 12672c393a42Smrg>