Skip to content

Latest commit

 

History

History
56 lines (43 loc) · 1.38 KB

README.md

File metadata and controls

56 lines (43 loc) · 1.38 KB
Raw

C bindings to the Rust's ttf-parser library.

Provides access only to most common methods.

Build

cargo build --release

This will produce a dynamic library that can be located at target/release. Be sure to strip it.

Run tests

cargo build
gcc test.c -g -o test -L./target/debug/ -lttfparser
env LD_LIBRARY_PATH=./target/debug/ ./test

Using cargo-c

This crate can be built and installed using cargo-c.

Build and test

To build and used it uninstalled

cargo cbuild -v --library-type staticlib
export PKG_CONFIG_PATH=<the path cbuild shows at the end>
gcc test.c -g -o test `pkg-config --libs --cflags tffparser`
./test

Install

To install it system-wide

cargo cinstall --destdir /tmp/ttf-parser
sudo cp -a /tmp/ttf-parser/* /

Safety

  • The library doesn't use unsafe (except the bindings itself).
  • All data access is bound checked.
  • No heap allocations, so crash due to OOM is not possible.
  • Technically, should use less than 64KiB of stack in worst case scenario.
  • All methods are thread-safe.
  • All recursive methods have a depth limit.
  • Most of arithmetic operations are checked.
  • Most of numeric casts are checked.
  • Rust panics will be caught at the FFI boundary.

Header generation

The ttfparser.h is generated via cbindgen and then manually edited a bit.