Move debian-specific conf file examples upstream.
[platform/upstream/fontconfig.git] / debian / fontconfig.templates
1 Template: fontconfig/hinting_type
2 Type: select
3 _Choices: Native, Autohinter, None
4 Default: Native
5 _Description: With what method should fonts be hinted?
6  The FreeType font library can adjust glyph outlines to accomodate the pixel
7  grid for improved legibility.  This process is called "hinting". 
8  FreeType can either use the hints built-in to each font or it can use a
9  format-indepedent Autohinter.  For most font formats, using the
10  format-specific hints generates better results.  However, many
11  freely available TrueType format fonts don't include any hints at all.
12  When loading such a font, unless you specifically ask to use the
13  Autohinter, these fonts will end up unhinted, which will make them appear
14  fuzzy on the screen.
15  .
16  If the TrueType fonts you use most include hints, then the Native hinter
17  gives better results.  However, if the fonts you use most do not include
18  such hints, then the Autohinter will work better.  Yes, FreeType should do
19  this automatically.
20  .
21  You can also select None to disable all hinting and make your screen look
22  like Mac OS X. 
23  .
24
25 Template: fontconfig/subpixel_rendering
26 Type: select
27 _Choices: Automatic, Always, Never
28 Default: Automatic
29 _Description: Should fonts be rendered using sub-pixel elements?
30  With known sub-pixel geometry, LCD screens can synthesize higher resolution
31  in one dimension.  Taking advantage of this when rendering glyphs sharpens
32  the appearance of text on the screen.  This can cause color artifacts,
33  especially when rendering unhinted or autohinted fonts.  
34  .
35  This option selects when sub-pixel rendering should be used.  Automatic
36  enables sub-pixel rendering whenever the X server detects an LCD monitor,
37  which it can generally do when the monitor is built into the computer or
38  connected with a digital (DVI) cable.  Always forces the system to use
39  sub-pixel rendering while Never forces the system to not use sub-pixel
40  rendering.
41
42 Template: fontconfig/enable_bitmaps
43 Type: boolean
44 Default: false
45 _Description: Enable bitmapped fonts by default?
46  By default, only outline fonts are used by applications which support
47  fontconfig.  Outline fonts are fonts which scale well to various sizes. 
48  In contrast, bitmapped fonts are often lower quality. Enabling this option
49  will affect the systemwide default; this and many other fontconfig options
50  may be enabled or disabled on a per-user basis.