Add a section on using antialiased fonts with Gtk/GNOME.

PR:		docs/30316
Submitted by:	Rahul Siddharthan <rsidd@physics.iisc.ernet.in>
This commit is contained in:
Murray Stokely 2001-09-17 03:46:48 +00:00
parent 7408b262df
commit 9d27ce91b6
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=10708

View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml,v 1.57 2001/09/04 23:34:37 chern Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml,v 1.58 2001/09/11 12:11:09 tom Exp $
-->
<chapter id="x11">
@ -755,9 +755,12 @@ match any family == "LuciduxMono" edit family =+ "Lucidux Mono";</programl
can use anti-aliased fonts
(see <xref linkend="x11-wm-kde2-antialias"> on
<application>KDE</application> for
details); there are patches for gtk+ to do the same,
details); there are patches for gtk+ to do the same,
so if compiled against such a patched gtk+, the GNOME environment
and Mozilla can also use anti-aliased fonts.</para>
and Mozilla can also use anti-aliased fonts. In fact, there
is now a library called gdkxft (in the ports) which allows one
to use antialiased fonts without recompiling: see
<xref linkend="x11-wm-gnome-antialias"> for details.</para>
<para>Anti-aliasing is still new to FreeBSD and
<application>XFree86</application>;
@ -1110,6 +1113,58 @@ DisplayManager.requestPort: 0</screen>
explains how to do this for <filename>kdm</filename>, the
display manager of <application>KDE</application>.</para>
</sect3>
<sect3 id="x11-wm-gnome-antialias">
<title>Anti-aliased fonts with GNOME</title>
<para>While anti-aliased fonts made their first appearance on
XFree86 desktops in the KDE environment and are supported
there in the standard installation, it is also possible to
use them with gtk applications such as the GNOME
environment. The most straightforward way is probably by
using the <application>libgdkxft</application> library, in
the <port>x11/gdkxft</port> port. After installing this
port, read carefully the
<filename>/usr/X11R6/share/doc/gdkxft/README</filename> file
carefully.</para>
<para>If you already have a working
<filename>XftConfig</filename> file, all you really need to
do is tell your gtk applications to look for their
font-rendering functions in
<filename>libgdkxft.so</filename> before looking in the
standard place, <filename>libgdk.so</filename>. This is
easily accomplished by setting an environment variable to
point to the right place; with the Bourne shell
(<application>/bin/sh</application>) or similar shells, type
the command (to start <application>The Gimp</application>,
say)</para>
<screen>&prompt.user; <userinput>LD_PRELOAD=/usr/X11R6/lib/libgdkxft.so gimp</userinput></screen>
<para>and with csh and similar shells, type</para>
<screen>
&prompt.user; <userinput>setenv LD_PRELOAD /usr/X11R6/lib/libgdkxft.so</userinput>
&prompt.user; <userinput>gimp</userinput>
</screen>
<para>It is a nuisance to do this all the time, so you can
simply put the commands</para>
<programlisting>
LD_PRELOAD=/usr/X11R6/lib/libgdkxft.so
export LD_PRELOAD
</programlisting>
<para>into your <filename>.xinitrc</filename>,
<filename>.xsession</filename> or in the appropriate
place(s) in
<filename>/usr/X11R6/lib/X11/xdm/Xsession</filename>,
depending on how you normally start X. However, this
short-cut may cause you problems if you want to run linux
gtk binaries.</para>
</sect3>
</sect2>
<sect2 id="x11-wm-kde2">