summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChun-wei Fan <fanchunwei@src.gnome.org>2022-06-19 10:55:14 +0800
committerMatthias Clasen <mclasen@redhat.com>2022-07-04 11:17:21 -0400
commitf6ee844a49e2e40ecb12384242fc34bff21bc3db (patch)
tree4c8782025e9606efa8aac96e81ee38fc1cf61b0b
parenta35b2bbe29c477cc53d6ccd3b8b69dcb4b43ffb2 (diff)
downloadpango-f6ee844a49e2e40ecb12384242fc34bff21bc3db.tar.gz
README.win32: Update Windows build information
There is no more FontConfig support for Windows for Pango2, and let people know they need DirectWrite support enabled in HarfBuzz and Cairo, which may not be enabled by default. Also let people know that if building HarfBuzz as a fallback as a part of building Pango2, Visual Studio 2017 or later is required to successfully build HarfBuzz. Note that HarfBuzz DLLs built with Visual Studio 2017 or later should be compatible with Pango built with Visual Studio 2015.
-rw-r--r--README.win3227
1 files changed, 11 insertions, 16 deletions
diff --git a/README.win32 b/README.win32
index 64579859..e4809404 100644
--- a/README.win32
+++ b/README.win32
@@ -1,17 +1,16 @@
The Pango backends written for Win32 is pangowin32. Pangowin32 uses
-the Win32 GDI font API. GTK+ 2.8 and later on Win32 however actually
-uses the pangocairo backend (which then uses only small parts of
-pangowin32). Much of the GDI font API calls are in cairo.
-
-The pangoft2 backend was originally written with Win32 in mind, but
-its main use nowadays is on other platforms than Win32.
+the Win32 DirectWrite font API. GTK+ 2.8 and later on Win32 however
+actually uses the pangocairo backend (which then uses only small parts of
+pangowin32). Much of the DirectWrite font API calls are in cairo.
To build Pango for Win32:
You need to have gcc (mingw-w64) or Visual Studio 2015 or later, along with
-Python 3.6.x+ and Meson 0.55.3 at the time of writing. If building
-the introspection files, you will also need to ensure that the Python
-release series and build architecture (i.e. Win32 (x86)/
+Python 3.6.x+ and Meson 0.55.3 at the time of writing. However, if you do not
+have HarfBuzz installed and are building it as part of building Pango, you will
+need to use Visual Studio 2017 (the latest 15.9.x release is recommended) or
+later. If building the introspection files, you will also need to ensure that
+the Python release series and build architecture (i.e. Win32 (x86)/
x64 (amd64/x86-64) matches the Python release series and build
architecture that was used to build GObject-Introspection.
The Python interpreter executable directory must be in your PATH.
@@ -27,16 +26,12 @@ are currently not supported for any cross-builds.
You will also need the following libraries installed with their headers
and import libraries, and their DLLs, if applicable, needs to be found in
%PATH%. All of their required dependencies are required as well. Their
-pkg-config files are needed on all builds unless marked with a *, where
-only their headers/import libraries are needed on Visual Studio:
+pkg-config files are needed on all builds.
-GLib
-Fribidi
--Cairo* (With Win32 support built in, and optionally FreeType and FontConfig
- support for building PangoFT2.)
--HarfBuzz* (GLib support required, and FreeType2 if building PangoFT2)
--FreeType* (Optional, needed for PangoFT2)
--FontConfig* (Optional, needed for PangoFT2)
+-Cairo (With Win32+DirectWrite support built in, optionally libpng support)
+-HarfBuzz (GLib, GObject and DirectWrite support required)
Please see meson.build to see what versions are needed for these dependencies.