1 |
efrain |
1 |
Troubleshooting GNU FreeFont
|
|
|
2 |
|
|
|
3 |
So your text looks lousy, although you installed FreeFont and you seem to be
|
|
|
4 |
using it. What do you do?
|
|
|
5 |
|
|
|
6 |
Before you blame the problem on FreeFont, take the time to double-check that
|
|
|
7 |
the text you are looking at is really rendered with FreeFont.
|
|
|
8 |
|
|
|
9 |
Be aware that not all Unicode characters are supported by FreeFont, and
|
|
|
10 |
even characters supported by one face, such as Serif, might not be
|
|
|
11 |
supported by other faces such as Sans.
|
|
|
12 |
|
|
|
13 |
Also, some systems have settings that strongly affect the rendering
|
|
|
14 |
of fonts. It may be worth tweaking these.
|
|
|
15 |
|
|
|
16 |
glyph substitution
|
|
|
17 |
==================
|
|
|
18 |
|
|
|
19 |
When given the task of displaying characters in text, modern font rendering
|
|
|
20 |
software usually tries to display *something*, even if the font it is
|
|
|
21 |
*supposed* to be using does not contain glyphs for all the characters in the
|
|
|
22 |
text. The software will snoop through all the fonts on the system to find
|
|
|
23 |
one that has a glyph for the one missing in the desired font. So although
|
|
|
24 |
you have specified FreeSans-bold, you may be looking at a letter from quite
|
|
|
25 |
a different font.
|
|
|
26 |
|
|
|
27 |
First double-check that the font in question really contains the character
|
|
|
28 |
in question. If you don't have font development software, this can be
|
|
|
29 |
tricky. In the case of FreeFont, you can check if a given character
|
|
|
30 |
range is supported: <http://www.gnu.org/software/freefont/coverage.html>
|
|
|
31 |
|
|
|
32 |
Next double-check that your application (web browser, text editor, etc)
|
|
|
33 |
has indeed been properly instructed to use the font.
|
|
|
34 |
|
|
|
35 |
Then double-check that the font is really installed in the system.
|
|
|
36 |
(This depends on the operating system, of course.)
|
|
|
37 |
|
|
|
38 |
Linux and Unix
|
|
|
39 |
==============
|
|
|
40 |
|
|
|
41 |
Modern Linux systems use a system called fontconfig, which maintains a font
|
|
|
42 |
cache, for efficiency.
|
|
|
43 |
|
|
|
44 |
The font cache can really complicate font installation and troubleshooting
|
|
|
45 |
however. It can happen that when a font is newly installed, what is
|
|
|
46 |
displayed is coming out of an old cache entry rather than the new font.
|
|
|
47 |
|
|
|
48 |
Just what to do depends on how and where the font was installed.
|
|
|
49 |
|
|
|
50 |
Fonts installed system-wide are usually put in a directory such as
|
|
|
51 |
/usr/share/fonts/
|
|
|
52 |
the font cache for these might be in
|
|
|
53 |
/var/cache/fontconfig/
|
|
|
54 |
Fonts installed just for one user account will typically be in
|
|
|
55 |
~/.fonts/
|
|
|
56 |
and the cache will be
|
|
|
57 |
~/.fontconfig/
|
|
|
58 |
|
|
|
59 |
You can clean your local cache merely by emptying the directory
|
|
|
60 |
~/.fontconfig/
|
|
|
61 |
In any case, to clean the cache, you can use the fontconfig command
|
|
|
62 |
fc-cache -vf
|
|
|
63 |
If run as root, it will clean the system cache, if run as a normal user,
|
|
|
64 |
it cleans only the normal user's cache.
|
|
|
65 |
|
|
|
66 |
The procedure for local fonts is:
|
|
|
67 |
1) shut off any program using the fonts in question
|
|
|
68 |
2) clean the cache
|
|
|
69 |
3) re-start the program
|
|
|
70 |
The procedure for system-wide fonts is:
|
|
|
71 |
1) log out of the X Windows session
|
|
|
72 |
2) in a console, clean the cache
|
|
|
73 |
3) log in to an X Windows session
|
|
|
74 |
|
|
|
75 |
LibreOffice / OpenOffice
|
|
|
76 |
========================
|
|
|
77 |
These products have their own font rendering libraries, which have
|
|
|
78 |
idiosyncratic behavior.
|
|
|
79 |
|
|
|
80 |
It has recently been reported that as of LibreOffice 3.5.1, font features
|
|
|
81 |
are disabled for OpenType fonts. If you use FreeFont with these products,
|
|
|
82 |
you may want to install the TrueType versions of the fonts.
|
|
|
83 |
|
|
|
84 |
Windows
|
|
|
85 |
=======
|
|
|
86 |
|
|
|
87 |
The most common complaint has to do with "blurry text". There are two
|
|
|
88 |
causes.
|
|
|
89 |
|
|
|
90 |
The first is that ClearType smoothing is turned off. The best way to check
|
|
|
91 |
is to use the native Windows Web browser. Do a search for "ClearType Tuner".
|
|
|
92 |
The Microsoft pages install a tuner for ClearType. A security block notice
|
|
|
93 |
will appear at the top of the window--you have to allow the installation.
|
|
|
94 |
Then check the box "Turn on ClearType". The change happens immediately.
|
|
|
95 |
|
|
|
96 |
The secont cause is that the FreeFont version with cubic spline outlines is
|
|
|
97 |
installed. As of the 2012 GNU FreeFont release, the TrueType builds have
|
|
|
98 |
quadratic splines, which work best with Windows' rendering software.
|
|
|
99 |
TTF (TrueType) quadratic splines Windows 7, Vista, Windows XP.
|
|
|
100 |
OTF (OpenType) cubic splines Linux, Mac
|
|
|
101 |
|
|
|
102 |
Note also: Firefox has a setting for ClearType:
|
|
|
103 |
gfx.font_rendering.cleartype_params.rendering_mode
|
|
|
104 |
A value of 2 sets it to old-style GDI rendering, while -1 is the default.
|
|
|
105 |
|
|
|
106 |
reporting problems
|
|
|
107 |
==================
|
|
|
108 |
|
|
|
109 |
If you really think you're seeing a bug in FreeFont, or if you have
|
|
|
110 |
a suggestion, consider opening a problem report at
|
|
|
111 |
https://savannah.gnu.org/bugs/?group=freefont
|
|
|
112 |
It is best that you make a Savannah account and log in with that, so
|
|
|
113 |
you can be e-mailed whenever changes are made to your report.
|
|
|
114 |
|
|
|
115 |
$Id: troubleshooting.txt,v 1.10 2011-07-16 08:38:06 Stevan_White Exp $
|