The tectonic_bridge_harfbuzz crate

This crate is part of the Tectonic project. It exposes the C API of the [Harfbuzz] text shaping library the Rust/Cargo build framework, with no Rust bindings. By default, a static, local version of the Harfbuzz library is built.

• API documentation.
• Main Git repository.

While there are a variety of other Harfbuzz-related crates in the Rust ecosystem, Tectonic has specialized needs (e.g. support for the [graphite2] smart font library). Hence this specialized crate.

If your project depends on this crate, Cargo will export for your build script an environment variable named DEP_HARFBUZZ_INCLUDE, which will be the name of a directory containing the harfbuzz/ header directory.

You will need to ensure that your Rust code actually references this crate in order for the linker to include linked libraries. A use statement will suffice:

```rust

[allow(unused_imports)]

[allow(clippy::singlecomponentpath_imports)]

use tectonicbridgeharfbuzz; ```

Cargo features

This crate provides the following Cargo features:

• external-harfbuzz: instead of building a local copy of Harfbuzz, discover it as an external dependency using pkg-config or vcpkg, as determined by the tectonic_dep_support crate. This requires that all libraries upon which Harfbuzz depends also be found externally, since the external library can't then link against a local vendored version.