x19.html revision 1.1.1.5
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 >FUNCTIONAL OVERVIEW</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 HREF="t1.html"><LINK 11 REL="PREVIOUS" 12 HREF="t1.html"><LINK 13 REL="NEXT" 14 TITLE="Datatypes" 15 HREF="x31.html"></HEAD 16 ><BODY 17 CLASS="SECT1" 18 BGCOLOR="#FFFFFF" 19 TEXT="#000000" 20 LINK="#0000FF" 21 VLINK="#840084" 22 ALINK="#0000FF" 23 ><DIV 24 CLASS="NAVHEADER" 25 ><TABLE 26 SUMMARY="Header navigation table" 27 WIDTH="100%" 28 BORDER="0" 29 CELLPADDING="0" 30 CELLSPACING="0" 31 ><TR 32 ><TH 33 COLSPAN="3" 34 ALIGN="center" 35 ></TH 36 ></TR 37 ><TR 38 ><TD 39 WIDTH="10%" 40 ALIGN="left" 41 VALIGN="bottom" 42 ><A 43 HREF="t1.html" 44 ACCESSKEY="P" 45 ><<< Previous</A 46 ></TD 47 ><TD 48 WIDTH="80%" 49 ALIGN="center" 50 VALIGN="bottom" 51 ></TD 52 ><TD 53 WIDTH="10%" 54 ALIGN="right" 55 VALIGN="bottom" 56 ><A 57 HREF="x31.html" 58 ACCESSKEY="N" 59 >Next >>></A 60 ></TD 61 ></TR 62 ></TABLE 63 ><HR 64 ALIGN="LEFT" 65 WIDTH="100%"></DIV 66 ><DIV 67 CLASS="SECT1" 68 ><H1 69 CLASS="SECT1" 70 ><A 71 NAME="AEN19" 72 >FUNCTIONAL OVERVIEW</A 73 ></H1 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="SECT2" 81 ><H2 82 CLASS="SECT2" 83 ><A 84 NAME="AEN22" 85 >FONT CONFIGURATION</A 86 ></H2 87 ><P 88 >The configuration module consists of the FcConfig datatype, libexpat and 89 FcConfigParse which walks over an XML tree and amends a configuration with 90 data found within. From an external perspective, configuration of the 91 library consists of generating a valid XML tree and feeding that to 92 FcConfigParse. The only other mechanism provided to applications for 93 changing the running configuration is to add fonts and directories to the 94 list of application-provided font files. 95 </P 96 ><P 97 >The intent is to make font configurations relatively static, and shared by 98 as many applications as possible. It is hoped that this will lead to more 99 stable font selection when passing names from one application to another. 100 XML was chosen as a configuration file format because it provides a format 101 which is easy for external agents to edit while retaining the correct 102 structure and syntax. 103 </P 104 ><P 105 >Font configuration is separate from font matching; applications needing to 106 do their own matching can access the available fonts from the library and 107 perform private matching. The intent is to permit applications to pick and 108 choose appropriate functionality from the library instead of forcing them to 109 choose between this library and a private configuration mechanism. The hope 110 is that this will ensure that configuration of fonts for all applications 111 can be centralized in one place. Centralizing font configuration will 112 simplify and regularize font installation and customization. 113 </P 114 ></DIV 115 ><DIV 116 CLASS="SECT2" 117 ><H2 118 CLASS="SECT2" 119 ><A 120 NAME="AEN27" 121 >FONT PROPERTIES</A 122 ></H2 123 ><P 124 >While font patterns may contain essentially any properties, there are some 125 well known properties with associated types. Fontconfig uses some of these 126 properties for font matching and font completion. Others are provided as a 127 convenience for the application's rendering mechanism. 128 </P 129 ><TABLE 130 BORDER="0" 131 BGCOLOR="#E0E0E0" 132 WIDTH="100%" 133 ><TR 134 ><TD 135 ><PRE 136 CLASS="PROGRAMLISTING" 137 > Property Definitions 138 139 Property C Preprocessor Symbol Type Description 140 ---------------------------------------------------- 141 family FC_FAMILY String Font family names 142 familylang FC_FAMILYLANG String Language corresponding to 143 each family name 144 style FC_STYLE String Font style. Overrides weight 145 and slant 146 stylelang FC_STYLELANG String Language corresponding to 147 each style name 148 fullname FC_FULLNAME String Font face full name where 149 different from family and 150 family + style 151 fullnamelang FC_FULLNAMELANG String Language corresponding to 152 each fullname 153 slant FC_SLANT Int Italic, oblique or roman 154 weight FC_WEIGHT Int Light, medium, demibold, 155 bold or black 156 size FC_SIZE Double Point size 157 width FC_WIDTH Int Condensed, normal or expanded 158 aspect FC_ASPECT Double Stretches glyphs horizontally 159 before hinting 160 pixelsize FC_PIXEL_SIZE Double Pixel size 161 spacing FC_SPACING Int Proportional, dual-width, 162 monospace or charcell 163 foundry FC_FOUNDRY String Font foundry name 164 antialias FC_ANTIALIAS Bool Whether glyphs can be 165 antialiased 166 hinting FC_HINTING Bool Whether the rasterizer should 167 use hinting 168 hintstyle FC_HINT_STYLE Int Automatic hinting style 169 verticallayout FC_VERTICAL_LAYOUT Bool Use vertical layout 170 autohint FC_AUTOHINT Bool Use autohinter instead of 171 normal hinter 172 globaladvance FC_GLOBAL_ADVANCE Bool Use font global advance data (deprecated) 173 file FC_FILE String The filename holding the font 174 index FC_INDEX Int The index of the font within 175 the file 176 ftface FC_FT_FACE FT_Face Use the specified FreeType 177 face object 178 rasterizer FC_RASTERIZER String Which rasterizer is in use (deprecated) 179 outline FC_OUTLINE Bool Whether the glyphs are outlines 180 scalable FC_SCALABLE Bool Whether glyphs can be scaled 181 scale FC_SCALE Double Scale factor for point->pixel 182 conversions 183 dpi FC_DPI Double Target dots per inch 184 rgba FC_RGBA Int unknown, rgb, bgr, vrgb, 185 vbgr, none - subpixel geometry 186 lcdfilter FC_LCD_FILTER Int Type of LCD filter 187 minspace FC_MINSPACE Bool Eliminate leading from line 188 spacing 189 charset FC_CHARSET CharSet Unicode chars encoded by 190 the font 191 lang FC_LANG LangSet Set of RFC-3066-style 192 languages this font supports 193 fontversion FC_FONTVERSION Int Version number of the font 194 capability FC_CAPABILITY String List of layout capabilities in 195 the font 196 embolden FC_EMBOLDEN Bool Rasterizer should 197 synthetically embolden the font 198 fontfeatures FC_FONT_FEATURES String List of extra feature tags in 199 OpenType to be enabled 200 namelang FC_NAMELANG String Language name to be used for the 201 default value of familylang, 202 stylelang and fullnamelang 203 prgname FC_PRGNAME String Name of the running program 204 hash FC_HASH String SHA256 hash value of the font data 205 with "sha256:" prefix. 206 postscriptname FC_POSTSCRIPT_NAME String Font name in PostScript 207 </PRE 208 ></TD 209 ></TR 210 ></TABLE 211 ></DIV 212 ></DIV 213 ><DIV 214 CLASS="NAVFOOTER" 215 ><HR 216 ALIGN="LEFT" 217 WIDTH="100%"><TABLE 218 SUMMARY="Footer navigation table" 219 WIDTH="100%" 220 BORDER="0" 221 CELLPADDING="0" 222 CELLSPACING="0" 223 ><TR 224 ><TD 225 WIDTH="33%" 226 ALIGN="left" 227 VALIGN="top" 228 ><A 229 HREF="t1.html" 230 ACCESSKEY="P" 231 ><<< Previous</A 232 ></TD 233 ><TD 234 WIDTH="34%" 235 ALIGN="center" 236 VALIGN="top" 237 ><A 238 HREF="t1.html" 239 ACCESSKEY="H" 240 >Home</A 241 ></TD 242 ><TD 243 WIDTH="33%" 244 ALIGN="right" 245 VALIGN="top" 246 ><A 247 HREF="x31.html" 248 ACCESSKEY="N" 249 >Next >>></A 250 ></TD 251 ></TR 252 ><TR 253 ><TD 254 WIDTH="33%" 255 ALIGN="left" 256 VALIGN="top" 257 ></TD 258 ><TD 259 WIDTH="34%" 260 ALIGN="center" 261 VALIGN="top" 262 > </TD 263 ><TD 264 WIDTH="33%" 265 ALIGN="right" 266 VALIGN="top" 267 >Datatypes</TD 268 ></TR 269 ></TABLE 270 ></DIV 271 ></BODY 272 ></HTML 273 >
Indexes created Tue Oct 27 00:25:24 UTC 2026