git.wh0rd.org / fontconfig.git / blame
| Commit | Line | Data |
|---|---|---|
| dc2e06ab KP |
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? | |
| dc2e06ab KP |
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 | . | |
| 97bde49a KP |
21 | You can also select None to disable all hinting, causing all text |
| 22 | to look fuzzy on even the sharpest monitors. | |
| dc2e06ab KP |
23 | . |
| 24 | ||
| 25 | Template: fontconfig/subpixel_rendering | |
| 26 | Type: select | |
| 683dc3c4 | 27 | _Choices: Automatic, Always, Never |
| dc2e06ab | 28 | Default: Automatic |
| 683dc3c4 | 29 | _Description: Should fonts be rendered using sub-pixel elements? |
| dc2e06ab KP |
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. | |
| 683dc3c4 | 34 | . |
| dc2e06ab KP |
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 | |
| 683dc3c4 KP |
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 | |
| dc2e06ab KP |
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. |