• Home
Name Date Size #Lines LOC

..--

.ci/03-May-2024-156124

.circleci/03-May-2024-230206

.github/03-May-2024-347279

docs/03-May-2024-6,6746,183

m4/03-May-2024-1,8091,492

perf/03-May-2024-36,30735,207

src/03-May-2024-142,902101,081

subprojects/03-May-2024-136117

test/03-May-2024-27,62321,670

util/03-May-2024-6,0834,565

.clang-formatD03-May-20241 KiB3936

.codecov.ymlD03-May-202499 97

.editorconfigD03-May-2024376 2418

AUTHORSD03-May-2024201 1514

Android.bpD03-May-202411.7 KiB424394

BUILD.mdD03-May-20241.4 KiB3019

CMakeLists.txtD03-May-202427.9 KiB834703

CONFIG.mdD03-May-20247.4 KiB159116

COPYINGD03-May-20241.8 KiB3932

LICENSED03-May-2024203.1 KiB4,7363,352

LICENSE_APACHE2.TXTD03-May-202411.1 KiB203169

LICENSE_FSFAP.TXTD03-May-2024225 54

LICENSE_GPLv2.TXTD03-May-202417.2 KiB12680

LICENSE_GPLv2_WITH_AUTOCONF_EXCEPTION.TXTD03-May-202416.4 KiB308259

LICENSE_GPLv3_WITH_AUTOCONF_EXCEPTION.TXTD03-May-202433.5 KiB664544

LICENSE_HPND_SELL_VARIANT.TXTD03-May-20241 KiB1816

LICENSE_ISC.TXTD03-May-2024683 1210

LICENSE_MIT_MODERN_VARIANT.TXTD03-May-2024914 1615

LICENSE_OFL.TXTD03-May-20244.2 KiB8664

METADATAD03-May-20241.1 KiB3229

MODULE_LICENSE_MITD03-May-20240

Makefile.amD03-May-20242 KiB8360

NEWSD03-May-202497.9 KiB3,0822,396

NOTICED03-May-20241.7 KiB3730

OWNERSD03-May-202455 43

READMED03-May-20244.6 KiB10070

README.androidD03-May-2024717 1815

README.mdD03-May-20244.6 KiB10070

README.mingw.mdD03-May-20242.4 KiB5943

README.python.mdD03-May-2024961 3222

RELEASING.mdD03-May-20241.7 KiB3823

TESTING.mdD03-May-2024744 4832

TEST_MAPPINGD03-May-202467 87

THANKSD03-May-2024129 87

autogen.shD03-May-20241.1 KiB4933

configure.acD03-May-202414.4 KiB487424

generate_notice.pyD03-May-202420 KiB733595

git.mkD03-May-202412.4 KiB402294

harfbuzz.doapD03-May-2024826 2521

meson.buildD03-May-202413.8 KiB429371

meson_options.txtD03-May-20242.1 KiB4340

mingw-configure.shD03-May-2024802 3126

replace-enum-strings.cmakeD03-May-2024352 2117

README

