[gtk/wip/fanc999/fontchooser.win32.gtk3: 21/21] MSVC builds: Add instructions on building with Font Tweaking support

[Chun-wei Fan <fanchunwei src gnome org>]

commit 46269fd6538255552755c08bf6d71b0bf6db95bc
Author: Chun-wei Fan <fanchunwei src gnome org>
Date:   Tue Jan 8 18:22:33 2019 +0800

    MSVC builds: Add instructions on building with Font Tweaking support
    
    This tells people how the Font Tweaking support that was added for
    GTK+-3.24.x can be enabled with the Visual Studio projects, which is
    otherwise not enabled by default.

 build/win32/Makefile.am                   |  1 +
 build/win32/README_FONT_TWEAKING_MSVC.txt | 49 +++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+)
---
diff --git a/build/win32/Makefile.am b/build/win32/Makefile.am
index 198ff4aff2..1624d4d340 100644
--- a/build/win32/Makefile.am
+++ b/build/win32/Makefile.am
@@ -47,6 +47,7 @@ EXTRA_DIST += \
        pc_base.py                      \
        gtkpc.py                        \
        README_EGL_MSVC.txt             \
+       README_FONT_TWEAKING_MSVC.txt   \
        regenerate-demos-h-win32.batin  \
        $(GENERATED_ITEMS)
 
diff --git a/build/win32/README_FONT_TWEAKING_MSVC.txt b/build/win32/README_FONT_TWEAKING_MSVC.txt
new file mode 100644
index 0000000000..09f108f570
--- /dev/null
+++ b/build/win32/README_FONT_TWEAKING_MSVC.txt
@@ -0,0 +1,49 @@
+Notes on enabling FontTweaking support for Windows/Visual Studio builds
+==========================================================================
+There is now support in the Font Chooser code for Windows in GTK that would
+support tweaking of fonts via setting specific OpenType tags.  This support,
+as it involves more dependencies, is not enabled by default in the Visual
+Studio project files.
+
+You will need the following to enable this support:
+-HarfBuzz 0.9 or later with FreeType support enabled
+-FreeType 2.7.1 or later
+-(Optional) Pango built with PangoFT2 support (this requires FontConfig
+ and therefore libexpat or libxml2 in addition).
+
+Shaping of the tweaking options is currently supported with HarfBuzz/PangoFT2,
+but not the PangoWin32 fonts, where work is in progress to do that via Uniscribe,
+and eventually HarfBuzz, in Pango.
+
+To enable this support in the Visual Studio projects in GTK:
+-Add HAVE_HARFBUZZ (and possibly HAVE_PANGOFT) to the "Preprocessor Definitions"
+ under the "C/C++"->"Preprocessor" section of your desired build configuration
+ in the "gtk-3" project properties.
+
+-Add the following .lib files to the "Additional Dependencies" under the "Linker"->
+ "Input" section in the "gtk-3" project properties:
+ pangoft2-1.0.lib (if PangoFT2 is used via defining HAVE_PANGOFT in the above step)
+ harfbuzz.lib
+ freetype.lib
+
+To build the font_features demo program in gtk3-demo:
+-Run the regenerate-demos-h-win32.bat in this directory as follows (you need to
+ have PERL installed and the PERL interpreter needs to be in your PATH in the
+ cmd shell that you are running this .bat script):
+ "regenerate-demos-h-win32.bat font" (running "regenerate-demos-h-win32.bat" removes
+ the font features demo from the demo listing, which should restore demos.h.win32
+ to be more or less identical to the copy that was shipped with this release tarball).
+
+-Add $(srcroot)\demos\gtk-demo\font_features.c and $(srcroot)\gtk\gtkpangofontutils.c
+ to the "Source Files" of the "gtk3-demo" project.
+
+-Add HAVE_HARFBUZZ (and possibly HAVE_PANGOFT) to the "Preprocessor Definitions"
+ under the "C/C++"->"Preprocessor" section of your desired build configuration
+ in the "gtk3-demo" project properties.
+
+-Add the following .lib files to the "Additional Dependencies" under the "Linker"->
+ "Input" section in the "gtk-3" project properties:
+ pangoft2-1.0.lib (if PangoFT2 is used via defining HAVE_PANGOFT in the above step)
+ pangowin32-1.0.lib
+ harfbuzz.lib
+ freetype.lib
\ No newline at end of file