README

   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 different font backends. There are three basic backends, with
   9 multiple options for rendering with each.
  10
  11  - Client side fonts using the FreeType and fontconfig libraries.
  12    Rendering can be with with Cairo or Xft libraries, or directly
  13    to an in-memory buffer with no additional libraries.
  14
  15  - Native fonts on Microsoft Windows using Uniscribe if available for
  16    complex script handling. Rendering can be done via Cairo or
  17    directly using the native Win32 API.
  18
  19   - Native fonts on MacOS X, rendering via Cairo.
  20
  21 The integration of Pango with Cairo (http://cairographics.org)
  22 provides a complete solution with high quality text handling
  23 and graphics rendering.
  24
  25 Dynamically loaded modules then handle text layout for particular
  26 combinations of script and font backend.
  27
  28 As well as the low level layout rendering routines, Pango includes
  29 PangoLayout, a high level driver for laying out entire blocks of text,
  30 and routines to assist in editing internationalized text.
  31
  32 For more information about Pango, see:
  33
  34  http://www.pango.org/
  35
  36 Dependencies
  37 ============
  38
  39 Pango depends on the GLib library; more information about GLib can
  40 be found at http://www.gtk.org/.
  41
  42 When using client side fonts, the fontconfig library
  43 (http://www.fontconfig.org) to look up fonts. At least version 2.0.9
  44 of the FreeType font handling library (http://www.freetype.org) is
  45 also required.
  46
  47 Cairo support depends on the Cairo library (http://cairographics.org).
  48 The Cairo backend is the preferred backend to use Pango with and is
  49 subject of most of the development in the future.  It has the
  50 advantage that the same code can be used for display and printing.
  51
  52 We suggest using Pango with Cairo as described above, but you can also
  53 do X-specific rendering using the Xft library. The Xft backend uses
  54 version 2 of the Xft library to manage client side fonts. Version 2 of
  55 Xft is available from http://xlibs.freedesktop.org/release/.  You'll
  56 need the libXft package, and possibly the libXrender and renderext
  57 packages as well.  You'll also need fontconfig (see below.)
  58
  59 Installation of Pango on Win32 is possible, but is not documented
  60 here. See http://www.gimp.org/~tml/gimp/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 General 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
  92 Behdad Esfahbod
  93 behdad@gnome.org
  94
  95 26 February 2007