Files
pdfcraft/vendor/hayro-interpret
jonathanwxh-cell 2251a75cc8 fix(render): resolve TrueType glyphs across Unicode/UCS-4 cmaps, post v2.0 aliases, and truncated FontFlags (#2159) (#2980)
* fix(render): resolve accented TrueType glyphs across Symbolic flags, Unicode cmaps, post v2.0, and ToUnicode (#2159, #2426)

* fix(render): separate TrueType glyph selection from extraction (#2980)

Restore the existing Symbolic and CFF mapping paths. Keep name-derived Unicode
cmap lookup, post-name aliases, known flag bits, and explicit .notdef handling.
Replace disputed expectations with synthetic glyph/extraction regressions;
the original PDFs in #2159 and #2426 remain unavailable and unverified.

* fix(render): check exact post v2.0 glyph name before suffix-stripped cmap lookup (#2980)

* fix(render): prefer exact post v2.0 name for multi-codepoint AGL glyph names (#2980)

* style: format vendor true_type.rs

* fix(render): keep TrueType vendor patch in upstream style

Restore unchanged upstream formatting around the glyph-mapping fix and use
upstream-default formatting for its new helpers. Preserve the upstream
glyph_name_to_text extraction fallback and every existing functional change.

Validated workspace cargo fmt, git diff --check, and byte-identical rustfmt
canonical output before and after this formatting-only change. The eight
TrueType integration tests passed on the prior head in hosted CI; fresh CI
will validate this follow-up. Local recompilation and optional negative
controls were not attempted because build storage is exhausted.
2026-11-17 22:47:55 -06:00
..
…
…

hayro-interpret

Crates.io Documentation

A crate for interpreting PDF files.

This crate provides an abstraction to interpret the content of a PDF file and render them into an abstract [Device], which clients can implement as needed. This allows you, for example, to render PDF files to bitmaps (which is what the hayro crate does), or other formats such as SVG.

It should be noted that this crate is still very much in development. Therefore it currently lacks pretty much any documentation on how to use it. It's current API also only really makes it useful for rendering to PNG or SVG, though this will be improved upon in the future.

Examples

See the examples folder on the GitHub repository. Apart from that, you can also consult the implementation of hayro and hayro-svg to get an idea on how to use this crate.

Safety

This crate forbids unsafe code via a crate-level attribute.

Cargo features

This crate has one optional feature:

  • embed-fonts: PDF processors are required to support 14 predefined fonts that do not need to be embedded into a PDF file. If you enable this feature, hayro will embed a (permissively-licensed) substitute for each font, so that you don't have to implement your custom font loading logic. This will add around ~240KB to your binary.

License

Licensed under either of

at your option.

PdfCraft function limits

The PdfCraft patch rejects function construction after 64 nested functions or 10,000 total function nodes, including repeated references, and detects cycles on the current path. Shared children in different branches remain valid. Stitching functions reject empty or unresolved child lists instead of silently truncating them. Calculator functions have a shared limit of 64 procedure levels and 10,000 parsed tokens (operators and procedure openings); evaluation has its own 10,000-operator limit across selected branches. These are implementation resource limits rather than PDF format limits. Rejection returns the existing None, and the optional logging feature reports the reason and limit; no new interface warning is introduced.

Calculator integer division without an integer result is also rejected. Bit shifting discards bits beyond the 32-bit word and fills with zeroes, including logical right shifts of negative words; rotation accepts the full signed shift range without negating the minimum integer. Fixed-size operand and procedure-stack overflow errors propagate instead of truncating work. Normal function signatures and supported color/transfer-function behavior remain unchanged.