Freetype python bindings

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for HinTak from gravatar.com HinTak Avatar for mmmmmm from gravatar.com mmmmmm Avatar for NicolasRougier from gravatar.com NicolasRougier

Unverified details

These details have not been verified by PyPI
Meta
  • License: BSD License
  • Author: Nicolas P. Rougier
  • Tags freetype, font
  • Requires: Python >=3.7
Classifiers

Project description

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.

https://raw.githubusercontent.com/rougier/freetype-py/master/doc/_static/wordle.png

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.

https://raw.githubusercontent.com/rougier/freetype-py/master/doc/_static/S.png https://raw.githubusercontent.com/rougier/freetype-py/master/doc/_static/G.png

Screenshot below comes from the glyph-color.py showing how to draw and combine a glyph outline with the regular glyph.

https://raw.githubusercontent.com/rougier/freetype-py/master/doc/_static/outline.png

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).

https://raw.githubusercontent.com/rougier/freetype-py/master/doc/_static/hello-world.png

The screenshot below comes from the agg-trick.py example showing an implementation of ideas from the Texts Rasterization Exposures by Maxim Shemarev.

https://raw.githubusercontent.com/rougier/freetype-py/master/doc/_static/agg-trick.png

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+.

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for HinTak from gravatar.com HinTak Avatar for mmmmmm from gravatar.com mmmmmm Avatar for NicolasRougier from gravatar.com NicolasRougier

Unverified details

These details have not been verified by PyPI
Meta
  • License: BSD License
  • Author: Nicolas P. Rougier
  • Tags freetype, font
  • Requires: Python >=3.7
Classifiers

Release history Release notifications | RSS feed

This version

2.5.1

2.5.0

2.4.0

2.3.0

2.2.0

2.2.0rc1 pre-release

2.1.0.post1

2.1.0

2.0.0.post6

2.0.0.post5

2.0.0.post4

2.0.0.post3

2.0.0.post2

2.0.0.post1

2.0

1.2.1

1.2

1.1

1.0.2

1.0.1

1.0

0.5.3

0.5.1

0.5.0

0.4.2

0.4.1

0.4

0.3.3

0.3.2

0.3.1

0.3.0

0.2.0

0.1.1

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

freetype-py-2.5.1.zip (851.7 kB view details)

Uploaded Source

Built Distributions

freetype_py-2.5.1-py3-none-win_amd64.whl (814.6 kB view details)

Uploaded Python 3 Windows x86-64

freetype_py-2.5.1-py3-none-musllinux_1_1_x86_64.whl (1.1 MB view details)

Uploaded Python 3 musllinux: musl 1.1+ x86-64

freetype_py-2.5.1-py3-none-musllinux_1_1_aarch64.whl (1.1 MB view details)

Uploaded Python 3 musllinux: musl 1.1+ ARM64

freetype_py-2.5.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.1 MB view details)

Uploaded Python 3 manylinux: glibc 2.17+ ARM64

freetype_py-2.5.1-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (1.0 MB view details)

Uploaded Python 3 manylinux: glibc 2.12+ x86-64 manylinux: glibc 2.5+ x86-64

freetype_py-2.5.1-py3-none-macosx_10_9_universal2.whl (1.7 MB view details)

Uploaded Python 3 macOS 10.9+ universal2 (ARM64, x86-64)

File details

Details for the file freetype-py-2.5.1.zip.

File metadata

  • Download URL: freetype-py-2.5.1.zip
  • Upload date:
  • Size: 851.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.5

File hashes

Hashes for freetype-py-2.5.1.zip
Algorithm Hash digest
SHA256 cfe2686a174d0dd3d71a9d8ee9bf6a2c23f5872385cf8ce9f24af83d076e2fbd
MD5 ac44c802ce82b123721b53104b6a8932
BLAKE2b-256 d09c61ba17f846b922c2d6d101cc886b0e8fb597c109cedfcb39b8c5d2304b54

See more details on using hashes here.

File details

Details for the file freetype_py-2.5.1-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for freetype_py-2.5.1-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 0b7f8e0342779f65ca13ef8bc103938366fecade23e6bb37cb671c2b8ad7f124
MD5 e8f3eb7063960cc92c733dcdf9548337
BLAKE2b-256 936ebd7fbfacca077bc6f34f1a1109800a2c41ab50f4704d3a0507ba41009915

See more details on using hashes here.

File details

Details for the file freetype_py-2.5.1-py3-none-musllinux_1_1_x86_64.whl.

File metadata

File hashes

Hashes for freetype_py-2.5.1-py3-none-musllinux_1_1_x86_64.whl
Algorithm Hash digest
SHA256 3c1aefc4f0d5b7425f014daccc5fdc7c6f914fb7d6a695cc684f1c09cd8c1660
MD5 497df819873fe2b5e8aee8ae1fc731b5
BLAKE2b-256 2a1b161d3a6244b8a820aef188e4397a750d4a8196316809576d015f26594296

See more details on using hashes here.

File details

Details for the file freetype_py-2.5.1-py3-none-musllinux_1_1_aarch64.whl.

File metadata

File hashes

Hashes for freetype_py-2.5.1-py3-none-musllinux_1_1_aarch64.whl
Algorithm Hash digest
SHA256 cd3bfdbb7e1a84818cfbc8025fca3096f4f2afcd5d4641184bf0a3a2e6f97bbf
MD5 f71ba43ed224a105e20212520e504558
BLAKE2b-256 936ffcc1789e42b8c6617c3112196d68e87bfe7d957d80812d3c24d639782dcb

See more details on using hashes here.

File details

Details for the file freetype_py-2.5.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for freetype_py-2.5.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 5d2f6b3d68496797da23204b3b9c4e77e67559c80390fc0dc8b3f454ae1cd819
MD5 a4f4eb173a071d86b4ca2d170bb36fd9
BLAKE2b-256 a293280ad06dc944e40789b0a641492321a2792db82edda485369cbc59d14366

See more details on using hashes here.

File details

Details for the file freetype_py-2.5.1-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl.

File metadata

File hashes

Hashes for freetype_py-2.5.1-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 289b443547e03a4f85302e3ac91376838e0d11636050166662a4f75e3087ed0b
MD5 d33c3ee0b9c9c912eeefbff58e8b554c
BLAKE2b-256 b636853cad240ec63e21a37a512ee19c896b655ce1772d803a3dd80fccfe63fe

See more details on using hashes here.

File details

Details for the file freetype_py-2.5.1-py3-none-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for freetype_py-2.5.1-py3-none-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 d01ded2557694f06aa0413f3400c0c0b2b5ebcaabeef7aaf3d756be44f51e90b
MD5 743796b402fa68bbe1e085e6de45962f
BLAKE2b-256 38a8258dd138ebe60c79cd8cfaa6d021599208a33f0175a5e29b01f60c9ab2c7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page