1[![Linux CI Status](https://github.com/harfbuzz/harfbuzz/workflows/linux-ci/badge.svg)](https://github.com/harfbuzz/harfbuzz/workflows/linux-ci/badge.svg)
2[![CircleCI Build Status](https://circleci.com/gh/harfbuzz/harfbuzz/tree/main.svg?style=svg)](https://circleci.com/gh/harfbuzz/harfbuzz/tree/main)
3[![OSS-Fuzz Status](https://oss-fuzz-build-logs.storage.googleapis.com/badges/harfbuzz.svg)](https://oss-fuzz-build-logs.storage.googleapis.com/index.html)
4[![Coverity Scan Build Status](https://scan.coverity.com/projects/15166/badge.svg)](https://scan.coverity.com/projects/harfbuzz)
5[![Codacy Badge](https://app.codacy.com/project/badge/Grade/89c872f5ce1c42af802602bfcd15d90a)](https://www.codacy.com/gh/harfbuzz/harfbuzz/dashboard?utm_source=github.com&utm_medium=referral&utm_content=harfbuzz/harfbuzz&utm_campaign=Badge_Grade)
6[![Codecov Code Coverage](https://codecov.io/gh/harfbuzz/harfbuzz/branch/main/graph/badge.svg)](https://codecov.io/gh/harfbuzz/harfbuzz)
7[![Packaging status](https://repology.org/badge/tiny-repos/harfbuzz.svg)](https://repology.org/project/harfbuzz/versions)
8
9# HarfBuzz
10
11HarfBuzz is a text shaping engine. It primarily supports [OpenType][1], but also
12[Apple Advanced Typography][2]. HarfBuzz is used in Android, Chrome,
13ChromeOS, Firefox, GNOME, GTK+, KDE, LibreOffice, OpenJDK, PlayStation, Qt,
14XeTeX, and other places.
15
16For bug reports, mailing list, and other information please visit:
17
18  http://harfbuzz.org/
19
20For license information, see [COPYING](COPYING).
21
22## Documentation
23
24For user manual as well as API documentation, check: https://harfbuzz.github.io
25
26## Download
27
28For tarball releases of HarfBuzz, look [here][3]. At the same place you
29will also find Win32/Win64 binary bundles that include libharfbuzz DLL,
30hb-view.exe, hb-shape.exe, and all dependencies.
31
32The canonical source tree is available on [github][4].
33
34The API that comes with `hb.h` will not change incompatibly. Other, peripheral,
35headers are more likely to go through minor modifications, but again, we do our
36best to never change API in an incompatible way. We will never break the ABI.
37
38If you are not sure whether Pango or HarfBuzz is right for you, read [Pango vs
39HarfBuzz][5].
40
41## Development
42
43For build information, see [BUILD.md](BUILD.md).
44
45For custom configurations, see [CONFIG.md](CONFIG.md).
46
47For testing and profiling, see [TESTING.md](TESTING.md).
48
49To get a better idea of where HarfBuzz stands in the text rendering stack you
50may want to read [State of Text Rendering][6], though, that document is many
51years old. Here are a few presentation slides about HarfBuzz at the
52Internationalization and Unicode Conference over the years:
53
54*   November 2014, [Unicode, OpenType, and HarfBuzz: Closing the Circle][7],
55*   October 2012, [HarfBuzz, The Free and Open Text Shaping Engine][8],
56*   October 2009, [HarfBuzz: the Free and Open Shaping Engine][9].
57
58Both development and user support discussion around HarfBuzz happens on the
59[github][4].
60
61To report bugs or submit patches please use [github][4] issues and
62pull-requests.
63
64For a comparison of old vs new HarfBuzz memory consumption see [this][10].
65
66<!--See past and upcoming [HarfBuzz Hackfests](https://freedesktop.org/wiki/Software/HarfBuzz/Hackfests/)!-->
67
68## Name
69
70HarfBuzz (حرف‌باز) is my Persian translation of “[OpenType][1]”,
71transliterated using the Latin script. It sports a second meaning, but that
72ain’t translatable.
73
74> Background: Originally there was this font format called TrueType. People and
75> companies started calling their type engines all things ending in Type:
76> FreeType, CoolType, ClearType, etc. And then came OpenType, which is the
77> successor of TrueType. So, for my OpenType implementation, I decided to stick
78> with the concept but use the Persian translation. Which is fitting given that
79> Persian is written in the Arabic script, and OpenType is an extension of
80> TrueType that adds support for complex script rendering, and HarfBuzz is an
81> implementation of OpenType complex text shaping.
82
83<details>
84  <summary>Packaging status of HarfBuzz</summary>
85
86[![Packaging status](https://repology.org/badge/vertical-allrepos/harfbuzz.svg?header=harfbuzz)](https://repology.org/project/harfbuzz/versions)
87
88</details>
89
90[1]: https://docs.microsoft.com/en-us/typography/opentype/spec/
91[2]: https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6AATIntro.html
92[3]: https://github.com/harfbuzz/harfbuzz/releases
93[4]: https://github.com/harfbuzz/harfbuzz
94[5]: http://mces.blogspot.com/2009/11/pango-vs-harfbuzz.html
95[6]: http://behdad.org/text/
96[7]: https://goo.gl/FSIQuC
97[8]: https://goo.gl/2wSRu
98[9]: http://behdad.org/download/Presentations/slippy/harfbuzz_slides.pdf
99[10]: https://goo.gl/woyty
100

README.android

1Harfbuzz
2
3HOW TO UPDATE
4* Check out external/harfbuzz to <checkout_dir>
5  ex: git clone https://android.googlesource.com/platform/external/harfbuzz_ng
6* Locate the commit you'd like to move.
7  ex: for 1.7.4: https://github.com/harfbuzz/harfbuzz/commit/007a2a4317227b8fb4c764c590203c85fc3da5fd
8* In <checkout_dir>, run git merge <commit_sha>
9  i.e. git merge 007a2a4317227b8fb4c764c590203c85fc3da5fd
10* Upload the changes.
11  ex: git push origin HEAD:refs/for/master
12* Gerrit will run the text related tests.
13
14NOTE:
15 Since Chromium updates Harfbuzz more frequently, you can check the following URL for their changes
16 and latest merges.
17 https://chromium.googlesource.com/chromium/src/+log/master/third_party/harfbuzz-ng
18

README.md

1[![Linux CI Status](https://github.com/harfbuzz/harfbuzz/workflows/linux-ci/badge.svg)](https://github.com/harfbuzz/harfbuzz/workflows/linux-ci/badge.svg)
2[![CircleCI Build Status](https://circleci.com/gh/harfbuzz/harfbuzz/tree/main.svg?style=svg)](https://circleci.com/gh/harfbuzz/harfbuzz/tree/main)
3[![OSS-Fuzz Status](https://oss-fuzz-build-logs.storage.googleapis.com/badges/harfbuzz.svg)](https://oss-fuzz-build-logs.storage.googleapis.com/index.html)
4[![Coverity Scan Build Status](https://scan.coverity.com/projects/15166/badge.svg)](https://scan.coverity.com/projects/harfbuzz)
5[![Codacy Badge](https://app.codacy.com/project/badge/Grade/89c872f5ce1c42af802602bfcd15d90a)](https://www.codacy.com/gh/harfbuzz/harfbuzz/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=harfbuzz/harfbuzz&amp;utm_campaign=Badge_Grade)
6[![Codecov Code Coverage](https://codecov.io/gh/harfbuzz/harfbuzz/branch/main/graph/badge.svg)](https://codecov.io/gh/harfbuzz/harfbuzz)
7[![Packaging status](https://repology.org/badge/tiny-repos/harfbuzz.svg)](https://repology.org/project/harfbuzz/versions)
8
9# HarfBuzz
10
11HarfBuzz is a text shaping engine. It primarily supports [OpenType][1], but also
12[Apple Advanced Typography][2]. HarfBuzz is used in Android, Chrome,
13ChromeOS, Firefox, GNOME, GTK+, KDE, LibreOffice, OpenJDK, PlayStation, Qt,
14XeTeX, and other places.
15
16For bug reports, mailing list, and other information please visit:
17
18  http://harfbuzz.org/
19
20For license information, see [COPYING](COPYING).
21
22## Documentation
23
24For user manual as well as API documentation, check: https://harfbuzz.github.io
25
26## Download
27
28For tarball releases of HarfBuzz, look [here][3]. At the same place you
29will also find Win32/Win64 binary bundles that include libharfbuzz DLL,
30hb-view.exe, hb-shape.exe, and all dependencies.
31
32The canonical source tree is available on [github][4].
33
34The API that comes with `hb.h` will not change incompatibly. Other, peripheral,
35headers are more likely to go through minor modifications, but again, we do our
36best to never change API in an incompatible way. We will never break the ABI.
37
38If you are not sure whether Pango or HarfBuzz is right for you, read [Pango vs
39HarfBuzz][5].
40
41## Development
42
43For build information, see [BUILD.md](BUILD.md).
44
45For custom configurations, see [CONFIG.md](CONFIG.md).
46
47For testing and profiling, see [TESTING.md](TESTING.md).
48
49To get a better idea of where HarfBuzz stands in the text rendering stack you
50may want to read [State of Text Rendering][6], though, that document is many
51years old. Here are a few presentation slides about HarfBuzz at the
52Internationalization and Unicode Conference over the years:
53
54*   November 2014, [Unicode, OpenType, and HarfBuzz: Closing the Circle][7],
55*   October 2012, [HarfBuzz, The Free and Open Text Shaping Engine][8],
56*   October 2009, [HarfBuzz: the Free and Open Shaping Engine][9].
57
58Both development and user support discussion around HarfBuzz happens on the
59[github][4].
60
61To report bugs or submit patches please use [github][4] issues and
62pull-requests.
63
64For a comparison of old vs new HarfBuzz memory consumption see [this][10].
65
66<!--See past and upcoming [HarfBuzz Hackfests](https://freedesktop.org/wiki/Software/HarfBuzz/Hackfests/)!-->
67
68## Name
69
70HarfBuzz (حرف‌باز) is my Persian translation of “[OpenType][1]”,
71transliterated using the Latin script. It sports a second meaning, but that
72ain’t translatable.
73
74> Background: Originally there was this font format called TrueType. People and
75> companies started calling their type engines all things ending in Type:
76> FreeType, CoolType, ClearType, etc. And then came OpenType, which is the
77> successor of TrueType. So, for my OpenType implementation, I decided to stick
78> with the concept but use the Persian translation. Which is fitting given that
79> Persian is written in the Arabic script, and OpenType is an extension of
80> TrueType that adds support for complex script rendering, and HarfBuzz is an
81> implementation of OpenType complex text shaping.
82
83<details>
84  <summary>Packaging status of HarfBuzz</summary>
85
86[![Packaging status](https://repology.org/badge/vertical-allrepos/harfbuzz.svg?header=harfbuzz)](https://repology.org/project/harfbuzz/versions)
87
88</details>
89
90[1]: https://docs.microsoft.com/en-us/typography/opentype/spec/
91[2]: https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6AATIntro.html
92[3]: https://github.com/harfbuzz/harfbuzz/releases
93[4]: https://github.com/harfbuzz/harfbuzz
94[5]: http://mces.blogspot.com/2009/11/pango-vs-harfbuzz.html
95[6]: http://behdad.org/text/
96[7]: https://goo.gl/FSIQuC
97[8]: https://goo.gl/2wSRu
98[9]: http://behdad.org/download/Presentations/slippy/harfbuzz_slides.pdf
99[10]: https://goo.gl/woyty
100

README.mingw.md

1For the development of HarfBuzz, the Microsoft shaping technology, Uniscribe,
2as a widely used and tested shaper is used as more-or-less OpenType reference
3implementation and that specially is important where OpenType specification
4is or wasn't that clear. For having access to Uniscribe on Linux/macOS these
5steps are recommended:
6
7You want to follow the 32bit instructions. The 64bit equivalents are included
8for reference.
9
101. Install Wine.
11   - Fedora: `dnf install wine`.
12
132. Install `mingw-w64` compiler.
14   - Fedora, 32bit: `dnf install mingw32-gcc-c++`
15   - Fedora, 64bit: `dnf install mingw64-gcc-c++`
16   - Debian: `apt install g++-mingw-w64`
17   - Mac: `brew install mingw-w64`
18
193. If you have drank the `meson` koolaid, look at `.ci/build-win32.sh` to see how to
20   invoke `meson` now, or just run that script.  Otherwise, here's how to use the
21   old trusty autotools instead:
22
23   a) Install dependencies.
24      - Fedora, 32bit: `dnf install mingw32-glib2 mingw32-cairo mingw32-freetype`
25      - Fedora, 64bit: `dnf install mingw64-glib2 mingw64-cairo mingw64-freetype`
26
27   b) Configure:
28     - `NOCONFIGURE=1 ./autogen.sh && mkdir winbuild && cd winbuild`
29     - 32bit: `../mingw-configure.sh i686`
30     - 64bit: `../mingw-configure.sh x86_64`
31
32   c) Build as usual:
33     - make
34
35   d) Configure your wine to find system mingw libraries. See:
36      https://fedoraproject.org/wiki/MinGW/Configure_wine
37
38Now you can use `hb-shape` by `(cd win32build/util && wine hb-shape.exe)`
39but if you like to shape with the Microsoft Uniscribe:
40
414. Bring a 32bit version of `usp10.dll` for yourself from `C:\Windows\SysWOW64\usp10.dll` of your
42   Windows installation (assuming you have a 64-bit installation, otherwise
43   `C:\Windows\System32\usp10.dll`) that it is not a DirectWrite proxy
44   ([for more info](https://en.wikipedia.org/wiki/Uniscribe)).
45   Rule of thumb, your `usp10.dll` should have a size more than 500kb, otherwise
46   it is designed to work with DirectWrite which Wine can't work with its original one.
47   You want a Uniscribe from Windows 7 or older.
48
49   Put the DLL in the folder you are going to run the next command,
50
515. `WINEDLLOVERRIDES="usp10=n" wine hb-shape.exe fontname.ttf -u 0061,0062,0063 --shaper=uniscribe`
52
53(`0061,0062,0063` means `abc`, use test/shaping/hb-unicode-decode to generate ones you need)
54
55When you have built that, you can test HarfBuzz's native shaper against Uniscribe
56following these instructions:
57
58  https://github.com/harfbuzz/harfbuzz/issues/3671
59

README.python.md

1To enable HarfBuzz bindings for Python among other languages, make sure
2you have latest version of gobject-introspection available.  On Ubuntu,
3you can install that this way:
4
5```bash
6sudo apt-get install libgirepository1.0-dev
7```
8
9And then run `meson setup` and make sure that `Introspection` is reported
10enabled in output.
11
12Compile and install.
13
14Make sure you have the installation lib dir in `LD_LIBRARY_PATH`, as needed
15for the linker to find the library.
16
17Then make sure you also have `GI_TYPELIB_PATH` pointing to the resulting
18`$prefix/lib/girepository-*` directory.
19
20Make sure you have pygobject installed.  Then check that the following
21import works in your Python interpreter:
22
23```python
24from gi.repository import HarfBuzz
25```
26
27If it does, you are ready to call HarfBuzz from Python!  Congratulations.
28See [`src/sample.py`](src/sample.py).
29
30The Python API will change.  Let us know on the mailing list if you are
31using it, and send lots of feedback.
32