1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >fonts-conf</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD 9 ><BODY 10 CLASS="REFENTRY" 11 BGCOLOR="#FFFFFF" 12 TEXT="#000000" 13 LINK="#0000FF" 14 VLINK="#840084" 15 ALINK="#0000FF" 16 ><H1 17 ><A 18 NAME="AEN1" 19 ></A 20 >fonts-conf</H1 21 ><DIV 22 CLASS="REFNAMEDIV" 23 ><A 24 NAME="AEN5" 25 ></A 26 ><H2 27 >Name</H2 28 >fonts.conf -- Font configuration files</DIV 29 ><DIV 30 CLASS="REFSYNOPSISDIV" 31 ><A 32 NAME="AEN8" 33 ></A 34 ><H2 35 >Synopsis</H2 36 ><TABLE 37 BORDER="0" 38 BGCOLOR="#E0E0E0" 39 WIDTH="100%" 40 ><TR 41 ><TD 42 ><PRE 43 CLASS="SYNOPSIS" 44 > /etc/fonts/fonts.conf 45 /etc/fonts/fonts.dtd 46 /etc/fonts/conf.d 47 $XDG_CONFIG_HOME/fontconfig/conf.d 48 $XDG_CONFIG_HOME/fontconfig/fonts.conf 49 ~/.fonts.conf.d 50 ~/.fonts.conf</PRE 51 ></TD 52 ></TR 53 ></TABLE 54 ></DIV 55 ><DIV 56 CLASS="REFSECT1" 57 ><A 58 NAME="AEN10" 59 ></A 60 ><H2 61 >Description</H2 62 ><P 63 >Fontconfig is a library designed to provide system-wide font configuration, 64 customization and application access. 65 </P 66 ></DIV 67 ><DIV 68 CLASS="REFSECT1" 69 ><A 70 NAME="AEN13" 71 ></A 72 ><H2 73 >Functional Overview</H2 74 ><P 75 >Fontconfig contains two essential modules, the configuration module which 76 builds an internal configuration from XML files and the matching module 77 which accepts font patterns and returns the nearest matching font. 78 </P 79 ><DIV 80 CLASS="REFSECT2" 81 ><A 82 NAME="AEN16" 83 ></A 84 ><H3 85 >Font Configuration</H3 86 ><P 87 >The configuration module consists of the FcConfig datatype, libexpat and 88 FcConfigParse which walks over an XML tree and amends a configuration with 89 data found within. From an external perspective, configuration of the 90 library consists of generating a valid XML tree and feeding that to 91 FcConfigParse. The only other mechanism provided to applications for 92 changing the running configuration is to add fonts and directories to the 93 list of application-provided font files. 94 </P 95 ><P 96 >The intent is to make font configurations relatively static, and shared by 97 as many applications as possible. It is hoped that this will lead to more 98 stable font selection when passing names from one application to another. 99 XML was chosen as a configuration file format because it provides a format 100 which is easy for external agents to edit while retaining the correct 101 structure and syntax. 102 </P 103 ><P 104 >Font configuration is separate from font matching; applications needing to 105 do their own matching can access the available fonts from the library and 106 perform private matching. The intent is to permit applications to pick and 107 choose appropriate functionality from the library instead of forcing them to 108 choose between this library and a private configuration mechanism. The hope 109 is that this will ensure that configuration of fonts for all applications 110 can be centralized in one place. Centralizing font configuration will 111 simplify and regularize font installation and customization. 112 </P 113 ></DIV 114 ><DIV 115 CLASS="REFSECT2" 116 ><A 117 NAME="AEN21" 118 ></A 119 ><H3 120 >Font Properties</H3 121 ><P 122 >While font patterns may contain essentially any properties, there are some 123 well known properties with associated types. Fontconfig uses some of these 124 properties for font matching and font completion. Others are provided as a 125 convenience for the applications' rendering mechanism. 126 </P 127 ><TABLE 128 BORDER="0" 129 BGCOLOR="#E0E0E0" 130 WIDTH="100%" 131 ><TR 132 ><TD 133 ><PRE 134 CLASS="PROGRAMLISTING" 135 >Property Type Description 136 -------------------------------------------------------------- 137 family String Font family names 138 familylang String Languages corresponding to each family 139 style String Font style. Overrides weight and slant 140 stylelang String Languages corresponding to each style 141 fullname String Font full names (often includes style) 142 fullnamelang String Languages corresponding to each fullname 143 slant Int Italic, oblique or roman 144 weight Int Light, medium, demibold, bold or black 145 size Double Point size 146 width Int Condensed, normal or expanded 147 aspect Double Stretches glyphs horizontally before hinting 148 pixelsize Double Pixel size 149 spacing Int Proportional, dual-width, monospace or charcell 150 foundry String Font foundry name 151 antialias Bool Whether glyphs can be antialiased 152 hinting Bool Whether the rasterizer should use hinting 153 hintstyle Int Automatic hinting style 154 verticallayout Bool Use vertical layout 155 autohint Bool Use autohinter instead of normal hinter 156 globaladvance Bool Use font global advance data (deprecated) 157 file String The filename holding the font 158 index Int The index of the font within the file 159 ftface FT_Face Use the specified FreeType face object 160 rasterizer String Which rasterizer is in use (deprecated) 161 outline Bool Whether the glyphs are outlines 162 scalable Bool Whether glyphs can be scaled 163 color Bool Whether any glyphs have color 164 scale Double Scale factor for point->pixel conversions 165 (deprecated) 166 dpi Double Target dots per inch 167 rgba Int unknown, rgb, bgr, vrgb, vbgr, 168 none - subpixel geometry 169 lcdfilter Int Type of LCD filter 170 minspace Bool Eliminate leading from line spacing 171 charset CharSet Unicode chars encoded by the font 172 lang String List of RFC-3066-style languages this 173 font supports 174 fontversion Int Version number of the font 175 capability String List of layout capabilities in the font 176 fontformat String String name of the font format 177 embolden Bool Rasterizer should synthetically embolden the font 178 embeddedbitmap Bool Use the embedded bitmap instead of the outline 179 decorative Bool Whether the style is a decorative variant 180 fontfeatures String List of the feature tags in OpenType to be enabled 181 namelang String Language name to be used for the default value of 182 familylang, stylelang, and fullnamelang 183 prgname String String Name of the running program 184 postscriptname String Font family name in PostScript 185 fonthashint Bool Whether the font has hinting 186 order Int Order number of the font 187 </PRE 188 ></TD 189 ></TR 190 ></TABLE 191 ></DIV 192 ><DIV 193 CLASS="REFSECT2" 194 ><A 195 NAME="AEN25" 196 ></A 197 ><H3 198 >Font Matching</H3 199 ><P 200 >Fontconfig performs matching by measuring the distance from a provided 201 pattern to all of the available fonts in the system. The closest matching 202 font is selected. This ensures that a font will always be returned, but 203 doesn't ensure that it is anything like the requested pattern. 204 </P 205 ><P 206 >Font matching starts with an application constructed pattern. The desired 207 attributes of the resulting font are collected together in a pattern. Each 208 property of the pattern can contain one or more values; these are listed in 209 priority order; matches earlier in the list are considered "closer" than 210 matches later in the list. 211 </P 212 ><P 213 >The initial pattern is modified by applying the list of editing instructions 214 specific to patterns found in the configuration; each consists of a match 215 predicate and a set of editing operations. They are executed in the order 216 they appeared in the configuration. Each match causes the associated 217 sequence of editing operations to be applied. 218 </P 219 ><P 220 >After the pattern has been edited, a sequence of default substitutions are 221 performed to canonicalize the set of available properties; this avoids the 222 need for the lower layers to constantly provide default values for various 223 font properties during rendering. 224 </P 225 ><P 226 >The canonical font pattern is finally matched against all available fonts. 227 The distance from the pattern to the font is measured for each of several 228 properties: foundry, charset, family, lang, spacing, pixelsize, style, 229 slant, weight, antialias, rasterizer and outline. This list is in priority 230 order -- results of comparing earlier elements of this list weigh more 231 heavily than later elements. 232 </P 233 ><P 234 >There is one special case to this rule; family names are split into two 235 bindings; strong and weak. Strong family names are given greater precedence 236 in the match than lang elements while weak family names are given lower 237 precedence than lang elements. This permits the document language to drive 238 font selection when any document specified font is unavailable. 239 </P 240 ><P 241 >The pattern representing that font is augmented to include any properties 242 found in the pattern but not found in the font itself; this permits the 243 application to pass rendering instructions or any other data through the 244 matching system. Finally, the list of editing instructions specific to 245 fonts found in the configuration are applied to the pattern. This modified 246 pattern is returned to the application. 247 </P 248 ><P 249 >The return value contains sufficient information to locate and rasterize the 250 font, including the file name, pixel size and other rendering data. As 251 none of the information involved pertains to the FreeType library, 252 applications are free to use any rasterization engine or even to take 253 the identified font file and access it directly. 254 </P 255 ><P 256 >The match/edit sequences in the configuration are performed in two passes 257 because there are essentially two different operations necessary -- the 258 first is to modify how fonts are selected; aliasing families and adding 259 suitable defaults. The second is to modify how the selected fonts are 260 rasterized. Those must apply to the selected font, not the original pattern 261 as false matches will often occur. 262 </P 263 ></DIV 264 ><DIV 265 CLASS="REFSECT2" 266 ><A 267 NAME="AEN36" 268 ></A 269 ><H3 270 >Font Names</H3 271 ><P 272 >Fontconfig provides a textual representation for patterns that the library 273 can both accept and generate. The representation is in three parts, first a 274 list of family names, second a list of point sizes and finally a list of 275 additional properties: 276 </P 277 ><TABLE 278 BORDER="0" 279 BGCOLOR="#E0E0E0" 280 WIDTH="100%" 281 ><TR 282 ><TD 283 ><PRE 284 CLASS="PROGRAMLISTING" 285 ><families>-<point sizes>:<name1>=<values1>:<name2>=<values2>... 286 </PRE 287 ></TD 288 ></TR 289 ></TABLE 290 ><P 291 >Values in a list are separated with commas. The name needn't include either 292 families or point sizes; they can be elided. In addition, there are 293 symbolic constants that simultaneously indicate both a name and a value. 294 Here are some examples: 295 </P 296 ><TABLE 297 BORDER="0" 298 BGCOLOR="#E0E0E0" 299 WIDTH="100%" 300 ><TR 301 ><TD 302 ><PRE 303 CLASS="PROGRAMLISTING" 304 >Name Meaning 305 ---------------------------------------------------------- 306 Times-12 12 point Times Roman 307 Times-12:bold 12 point Times Bold 308 Courier:italic Courier Italic in the default size 309 Monospace:matrix=1 .1 0 1 The users preferred monospace font 310 with artificial obliquing 311 </PRE 312 ></TD 313 ></TR 314 ></TABLE 315 ><P 316 >The '\', '-', ':' and ',' characters in family names must be preceded by a 317 '\' character to avoid having them misinterpreted. Similarly, values 318 containing '\', '=', '_', ':' and ',' must also have them preceded by a 319 '\' character. The '\' characters are stripped out of the family name and 320 values as the font name is read. 321 </P 322 ></DIV 323 ></DIV 324 ><DIV 325 CLASS="REFSECT1" 326 ><A 327 NAME="DEBUG" 328 ></A 329 ><H2 330 >Debugging Applications</H2 331 ><P 332 >To help diagnose font and applications problems, fontconfig is built with a 333 large amount of internal debugging left enabled. It is controlled by means 334 of the FC_DEBUG environment variable. The value of this variable is 335 interpreted as a number, and each bit within that value controls different 336 debugging messages. 337 </P 338 ><TABLE 339 BORDER="0" 340 BGCOLOR="#E0E0E0" 341 WIDTH="100%" 342 ><TR 343 ><TD 344 ><PRE 345 CLASS="PROGRAMLISTING" 346 >Name Value Meaning 347 --------------------------------------------------------- 348 MATCH 1 Brief information about font matching 349 MATCHV 2 Extensive font matching information 350 EDIT 4 Monitor match/test/edit execution 351 FONTSET 8 Track loading of font information at startup 352 CACHE 16 Watch cache files being written 353 CACHEV 32 Extensive cache file writing information 354 PARSE 64 (no longer in use) 355 SCAN 128 Watch font files being scanned to build caches 356 SCANV 256 Verbose font file scanning information 357 MEMORY 512 Monitor fontconfig memory usage 358 CONFIG 1024 Monitor which config files are loaded 359 LANGSET 2048 Dump char sets used to construct lang values 360 MATCH2 4096 Display font-matching transformation in patterns 361 </PRE 362 ></TD 363 ></TR 364 ></TABLE 365 ><P 366 >Add the value of the desired debug levels together and assign that (in 367 base 10) to the FC_DEBUG environment variable before running the 368 application. Output from these statements is sent to stdout. 369 </P 370 ></DIV 371 ><DIV 372 CLASS="REFSECT1" 373 ><A 374 NAME="AEN48" 375 ></A 376 ><H2 377 >Lang Tags</H2 378 ><P 379 >Each font in the database contains a list of languages it supports. This is 380 computed by comparing the Unicode coverage of the font with the orthography 381 of each language. Languages are tagged using an RFC-3066 compatible naming 382 and occur in two parts -- the ISO 639 language tag followed a hyphen and then 383 by the ISO 3166 country code. The hyphen and country code may be elided. 384 </P 385 ><P 386 >Fontconfig has orthographies for several languages built into the library. 387 No provision has been made for adding new ones aside from rebuilding the 388 library. It currently supports 122 of the 139 languages named in ISO 639-1, 389 141 of the languages with two-letter codes from ISO 639-2 and another 30 390 languages with only three-letter codes. Languages with both two and three 391 letter codes are provided with only the two letter code. 392 </P 393 ><P 394 >For languages used in multiple territories with radically different 395 character sets, fontconfig includes per-territory orthographies. This 396 includes Azerbaijani, Kurdish, Pashto, Tigrinya and Chinese. 397 </P 398 ></DIV 399 ><DIV 400 CLASS="REFSECT1" 401 ><A 402 NAME="AEN53" 403 ></A 404 ><H2 405 >Configuration File Format</H2 406 ><P 407 >Configuration files for fontconfig are stored in XML format; this 408 format makes external configuration tools easier to write and ensures that 409 they will generate syntactically correct configuration files. As XML 410 files are plain text, they can also be manipulated by the expert user using 411 a text editor. 412 </P 413 ><P 414 >The fontconfig document type definition resides in the external entity 415 "fonts.dtd"; this is normally stored in the default font configuration 416 directory (/etc/fonts). Each configuration file should contain the 417 following structure: 418 <TABLE 419 BORDER="0" 420 BGCOLOR="#E0E0E0" 421 WIDTH="100%" 422 ><TR 423 ><TD 424 ><PRE 425 CLASS="PROGRAMLISTING" 426 ><?xml version="1.0"?> 427 <!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"> 428 <fontconfig> 429 ... 430 </fontconfig> 431 </PRE 432 ></TD 433 ></TR 434 ></TABLE 435 > 436 </P 437 ><DIV 438 CLASS="REFSECT2" 439 ><A 440 NAME="AEN58" 441 ></A 442 ><H3 443 ><TT 444 CLASS="LITERAL" 445 ><fontconfig></TT 446 ></H3 447 ><P 448 >This is the top level element for a font configuration and can contain 449 <TT 450 CLASS="LITERAL" 451 ><dir></TT 452 >, <TT 453 CLASS="LITERAL" 454 ><cachedir></TT 455 >, <TT 456 CLASS="LITERAL" 457 ><include></TT 458 >, <TT 459 CLASS="LITERAL" 460 ><match></TT 461 > and <TT 462 CLASS="LITERAL" 463 ><alias></TT 464 > elements in any order. 465 </P 466 ></DIV 467 ><DIV 468 CLASS="REFSECT2" 469 ><A 470 NAME="AEN67" 471 ></A 472 ><H3 473 ><TT 474 CLASS="LITERAL" 475 ><dir prefix="default" salt=""></TT 476 ></H3 477 ><P 478 >This element contains a directory name which will be scanned for font files 479 to include in the set of available fonts. 480 </P 481 ><P 482 >If 'prefix' is set to "default" or "cwd", the current working directory will be added as the path prefix prior to the value. If 'prefix' is set to "xdg", the value in the XDG_DATA_HOME environment variable will be added as the path prefix. please see XDG Base Directory Specification for more details. If 'prefix' is set to "relative", the path of current file will be added prior to the value. 483 </P 484 ><P 485 >'salt' property affects to determine cache filename. this is useful for example when having different fonts sets on same path at container and share fonts from host on different font path. 486 </P 487 ></DIV 488 ><DIV 489 CLASS="REFSECT2" 490 ><A 491 NAME="AEN73" 492 ></A 493 ><H3 494 ><TT 495 CLASS="LITERAL" 496 ><cachedir prefix="default"></TT 497 ></H3 498 ><P 499 >This element contains a directory name that is supposed to be stored or read 500 the cache of font information. If multiple elements are specified in 501 the configuration file, the directory that can be accessed first in the list 502 will be used to store the cache files. If it starts with '~', it refers to 503 a directory in the users home directory. If 'prefix' is set to "xdg", the value in the XDG_CACHE_HOME environment variable will be added as the path prefix. please see XDG Base Directory Specification for more details. 504 The default directory is ``$XDG_CACHE_HOME/fontconfig'' and it contains the cache files 505 named ``<TT 506 CLASS="LITERAL" 507 ><hash value></TT 508 >-<TT 509 CLASS="LITERAL" 510 ><architecture></TT 511 >.cache-<TT 512 CLASS="LITERAL" 513 ><version></TT 514 >'', 515 where <TT 516 CLASS="LITERAL" 517 ><version></TT 518 > is the fontconfig cache file 519 version number (currently 8). 520 </P 521 ></DIV 522 ><DIV 523 CLASS="REFSECT2" 524 ><A 525 NAME="AEN81" 526 ></A 527 ><H3 528 ><TT 529 CLASS="LITERAL" 530 ><include ignore_missing="no" prefix="default"></TT 531 ></H3 532 ><P 533 >This element contains the name of an additional configuration file or 534 directory. If a directory, every file within that directory starting with an 535 ASCII digit (U+0030 - U+0039) and ending with the string ``.conf'' will be processed in sorted order. When 536 the XML datatype is traversed by FcConfigParse, the contents of the file(s) 537 will also be incorporated into the configuration by passing the filename(s) to 538 FcConfigLoadAndParse. If 'ignore_missing' is set to "yes" instead of the 539 default "no", a missing file or directory will elicit no warning message from 540 the library. If 'prefix' is set to "xdg", the value in the XDG_CONFIG_HOME environment variable will be added as the path prefix. please see XDG Base Directory Specification for more details. 541 </P 542 ></DIV 543 ><DIV 544 CLASS="REFSECT2" 545 ><A 546 NAME="AEN85" 547 ></A 548 ><H3 549 ><TT 550 CLASS="LITERAL" 551 ><config></TT 552 ></H3 553 ><P 554 >This element provides a place to consolidate additional configuration 555 information. <TT 556 CLASS="LITERAL" 557 ><config></TT 558 > can contain <TT 559 CLASS="LITERAL" 560 ><blank></TT 561 > and <TT 562 CLASS="LITERAL" 563 ><rescan></TT 564 > elements in any 565 order. 566 </P 567 ></DIV 568 ><DIV 569 CLASS="REFSECT2" 570 ><A 571 NAME="AEN92" 572 ></A 573 ><H3 574 ><TT 575 CLASS="LITERAL" 576 ><description domain="fontconfig-conf"></TT 577 ></H3 578 ><P 579 >This element is supposed to hold strings which describe what a config is used for. 580 This string can be translated through gettext. 'domain' needs to be set the proper name to apply then. 581 fontconfig will tries to retrieve translations with 'domain' from gettext. 582 </P 583 ></DIV 584 ><DIV 585 CLASS="REFSECT2" 586 ><A 587 NAME="AEN96" 588 ></A 589 ><H3 590 ><TT 591 CLASS="LITERAL" 592 ><blank></TT 593 ></H3 594 ><P 595 >Fonts often include "broken" glyphs which appear in the encoding but are 596 drawn as blanks on the screen. Within the <TT 597 CLASS="LITERAL" 598 ><blank></TT 599 > element, place each 600 Unicode characters which is supposed to be blank in an <TT 601 CLASS="LITERAL" 602 ><int></TT 603 > element. 604 Characters outside of this set which are drawn as blank will be elided from 605 the set of characters supported by the font. 606 </P 607 ></DIV 608 ><DIV 609 CLASS="REFSECT2" 610 ><A 611 NAME="AEN102" 612 ></A 613 ><H3 614 ><TT 615 CLASS="LITERAL" 616 ><remap-dir prefix="default" as-path="" salt=""></TT 617 ></H3 618 ><P 619 >This element contains a directory name where will be mapped 620 as the path 'as-path' in cached information. 621 This is useful if the directory name is an alias 622 (via a bind mount or symlink) to another directory in the system for 623 which cached font information is likely to exist. 624 </P 625 ><P 626 >'salt' property affects to determine cache filename as same as <TT 627 CLASS="LITERAL" 628 ><dir></TT 629 > element. 630 </P 631 ></DIV 632 ><DIV 633 CLASS="REFSECT2" 634 ><A 635 NAME="AEN108" 636 ></A 637 ><H3 638 ><TT 639 CLASS="LITERAL" 640 ><reset-dirs /></TT 641 ></H3 642 ><P 643 >This element removes all of fonts directories where added by <TT 644 CLASS="LITERAL" 645 ><dir></TT 646 > elements. 647 This is useful to override fonts directories from system to own fonts directories only. 648 </P 649 ></DIV 650 ><DIV 651 CLASS="REFSECT2" 652 ><A 653 NAME="AEN113" 654 ></A 655 ><H3 656 ><TT 657 CLASS="LITERAL" 658 ><rescan></TT 659 ></H3 660 ><P 661 >The <TT 662 CLASS="LITERAL" 663 ><rescan></TT 664 > element holds an <TT 665 CLASS="LITERAL" 666 ><int></TT 667 > element which indicates the default 668 interval between automatic checks for font configuration changes. 669 Fontconfig will validate all of the configuration files and directories and 670 automatically rebuild the internal datastructures when this interval passes. 671 </P 672 ></DIV 673 ><DIV 674 CLASS="REFSECT2" 675 ><A 676 NAME="AEN119" 677 ></A 678 ><H3 679 ><TT 680 CLASS="LITERAL" 681 ><selectfont></TT 682 ></H3 683 ><P 684 >This element is used to black/white list fonts from being listed or matched 685 against. It holds acceptfont and rejectfont elements. 686 </P 687 ></DIV 688 ><DIV 689 CLASS="REFSECT2" 690 ><A 691 NAME="AEN123" 692 ></A 693 ><H3 694 ><TT 695 CLASS="LITERAL" 696 ><acceptfont></TT 697 ></H3 698 ><P 699 >Fonts matched by an acceptfont element are "whitelisted"; such fonts are 700 explicitly included in the set of fonts used to resolve list and match 701 requests; including them in this list protects them from being "blacklisted" 702 by a rejectfont element. Acceptfont elements include glob and pattern 703 elements which are used to match fonts. 704 </P 705 ></DIV 706 ><DIV 707 CLASS="REFSECT2" 708 ><A 709 NAME="AEN127" 710 ></A 711 ><H3 712 ><TT 713 CLASS="LITERAL" 714 ><rejectfont></TT 715 ></H3 716 ><P 717 >Fonts matched by an rejectfont element are "blacklisted"; such fonts are 718 excluded from the set of fonts used to resolve list and match requests as if 719 they didn't exist in the system. Rejectfont elements include glob and 720 pattern elements which are used to match fonts. 721 </P 722 ></DIV 723 ><DIV 724 CLASS="REFSECT2" 725 ><A 726 NAME="AEN131" 727 ></A 728 ><H3 729 ><TT 730 CLASS="LITERAL" 731 ><glob></TT 732 ></H3 733 ><P 734 >Glob elements hold shell-style filename matching patterns (including ? and 735 *) which match fonts based on their complete pathnames. If it starts with '~', 736 it refers to a directory in the users home directory. This can be used to 737 exclude a set of directories (/usr/share/fonts/uglyfont*), or particular 738 font file types (*.pcf.gz), but the latter mechanism relies rather heavily 739 on filenaming conventions which can't be relied upon. Note that globs 740 only apply to directories, not to individual fonts. 741 </P 742 ></DIV 743 ><DIV 744 CLASS="REFSECT2" 745 ><A 746 NAME="AEN135" 747 ></A 748 ><H3 749 ><TT 750 CLASS="LITERAL" 751 ><pattern></TT 752 ></H3 753 ><P 754 >Pattern elements perform list-style matching on incoming fonts; that is, 755 they hold a list of elements and associated values. If all of those 756 elements have a matching value, then the pattern matches the font. This can 757 be used to select fonts based on attributes of the font (scalable, bold, 758 etc), which is a more reliable mechanism than using file extensions. 759 Pattern elements include patelt elements. 760 </P 761 ></DIV 762 ><DIV 763 CLASS="REFSECT2" 764 ><A 765 NAME="AEN139" 766 ></A 767 ><H3 768 ><TT 769 CLASS="LITERAL" 770 ><patelt name="property"></TT 771 ></H3 772 ><P 773 >Patelt elements hold a single pattern element and list of values. They must 774 have a 'name' attribute which indicates the pattern element name. Patelt 775 elements include int, double, string, matrix, bool, charset and const 776 elements. 777 </P 778 ></DIV 779 ><DIV 780 CLASS="REFSECT2" 781 ><A 782 NAME="AEN143" 783 ></A 784 ><H3 785 ><TT 786 CLASS="LITERAL" 787 ><match target="pattern"></TT 788 ></H3 789 ><P 790 >This element holds first a (possibly empty) list of <TT 791 CLASS="LITERAL" 792 ><test></TT 793 > elements and then 794 a (possibly empty) list of <TT 795 CLASS="LITERAL" 796 ><edit></TT 797 > elements. Patterns which match all of the 798 tests are subjected to all the edits. If 'target' is set to "font" instead 799 of the default "pattern", then this element applies to the font name 800 resulting from a match rather than a font pattern to be matched. If 'target' 801 is set to "scan", then this element applies when the font is scanned to 802 build the fontconfig database. 803 </P 804 ></DIV 805 ><DIV 806 CLASS="REFSECT2" 807 ><A 808 NAME="AEN149" 809 ></A 810 ><H3 811 ><TT 812 CLASS="LITERAL" 813 ><test qual="any" name="property" target="default" compare="eq"></TT 814 ></H3 815 ><P 816 >This element contains a single value which is compared with the target 817 ('pattern', 'font', 'scan' or 'default') property "property" (substitute any of the property names seen 818 above). 'compare' can be one of "eq", "not_eq", "less", "less_eq", "more", "more_eq", "contains" or 819 "not_contains". 'qual' may either be the default, "any", in which case the match 820 succeeds if any value associated with the property matches the test value, or 821 "all", in which case all of the values associated with the property must 822 match the test value. 'ignore-blanks' takes a boolean value. if 'ignore-blanks' is set "true", any blanks in the string will be ignored on its comparison. this takes effects only when compare="eq" or compare="not_eq". 823 When used in a <match target="font"> element, 824 the target= attribute in the <test> element selects between matching 825 the original pattern or the font. "default" selects whichever target the 826 outer <match> element has selected. 827 </P 828 ></DIV 829 ><DIV 830 CLASS="REFSECT2" 831 ><A 832 NAME="AEN153" 833 ></A 834 ><H3 835 ><TT 836 CLASS="LITERAL" 837 ><edit name="property" mode="assign" binding="weak"></TT 838 ></H3 839 ><P 840 >This element contains a list of expression elements (any of the value or 841 operator elements). The expression elements are evaluated at run-time and 842 modify the property "property". The modification depends on whether 843 "property" was matched by one of the associated <TT 844 CLASS="LITERAL" 845 ><test></TT 846 > elements, if so, the 847 modification may affect the first matched value. Any values inserted into 848 the property are given the indicated binding ("strong", "weak" or "same") 849 with "same" binding using the value from the matched pattern element. 850 'mode' is one of: 851 <TABLE 852 BORDER="0" 853 BGCOLOR="#E0E0E0" 854 WIDTH="100%" 855 ><TR 856 ><TD 857 ><PRE 858 CLASS="PROGRAMLISTING" 859 >Mode With Match Without Match 860 --------------------------------------------------------------------- 861 "assign" Replace matching value Replace all values 862 "assign_replace" Replace all values Replace all values 863 "prepend" Insert before matching Insert at head of list 864 "prepend_first" Insert at head of list Insert at head of list 865 "append" Append after matching Append at end of list 866 "append_last" Append at end of list Append at end of list 867 "delete" Delete matching value Delete all values 868 "delete_all" Delete all values Delete all values 869 </PRE 870 ></TD 871 ></TR 872 ></TABLE 873 > 874 </P 875 ></DIV 876 ><DIV 877 CLASS="REFSECT2" 878 ><A 879 NAME="AEN159" 880 ></A 881 ><H3 882 ><TT 883 CLASS="LITERAL" 884 ><int></TT 885 >, <TT 886 CLASS="LITERAL" 887 ><double></TT 888 >, <TT 889 CLASS="LITERAL" 890 ><string></TT 891 >, <TT 892 CLASS="LITERAL" 893 ><bool></TT 894 ></H3 895 ><P 896 >These elements hold a single value of the indicated type. <TT 897 CLASS="LITERAL" 898 ><bool></TT 899 > 900 elements hold either true or false. An important limitation exists in 901 the parsing of floating point numbers -- fontconfig requires that 902 the mantissa start with a digit, not a decimal point, so insert a leading 903 zero for purely fractional values (e.g. use 0.5 instead of .5 and -0.5 904 instead of -.5). 905 </P 906 ></DIV 907 ><DIV 908 CLASS="REFSECT2" 909 ><A 910 NAME="AEN167" 911 ></A 912 ><H3 913 ><TT 914 CLASS="LITERAL" 915 ><matrix></TT 916 ></H3 917 ><P 918 >This element holds four numerical expressions of an affine transformation. 919 At their simplest these will be four <TT 920 CLASS="LITERAL" 921 ><double></TT 922 > elements 923 but they can also be more involved expressions. 924 </P 925 ></DIV 926 ><DIV 927 CLASS="REFSECT2" 928 ><A 929 NAME="AEN172" 930 ></A 931 ><H3 932 ><TT 933 CLASS="LITERAL" 934 ><range></TT 935 ></H3 936 ><P 937 >This element holds the two <TT 938 CLASS="LITERAL" 939 ><int></TT 940 > elements of a range 941 representation. 942 </P 943 ></DIV 944 ><DIV 945 CLASS="REFSECT2" 946 ><A 947 NAME="AEN177" 948 ></A 949 ><H3 950 ><TT 951 CLASS="LITERAL" 952 ><charset></TT 953 ></H3 954 ><P 955 >This element holds at least one <TT 956 CLASS="LITERAL" 957 ><int></TT 958 > element of 959 an Unicode code point or more. 960 </P 961 ></DIV 962 ><DIV 963 CLASS="REFSECT2" 964 ><A 965 NAME="AEN182" 966 ></A 967 ><H3 968 ><TT 969 CLASS="LITERAL" 970 ><langset></TT 971 ></H3 972 ><P 973 >This element holds at least one <TT 974 CLASS="LITERAL" 975 ><string></TT 976 > element of 977 a RFC-3066-style languages or more. 978 </P 979 ></DIV 980 ><DIV 981 CLASS="REFSECT2" 982 ><A 983 NAME="AEN187" 984 ></A 985 ><H3 986 ><TT 987 CLASS="LITERAL" 988 ><name></TT 989 ></H3 990 ><P 991 >Holds a property name. Evaluates to the first value from the property of 992 the pattern. If the 'target' attribute is not present, it will default to 993 'default', in which case the property is returned from the font pattern 994 during a target="font" match, and to the pattern during a target="pattern" 995 match. The attribute can also take the values 'font' or 'pattern' to 996 explicitly choose which pattern to use. It is an error to use a target 997 of 'font' in a match that has target="pattern". 998 </P 999 ></DIV 1000 ><DIV 1001 CLASS="REFSECT2" 1002 ><A 1003 NAME="AEN191" 1004 ></A 1005 ><H3 1006 ><TT 1007 CLASS="LITERAL" 1008 ><const></TT 1009 ></H3 1010 ><P 1011 >Holds the name of a constant; these are always integers and serve as 1012 symbolic names for common font values: 1013 <TABLE 1014 BORDER="0" 1015 BGCOLOR="#E0E0E0" 1016 WIDTH="100%" 1017 ><TR 1018 ><TD 1019 ><PRE 1020 CLASS="PROGRAMLISTING" 1021 >Constant Property Value 1022 ------------------------------------- 1023 thin weight 0 1024 extralight weight 40 1025 ultralight weight 40 1026 light weight 50 1027 demilight weight 55 1028 semilight weight 55 1029 book weight 75 1030 regular weight 80 1031 normal weight 80 1032 medium weight 100 1033 demibold weight 180 1034 semibold weight 180 1035 bold weight 200 1036 extrabold weight 205 1037 ultrabold weight 205 1038 black weight 210 1039 heavy weight 210 1040 extrablack weight 215 1041 ultrablack weight 215 1042 roman slant 0 1043 italic slant 100 1044 oblique slant 110 1045 ultracondensed width 50 1046 extracondensed width 63 1047 condensed width 75 1048 semicondensed width 87 1049 normal width 100 1050 semiexpanded width 113 1051 expanded width 125 1052 extraexpanded width 150 1053 ultraexpanded width 200 1054 proportional spacing 0 1055 dual spacing 90 1056 mono spacing 100 1057 charcell spacing 110 1058 unknown rgba 0 1059 rgb rgba 1 1060 bgr rgba 2 1061 vrgb rgba 3 1062 vbgr rgba 4 1063 none rgba 5 1064 lcdnone lcdfilter 0 1065 lcddefault lcdfilter 1 1066 lcdlight lcdfilter 2 1067 lcdlegacy lcdfilter 3 1068 hintnone hintstyle 0 1069 hintslight hintstyle 1 1070 hintmedium hintstyle 2 1071 hintfull hintstyle 3 1072 </PRE 1073 ></TD 1074 ></TR 1075 ></TABLE 1076 > 1077 </P 1078 ></DIV 1079 ><DIV 1080 CLASS="REFSECT2" 1081 ><A 1082 NAME="AEN196" 1083 ></A 1084 ><H3 1085 ><TT 1086 CLASS="LITERAL" 1087 ><or></TT 1088 >, <TT 1089 CLASS="LITERAL" 1090 ><and></TT 1091 >, <TT 1092 CLASS="LITERAL" 1093 ><plus></TT 1094 >, <TT 1095 CLASS="LITERAL" 1096 ><minus></TT 1097 >, <TT 1098 CLASS="LITERAL" 1099 ><times></TT 1100 >, <TT 1101 CLASS="LITERAL" 1102 ><divide></TT 1103 ></H3 1104 ><P 1105 >These elements perform the specified operation on a list of expression 1106 elements. <TT 1107 CLASS="LITERAL" 1108 ><or></TT 1109 > and <TT 1110 CLASS="LITERAL" 1111 ><and></TT 1112 > are boolean, not bitwise. 1113 </P 1114 ></DIV 1115 ><DIV 1116 CLASS="REFSECT2" 1117 ><A 1118 NAME="AEN207" 1119 ></A 1120 ><H3 1121 ><TT 1122 CLASS="LITERAL" 1123 ><eq></TT 1124 >, <TT 1125 CLASS="LITERAL" 1126 ><not_eq></TT 1127 >, <TT 1128 CLASS="LITERAL" 1129 ><less></TT 1130 >, <TT 1131 CLASS="LITERAL" 1132 ><less_eq></TT 1133 >, <TT 1134 CLASS="LITERAL" 1135 ><more></TT 1136 >, <TT 1137 CLASS="LITERAL" 1138 ><more_eq></TT 1139 >, <TT 1140 CLASS="LITERAL" 1141 ><contains></TT 1142 >, <TT 1143 CLASS="LITERAL" 1144 ><not_contains</TT 1145 ></H3 1146 ><P 1147 >These elements compare two values, producing a boolean result. 1148 </P 1149 ></DIV 1150 ><DIV 1151 CLASS="REFSECT2" 1152 ><A 1153 NAME="AEN218" 1154 ></A 1155 ><H3 1156 ><TT 1157 CLASS="LITERAL" 1158 ><not></TT 1159 ></H3 1160 ><P 1161 >Inverts the boolean sense of its one expression element 1162 </P 1163 ></DIV 1164 ><DIV 1165 CLASS="REFSECT2" 1166 ><A 1167 NAME="AEN222" 1168 ></A 1169 ><H3 1170 ><TT 1171 CLASS="LITERAL" 1172 ><if></TT 1173 ></H3 1174 ><P 1175 >This element takes three expression elements; if the value of the first is 1176 true, it produces the value of the second, otherwise it produces the value 1177 of the third. 1178 </P 1179 ></DIV 1180 ><DIV 1181 CLASS="REFSECT2" 1182 ><A 1183 NAME="AEN226" 1184 ></A 1185 ><H3 1186 ><TT 1187 CLASS="LITERAL" 1188 ><alias></TT 1189 ></H3 1190 ><P 1191 >Alias elements provide a shorthand notation for the set of common match 1192 operations needed to substitute one font family for another. They contain a 1193 <TT 1194 CLASS="LITERAL" 1195 ><family></TT 1196 > element followed by optional <TT 1197 CLASS="LITERAL" 1198 ><prefer></TT 1199 >, <TT 1200 CLASS="LITERAL" 1201 ><accept></TT 1202 > and <TT 1203 CLASS="LITERAL" 1204 ><default></TT 1205 > 1206 elements. Fonts matching the <TT 1207 CLASS="LITERAL" 1208 ><family></TT 1209 > element are edited to prepend the 1210 list of <TT 1211 CLASS="LITERAL" 1212 ><prefer></TT 1213 >ed families before the matching <TT 1214 CLASS="LITERAL" 1215 ><family></TT 1216 >, append the 1217 <TT 1218 CLASS="LITERAL" 1219 ><accept></TT 1220 >able families after the matching <TT 1221 CLASS="LITERAL" 1222 ><family></TT 1223 > and append the <TT 1224 CLASS="LITERAL" 1225 ><default></TT 1226 > 1227 families to the end of the family list. 1228 </P 1229 ></DIV 1230 ><DIV 1231 CLASS="REFSECT2" 1232 ><A 1233 NAME="AEN240" 1234 ></A 1235 ><H3 1236 ><TT 1237 CLASS="LITERAL" 1238 ><family></TT 1239 ></H3 1240 ><P 1241 >Holds a single font family name 1242 </P 1243 ></DIV 1244 ><DIV 1245 CLASS="REFSECT2" 1246 ><A 1247 NAME="AEN244" 1248 ></A 1249 ><H3 1250 ><TT 1251 CLASS="LITERAL" 1252 ><prefer></TT 1253 >, <TT 1254 CLASS="LITERAL" 1255 ><accept></TT 1256 >, <TT 1257 CLASS="LITERAL" 1258 ><default></TT 1259 ></H3 1260 ><P 1261 >These hold a list of <TT 1262 CLASS="LITERAL" 1263 ><family></TT 1264 > elements to be used by the <TT 1265 CLASS="LITERAL" 1266 ><alias></TT 1267 > element. 1268 </P 1269 ></DIV 1270 ></DIV 1271 ><DIV 1272 CLASS="REFSECT1" 1273 ><A 1274 NAME="AEN252" 1275 ></A 1276 ><H2 1277 >EXAMPLE CONFIGURATION FILE</H2 1278 ><DIV 1279 CLASS="REFSECT2" 1280 ><A 1281 NAME="AEN254" 1282 ></A 1283 ><H3 1284 >System configuration file</H3 1285 ><P 1286 >This is an example of a system-wide configuration file 1287 </P 1288 ><TABLE 1289 BORDER="0" 1290 BGCOLOR="#E0E0E0" 1291 WIDTH="100%" 1292 ><TR 1293 ><TD 1294 ><PRE 1295 CLASS="PROGRAMLISTING" 1296 ><?xml version="1.0"?> 1297 <!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"> 1298 <!-- /etc/fonts/fonts.conf file to configure system font access --> 1299 <fontconfig> 1300 <!-- 1301 Find fonts in these directories 1302 --> 1303 <dir>/usr/share/fonts</dir> 1304 <dir>/usr/X11R6/lib/X11/fonts</dir> 1305 1306 <!-- 1307 Accept deprecated 'mono' alias, replacing it with 'monospace' 1308 --> 1309 <match target="pattern"> 1310 <test qual="any" name="family"> 1311 <string>mono</string> 1312 </test> 1313 <edit name="family" mode="assign"> 1314 <string>monospace</string> 1315 </edit> 1316 </match> 1317 1318 <!-- 1319 Names not including any well known alias are given 'sans-serif' 1320 --> 1321 <match target="pattern"> 1322 <test qual="all" name="family" compare="not_eq"> 1323 <string>sans-serif</string> 1324 </test> 1325 <test qual="all" name="family" compare="not_eq"> 1326 <string>serif</string> 1327 </test> 1328 <test qual="all" name="family" compare="not_eq"> 1329 <string>monospace</string> 1330 </test> 1331 <edit name="family" mode="append_last"> 1332 <string>sans-serif</string> 1333 </edit> 1334 </match> 1335 1336 <!-- 1337 Load per-user customization file, but don't complain 1338 if it doesn't exist 1339 --> 1340 <include ignore_missing="yes" prefix="xdg"> 1341 fontconfig/fonts.conf 1342 </include> 1343 1344 <!-- 1345 Load local customization files, but don't complain 1346 if there aren't any 1347 --> 1348 <include ignore_missing="yes">conf.d</include> 1349 <include ignore_missing="yes">local.conf</include> 1350 1351 <!-- 1352 Alias well known font names to available TrueType fonts. 1353 These substitute TrueType faces for similar Type1 1354 faces to improve screen appearance. 1355 --> 1356 <alias> 1357 <family>Times</family> 1358 <prefer> 1359 <family>Times New Roman</family> 1360 </prefer> 1361 <default> 1362 <family>serif</family> 1363 </default> 1364 </alias> 1365 <alias> 1366 <family>Helvetica</family> 1367 <prefer> 1368 <family>Arial</family> 1369 </prefer> 1370 <default> 1371 <family>sans</family> 1372 </default> 1373 </alias> 1374 <alias> 1375 <family>Courier</family> 1376 <prefer> 1377 <family>Courier New</family> 1378 </prefer> 1379 <default> 1380 <family>monospace</family> 1381 </default> 1382 </alias> 1383 1384 <!-- 1385 Provide required aliases for standard names 1386 Do these after the users configuration file so that 1387 any aliases there are used preferentially 1388 --> 1389 <alias> 1390 <family>serif</family> 1391 <prefer> 1392 <family>Times New Roman</family> 1393 </prefer> 1394 </alias> 1395 <alias> 1396 <family>sans</family> 1397 <prefer> 1398 <family>Arial</family> 1399 </prefer> 1400 </alias> 1401 <alias> 1402 <family>monospace</family> 1403 <prefer> 1404 <family>Andale Mono</family> 1405 </prefer> 1406 </alias> 1407 1408 <-- 1409 The example of the requirements of OR operator; 1410 If the 'family' contains 'Courier New' OR 'Courier' 1411 add 'monospace' as the alternative 1412 --> 1413 <match target="pattern"> 1414 <test name="family" compare="eq"> 1415 <string>Courier New</string> 1416 </test> 1417 <edit name="family" mode="prepend"> 1418 <string>monospace</string> 1419 </edit> 1420 </match> 1421 <match target="pattern"> 1422 <test name="family" compare="eq"> 1423 <string>Courier</string> 1424 </test> 1425 <edit name="family" mode="prepend"> 1426 <string>monospace</string> 1427 </edit> 1428 </match> 1429 1430 </fontconfig> 1431 </PRE 1432 ></TD 1433 ></TR 1434 ></TABLE 1435 ></DIV 1436 ><DIV 1437 CLASS="REFSECT2" 1438 ><A 1439 NAME="AEN258" 1440 ></A 1441 ><H3 1442 >User configuration file</H3 1443 ><P 1444 >This is an example of a per-user configuration file that lives in 1445 $XDG_CONFIG_HOME/fontconfig/fonts.conf 1446 </P 1447 ><TABLE 1448 BORDER="0" 1449 BGCOLOR="#E0E0E0" 1450 WIDTH="100%" 1451 ><TR 1452 ><TD 1453 ><PRE 1454 CLASS="PROGRAMLISTING" 1455 ><?xml version="1.0"?> 1456 <!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"> 1457 <!-- 1458 $XDG_CONFIG_HOME/fontconfig/fonts.conf for per-user font configuration 1459 --> 1460 <fontconfig> 1461 1462 <!-- 1463 Private font directory 1464 --> 1465 <dir prefix="xdg">fonts</dir> 1466 1467 <!-- 1468 use rgb sub-pixel ordering to improve glyph appearance on 1469 LCD screens. Changes affecting rendering, but not matching 1470 should always use target="font". 1471 --> 1472 <match target="font"> 1473 <edit name="rgba" mode="assign"> 1474 <const>rgb</const> 1475 </edit> 1476 </match> 1477 <!-- 1478 use WenQuanYi Zen Hei font when serif is requested for Chinese 1479 --> 1480 <match> 1481 <!-- 1482 If you don't want to use WenQuanYi Zen Hei font for zh-tw etc, 1483 you can use zh-cn instead of zh. 1484 Please note, even if you set zh-cn, it still matches zh. 1485 if you don't like it, you can use compare="eq" 1486 instead of compare="contains". 1487 --> 1488 <test name="lang" compare="contains"> 1489 <string>zh</string> 1490 </test> 1491 <test name="family"> 1492 <string>serif</string> 1493 </test> 1494 <edit name="family" mode="prepend"> 1495 <string>WenQuanYi Zen Hei</string> 1496 </edit> 1497 </match> 1498 <!-- 1499 use VL Gothic font when sans-serif is requested for Japanese 1500 --> 1501 <match> 1502 <test name="lang" compare="contains"> 1503 <string>ja</string> 1504 </test> 1505 <test name="family"> 1506 <string>sans-serif</string> 1507 </test> 1508 <edit name="family" mode="prepend"> 1509 <string>VL Gothic</string> 1510 </edit> 1511 </match> 1512 </fontconfig> 1513 </PRE 1514 ></TD 1515 ></TR 1516 ></TABLE 1517 ></DIV 1518 ></DIV 1519 ><DIV 1520 CLASS="REFSECT1" 1521 ><A 1522 NAME="AEN262" 1523 ></A 1524 ><H2 1525 >Files</H2 1526 ><P 1527 ><I 1528 CLASS="EMPHASIS" 1529 >fonts.conf</I 1530 > 1531 contains configuration information for the fontconfig library 1532 consisting of directories to look at for font information as well as 1533 instructions on editing program specified font patterns before attempting to 1534 match the available fonts. It is in XML format. 1535 </P 1536 ><P 1537 ><I 1538 CLASS="EMPHASIS" 1539 >conf.d</I 1540 > 1541 is the conventional name for a directory of additional configuration files 1542 managed by external applications or the local administrator. The 1543 filenames starting with decimal digits are sorted in lexicographic order 1544 and used as additional configuration files. All of these files are in XML 1545 format. The master fonts.conf file references this directory in an 1546 <include> directive. 1547 </P 1548 ><P 1549 ><I 1550 CLASS="EMPHASIS" 1551 >fonts.dtd</I 1552 > 1553 is a DTD that describes the format of the configuration files. 1554 </P 1555 ><P 1556 ><I 1557 CLASS="EMPHASIS" 1558 >$XDG_CONFIG_HOME/fontconfig/conf.d</I 1559 > and <I 1560 CLASS="EMPHASIS" 1561 >~/.fonts.conf.d</I 1562 > 1563 is the conventional name for a per-user directory of (typically 1564 auto-generated) configuration files, although the 1565 actual location is specified in the global fonts.conf file. please note that ~/.fonts.conf.d is deprecated now. it will not be read by default in the future version. 1566 </P 1567 ><P 1568 ><I 1569 CLASS="EMPHASIS" 1570 >$XDG_CONFIG_HOME/fontconfig/fonts.conf</I 1571 > and <I 1572 CLASS="EMPHASIS" 1573 >~/.fonts.conf</I 1574 > 1575 is the conventional location for per-user font configuration, although the 1576 actual location is specified in the global fonts.conf file. please note that ~/.fonts.conf is deprecated now. it will not be read by default in the future version. 1577 </P 1578 ><P 1579 ><I 1580 CLASS="EMPHASIS" 1581 >$XDG_CACHE_HOME/fontconfig/*.cache-*</I 1582 > and <I 1583 CLASS="EMPHASIS" 1584 > ~/.fontconfig/*.cache-*</I 1585 > 1586 is the conventional repository of font information that isn't found in the 1587 per-directory caches. This file is automatically maintained by fontconfig. please note that ~/.fontconfig/*.cache-* is deprecated now. it will not be read by default in the future version. 1588 </P 1589 ></DIV 1590 ><DIV 1591 CLASS="REFSECT1" 1592 ><A 1593 NAME="AEN279" 1594 ></A 1595 ><H2 1596 >Environment variables</H2 1597 ><P 1598 ><I 1599 CLASS="EMPHASIS" 1600 >FONTCONFIG_FILE</I 1601 > 1602 is used to override the default configuration file. 1603 </P 1604 ><P 1605 ><I 1606 CLASS="EMPHASIS" 1607 >FONTCONFIG_PATH</I 1608 > 1609 is used to override the default configuration directory. 1610 </P 1611 ><P 1612 ><I 1613 CLASS="EMPHASIS" 1614 >FONTCONFIG_SYSROOT</I 1615 > 1616 is used to set a default sysroot directory. 1617 </P 1618 ><P 1619 ><I 1620 CLASS="EMPHASIS" 1621 >FC_DEBUG</I 1622 > 1623 is used to output the detailed debugging messages. see <A 1624 HREF="#DEBUG" 1625 >Debugging Applications</A 1626 > section for more details. 1627 </P 1628 ><P 1629 ><I 1630 CLASS="EMPHASIS" 1631 >FC_DBG_MATCH_FILTER</I 1632 > 1633 is used to filter out the patterns. this takes a comma-separated list of object names and effects only when FC_DEBUG has MATCH2. see <A 1634 HREF="#DEBUG" 1635 >Debugging Applications</A 1636 > section for more details. 1637 </P 1638 ><P 1639 ><I 1640 CLASS="EMPHASIS" 1641 >FC_LANG</I 1642 > 1643 is used to specify the default language as the weak binding in the query. if this isn't set, the default language will be determined from current locale. 1644 </P 1645 ><P 1646 ><I 1647 CLASS="EMPHASIS" 1648 >FONTCONFIG_USE_MMAP</I 1649 > 1650 is used to control the use of mmap(2) for the cache files if available. this take a boolean value. fontconfig will checks if the cache files are stored on the filesystem that is safe to use mmap(2). explicitly setting this environment variable will causes skipping this check and enforce to use or not use mmap(2) anyway. 1651 </P 1652 ><P 1653 ><I 1654 CLASS="EMPHASIS" 1655 >SOURCE_DATE_EPOCH</I 1656 > 1657 is used to ensure <TT 1658 CLASS="LITERAL" 1659 >fc-cache(1)</TT 1660 > generates files in a deterministic manner in order to support reproducible builds. When set to a numeric representation of UNIX timestamp, fontconfig will prefer this value over using the modification timestamps of the input files in order to identify which cache files require regeneration. If <TT 1661 CLASS="LITERAL" 1662 >SOURCE_DATE_EPOCH</TT 1663 > is not set (or is newer than the mtime of the directory), the existing behaviour is unchanged. 1664 </P 1665 ></DIV 1666 ><DIV 1667 CLASS="REFSECT1" 1668 ><A 1669 NAME="AEN301" 1670 ></A 1671 ><H2 1672 >See Also</H2 1673 ><P 1674 >fc-cat(1), fc-cache(1), fc-list(1), fc-match(1), fc-query(1), <A 1675 HREF="https://reproducible-builds.org/specs/source-date-epoch/" 1676 TARGET="_top" 1677 >SOURCE_DATE_EPOCH</A 1678 >. 1679 </P 1680 ></DIV 1681 ><DIV 1682 CLASS="REFSECT1" 1683 ><A 1684 NAME="AEN305" 1685 ></A 1686 ><H2 1687 >Version</H2 1688 ><P 1689 >Fontconfig version 2.15.0 1690 1691 </P 1692 ></DIV 1693 ></BODY 1694 ></HTML 1695 >
Indexes created Fri Apr 17 00:22:50 UTC 2026