diff options
author | Chun-wei Fan <fanchunwei@src.gnome.org> | 2019-01-08 18:22:33 +0800 |
---|---|---|
committer | Chun-wei Fan <fanchunwei@src.gnome.org> | 2019-04-18 15:10:04 +0800 |
commit | e25c74c015ebb45148d6362e1bd5566207a2e81c (patch) | |
tree | 04ff1afd5b4f6b73b99dcf5acd2b911afdc04fa9 | |
parent | cd4479fb01f0105f496a4eb3484c93d53aa7b22e (diff) | |
download | gtk+-wip/fanc999/fontchooser.win32.gtk3.tar.gz |
MSVC builds: Add instructions on building with Font Tweaking supportwip/fanc999/fontchooser.win32.gtk3
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.
-rw-r--r-- | build/win32/Makefile.am | 1 | ||||
-rw-r--r-- | build/win32/README_FONT_TWEAKING_MSVC.txt | 49 |
2 files changed, 50 insertions, 0 deletions
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 |