1 | Pango is a library for layout and rendering of text, with an emphasis |
---|
2 | on internationalization. Pango can be used anywhere that text layout |
---|
3 | is needed; however, most of the work on Pango so far has been done using |
---|
4 | the GTK+ widget toolkit as a test platform. Pango forms the core of text |
---|
5 | and font handling for GTK+-2.x. |
---|
6 | |
---|
7 | Pango is designed to be modular; the core Pango layout can be used |
---|
8 | with three different font backends: |
---|
9 | |
---|
10 | - Client-side fonts on X using the Xft library |
---|
11 | - Direct rendering of scalable fonts using the FreeType library |
---|
12 | - Native fonts on Microsoft backends |
---|
13 | |
---|
14 | (There is also a core-X font backend still present in the code; |
---|
15 | usage of this backend is deprecated) |
---|
16 | |
---|
17 | Dynamically loaded modules then handle text layout for particular |
---|
18 | combinations of script and font backend. |
---|
19 | |
---|
20 | As well as the low level layout rendering routines, Pango includes |
---|
21 | PangoLayout, a high level driver for laying out entire blocks of text, |
---|
22 | and routines to assist in editing internationalized text. |
---|
23 | |
---|
24 | For more information about Pango, see: |
---|
25 | |
---|
26 | http://www.pango.org |
---|
27 | |
---|
28 | Dependencies |
---|
29 | ============ |
---|
30 | |
---|
31 | Pango depends on version 2.4.0 or new of the GLib library; more |
---|
32 | information about GLib can be found at http://www.gtk.org/. |
---|
33 | |
---|
34 | The supported font backend for X in Pango-1.4 is the Xft backend |
---|
35 | which uses version 2 of the Xft library to manage client |
---|
36 | side fonts. Version 2 of Xft is available from http://fontconfig.org/ |
---|
37 | Along with Xft, you'll need to install its dependency fontconfig, and |
---|
38 | possibly also the Xrender library, if that doesn't come with |
---|
39 | your system. Both of these libraries are available from |
---|
40 | the same place as fontconfig. |
---|
41 | |
---|
42 | Note that an earlier version of Xft is shipped with version |
---|
43 | of XFree86 up to 4.2. This version does not work with Pango-1.4; |
---|
44 | Pango-1.4 requires version 2 of Xft, which is present in XFree86-4.3 |
---|
45 | and newer and in X11R6.7 and X11R6.8. |
---|
46 | |
---|
47 | Both Xft and the optional PangoFT2 backend require the fontconfig |
---|
48 | library (http://www.fontconfig.org) to look up fonts. At least version |
---|
49 | 2.0.9 of the FreeType font handling library (http://www.freetype.org) |
---|
50 | is also required. If fontconfig and FreeType are not found at |
---|
51 | configure time, or FreeType is too old, then neither the Xft nor the |
---|
52 | FT2 backend is will be built. |
---|
53 | |
---|
54 | After installing fontconfig, it may be necessary to edit |
---|
55 | the fonts.conf file, found at $(sysconfdir)/fonts/fonts.conf |
---|
56 | (usually /etc/fonts/fonts.conf) to point at the fonts |
---|
57 | on your system. |
---|
58 | |
---|
59 | Installation of Pango on Win32 is possible, but is not documented |
---|
60 | here. See http://www.gimp.org/~tml/win32/downloads.html. |
---|
61 | |
---|
62 | Notes |
---|
63 | ===== |
---|
64 | |
---|
65 | - By default, Pango tries to build itself so that no explicit |
---|
66 | dependency on Xft or FreeType will be introduced in apps that |
---|
67 | link to Pango. This is to avoid compatibility problems with |
---|
68 | changes in the Xft or FreeType API's or ABI's. Specifying |
---|
69 | --enable-explicit-deps or --enable-static when configuring Pango |
---|
70 | will defeat this and should be avoided if possible. |
---|
71 | |
---|
72 | License |
---|
73 | ======= |
---|
74 | |
---|
75 | Most of the code of Pango is licensed under the terms of the |
---|
76 | GNU Lesser Public License (LGPL) - see the file COPYING for details. |
---|
77 | |
---|
78 | The OpenType code in pango/opentype is derived from the FreeType |
---|
79 | project (http://www.freetype.org) and is dual-licensed under the |
---|
80 | GNU Public License and the FreeType license. See see |
---|
81 | pango/opentype/FT-license.txt for full details of the FreeType |
---|
82 | license. |
---|
83 | |
---|
84 | Note that binary distributions of Pango must include a disclaimer |
---|
85 | that the software is based in part of the work of the FreeType Team, |
---|
86 | in the distribution documentation; for instance, by including this |
---|
87 | README file. |
---|
88 | |
---|
89 | Owen Taylor |
---|
90 | otaylor@redhat.com |
---|
91 | 13 September 2004 |
---|