FreeType (high-level Python API)
Freetype Python provides bindings for the FreeType library. Only the high-level API is bound.
Documentation available at: http://freetype-py.readthedocs.org/en/latest/
Installation
From PyPI, recommended: pip install freetype-py. This will install the library with a bundled FreeType binary, so you’re ready to go on Windows, macOS and Linux (all with 32 and 64 bit x86 architecture support).
Do note: if you specify the –no-binary paramater to pip, or use a different architecture for which we don’t pre-compile binaries, the package will default to using an external FreeType library. Specify the environment variable FREETYPEPY_BUNDLE_FT=1 before calling pip to compile a binary yourself.
Installation with compiling FreeType from source
If you don’t want to or can’t use the pre-built binaries, build FreeType yourself: export FREETYPEPY_BUNDLE_FT=yesplease && pip install .. This will download and compile FreeType with Harfbuzz support as specified in setup-build-freetype.py. Set the environment variable PYTHON_ARCH to 32 or 64 to explicitly set an architecture, default is whatever your host machine uses. On macOS, we will always build a universal 32 and 64 bit Intel binary.
Windows: You need CMake and a C and C++ compiler, e.g. the Visual Code Community 2017 distribution with the desktop C++ workload.
macOS: You need CMake and the XCode tools (full IDE not necessary)
Linux: You need CMake, gcc and g++. For building a 32 bit library on a 64 bit machine, you need gcc-multilib and g++-multilib (Debian) or glibc-devel.i686 and libstdc++-devel.i686 (Fedora).
Installation with an external FreeType library (the default)
Install just the pure Python library and let it find a system-wide installed FreeType at runtime.
Mac users
Freetype should be already installed on your system. If not, either install it using homebrew or compile it and place the library binary file in ‘/usr/local/lib’.
Linux users
Freetype should be already installed on your system. If not, either install relevant package from your package manager or compile from sources and place the library binary file in ‘/usr/local/lib’.
Window users
There are no official Freetype binary releases available, but they offer some links to precompiled Windows DLLs. Please see the FreeType Downloads page for links. You can also compile the FreeType library from source yourself.
If you are using freetype-py on Windows with a 32-Bit version of Python, you need the 32-Bit version of the Freetype binary. The same applies for a 64-Bit version of Python.
Because of the way Windows searches for dll files, make sure the resulting file is named ‘freetype.dll’ (and not something like Freetype245.dll). Windows expects the library in one of the directories listed in the $PATH environment variable. As it is not recommended to place the dll in a Windows system folder, you can choose one of the following ways to solve this:
Place library in a folder of your choice and edit the $PATH user environment variable
Place library in a folder of your choice and edit the $PATH system environment variable
For development purpose, place the library in the working directory of the application
Place the library in one of the existing directories listed in $PATH
To get a complete list of all the directories in the $PATH environment variable (user and system), open a command promt and type
echo %PATH%Usage example
import freetype
face = freetype.Face("Vera.ttf")
face.set_char_size( 48*64 )
face.load_char('S')
bitmap = face.glyph.bitmap
print(bitmap.buffer)Screenshots
Screenshot below comes from the wordle.py example. No clever tricks here, just brute force.
Screenshots below comes from the glyph-vector.py and glyph-vector-2.py examples showing how to access a glyph outline information and use it to draw the glyph. Rendering (with Bézier curves) is done using matplotlib.
Screenshot below comes from the glyph-color.py showing how to draw and combine a glyph outline with the regular glyph.
The screenshot below comes from the hello-world.py example showing how to draw text in a bitmap (that has been zoomed in to show antialiasing).
The screenshot below comes from the agg-trick.py example showing an implementation of ideas from the Texts Rasterization Exposures by Maxim Shemarev.
Freezing apps
Freetype implements a hook for PyInstaller to help simplify the freezing process (it e.g. ensures that the freetype DLL is included). This hook requires PyInstaller version 4+.
3 maintainers
Metadata
3 maintainers
Release files for freetype-py 2.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| freetype-py-2.5.1.zip | 851.7 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| freetype_py-2.5.1-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| freetype_py-2.5.1-py3-none-musllinux_1_1_x86_64.whl | Python 3 | none | Linux musl 1.1+ x86-64 | Details |
| freetype_py-2.5.1-py3-none-musllinux_1_1_aarch64.whl | Python 3 | none | Linux musl 1.1+ ARM64 | Details |
| freetype_py-2.5.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| freetype_py-2.5.1-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl | Python 3 | none | Linux glibc 2.12+ x86-64, Linux glibc 2.5+ x86-64 | Details |
| freetype_py-2.5.1-py3-none-macosx_10_9_universal2.whl | Python 3 | none | macOS 10.9+ universal2 (ARM64, x86-64) | Details |
Total release size: 7.7 MB
Release files / freetype-py-2.5.1.zip
| Download URL | freetype-py-2.5.1.zip |
|---|---|
| Size | 851.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cfe2686a174d0dd3d71a9d8ee9bf6a2c23f5872385cf8ce9f24af83d076e2fbd
|
|
BLAKE2b-256 checksum How to use checksums |
d09c61ba17f846b922c2d6d101cc886b0e8fb597c109cedfcb39b8c5d2304b54
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.0 CPython/3.12.5
|
Release files / freetype_py-2.5.1-py3-none-win_amd64.whl
| Download URL | freetype_py-2.5.1-py3-none-win_amd64.whl |
|---|---|
| Size | 814.6 kB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0b7f8e0342779f65ca13ef8bc103938366fecade23e6bb37cb671c2b8ad7f124
|
|
BLAKE2b-256 checksum How to use checksums |
936ebd7fbfacca077bc6f34f1a1109800a2c41ab50f4704d3a0507ba41009915
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.0 CPython/3.12.5
|
Release files / freetype_py-2.5.1-py3-none-musllinux_1_1_x86_64.whl
| Download URL | freetype_py-2.5.1-py3-none-musllinux_1_1_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Linux musl 1.1+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
3c1aefc4f0d5b7425f014daccc5fdc7c6f914fb7d6a695cc684f1c09cd8c1660
|
|
BLAKE2b-256 checksum How to use checksums |
2a1b161d3a6244b8a820aef188e4397a750d4a8196316809576d015f26594296
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.0 CPython/3.12.5
|
Release files / freetype_py-2.5.1-py3-none-musllinux_1_1_aarch64.whl
| Download URL | freetype_py-2.5.1-py3-none-musllinux_1_1_aarch64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Linux musl 1.1+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
cd3bfdbb7e1a84818cfbc8025fca3096f4f2afcd5d4641184bf0a3a2e6f97bbf
|
|
BLAKE2b-256 checksum How to use checksums |
936ffcc1789e42b8c6617c3112196d68e87bfe7d957d80812d3c24d639782dcb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.0 CPython/3.12.5
|
Release files / freetype_py-2.5.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | freetype_py-2.5.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
5d2f6b3d68496797da23204b3b9c4e77e67559c80390fc0dc8b3f454ae1cd819
|
|
BLAKE2b-256 checksum How to use checksums |
a293280ad06dc944e40789b0a641492321a2792db82edda485369cbc59d14366
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.0 CPython/3.12.5
|
Release files / freetype_py-2.5.1-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl
| Download URL | freetype_py-2.5.1-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl |
|---|---|
| Size | 1.0 MB |
| Tags | Linux glibc 2.12+ x86-64 Linux glibc 2.5+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
289b443547e03a4f85302e3ac91376838e0d11636050166662a4f75e3087ed0b
|
|
BLAKE2b-256 checksum How to use checksums |
b636853cad240ec63e21a37a512ee19c896b655ce1772d803a3dd80fccfe63fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.0 CPython/3.12.5
|
Release files / freetype_py-2.5.1-py3-none-macosx_10_9_universal2.whl
| Download URL | freetype_py-2.5.1-py3-none-macosx_10_9_universal2.whl |
|---|---|
| Size | 1.7 MB |
| Tags | Python 3 macOS 10.9+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
d01ded2557694f06aa0413f3400c0c0b2b5ebcaabeef7aaf3d756be44f51e90b
|
|
BLAKE2b-256 checksum How to use checksums |
38a8258dd138ebe60c79cd8cfaa6d021599208a33f0175a5e29b01f60c9ab2c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.0 CPython/3.12.5
|
