tectonic/crates/pdf_io
rm-dr eb473ee2fc
Normalize quotes in READMEs
2024-02-13 18:37:04 -08:00
..
pdf_io pdf_io: add some comments about the origin of the new code 2022-10-20 21:05:51 -04:00
src Fixes for Clippy 1.53.0 2021-06-19 10:13:56 -04:00
CHANGELOG.md crates/pdf_io: move the vast majority of xdvipdfmx into here 2021-03-29 23:06:09 -04:00
Cargo.toml pdf_io: fix doc link and update crate-level rustdoc 2021-04-03 17:16:16 -04:00
README.md Normalize quotes in READMEs 2024-02-13 18:37:04 -08:00
build.rs Fix everything for Rust 1.67's Clippy 2023-01-27 20:08:07 -05:00

README.md

The tectonic_pdf_io crate

This crate is part of the Tectonic project. It provides the PDF, XDV, and image I/O capabilities of XeTeXs xdvipdfmx as a crate, currently providing only a C API.

This crate depends on libpng, which it attempts to find externally using pkg-config or vcpkg. It should be possible to create another "bridge" crate so that this external dependency could be avoided, but this hasnt been done yet.

If your project depends on this crate, Cargo will export for your build script an environment variable named DEP_TECTONIC_PDF_IO_INCLUDE_PATH, which will be a semicolon-separated list of directories enabling your code to include the dpx-*.h headers.

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:

#[allow(unused_imports)]
#[allow(clippy::single_component_path_imports)]
use tectonic_pdf_io;

Cargo features

This crate currently provides no Cargo features.