Skip to content

A lightweight TrueType font rendering library

License

Notifications You must be signed in to change notification settings

tomolt/libschrift

Repository files navigation

libschrift

libschrift is a lightweight TrueType font rendering library.

libschrift aims to:

  • Be as simple and easy-to-use as possible. See: https://www.suckless.org/philosophy/
  • Make correct (as in artifact-free, Unicode-aware etc.) font rendering easy to achieve.
  • Be reasonably secure, which especially means to not crash, leak memory / resources or expose major security vulnerabilities on corrupted / malicious / random inputs.

Features

  • Unicode support
  • Very small! (~1500 LoC)
  • No dependencies on anything other than the C standard library (POSIX / WINAPI are only used for memory mapping, which is not essential)
  • Compatible with any C99 compiler
  • Highly portable! Some versions have been tested on Linux, OpenBSD, FreeBSD, Windows, iOS, and macOS!

Limitations

  • Unicode is the only supported text encoding.
  • Support for most TrueType (.ttf) and certain OpenType (.otf) fonts. No bitmap or PostScript fonts.
  • No hinting. Especially no auto-hinting as found in FreeType2.
  • No color emojis.

Building

On Unix-like systems including Mac OS, you can use make && make install to install libschrift as a system-wide library. Since it is statically linked, you only need the library files for development. Users of your projects do not need to install libschrift.

On Windows, you can either use the provided MSVC project, or compile with make via MSYS, or simply compile manually.

Alternatively, you can always copy-paste schrift.c and schrift.h into your own projects source folder.

Documentation

For documentation on how to use libschrift in your own projects, refer to the schrift(3) man page, the source code of the bundled demo, as well as the header file schrift.h.

You can view the man page in your browser at http://tomolt.github.io/libschrift/

Progress

In terms of both security and performance, libschrift is already pretty solid. However, it is still missing some important features, like right-to-left text support.

Visual Quality

A screenshot of the demo program: demo screenshot

Contributing

Bug Reports, Suggestions, Questions, Criticism, Pull Requests and Patches are all welcome!

You can also support the project by buying me (Thomas Oltmann) a coffee, if you'd like:

Buy Me A Coffee