0 Fork 0

mirror of https://github.com/storytold/pdfcraft.git synced 2026-11-06 18:52:36 +00:00

Files

T

KenM76andClaude Opus 5.5 83b230ae73 M12: PRC reader crate: container, bit primitives, schema (#1297 )

New standalone L0 crate pdfcraft-prc: the PRC container walk (file
header, file-structure descriptions, per-section zlib inflation under a
512 MiB ceiling), the bit-level primitives of the compressed sections,
and the schema interpreter a newer producer uses to describe fields it
added (step and nesting ceilings).

The Double prefix-code table is not in this commit: Double reads
return UnknownDoubleCode, and the tests that need the table are
ignored with that reason.

Adapted from pdfcer (MIT, same author), crates/pdfcer-3d at
0c9742b5936232af89cd707138ef149dc1f4a660.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SqmHYx8FiWM5PcsoiErgp9

2026-11-02 12:26:43 -05:00

src

M12: PRC reader crate: container, bit primitives, schema (#1297 )

2026-11-02 12:26:43 -05:00

tests

M12: PRC reader crate: container, bit primitives, schema (#1297 )

2026-11-02 12:26:43 -05:00

Cargo.toml

M12: PRC reader crate: container, bit primitives, schema (#1297 )

2026-11-02 12:26:43 -05:00

README.md

M12: PRC reader crate: container, bit primitives, schema (#1297 )

2026-11-02 12:26:43 -05:00

README.md

pdfcraft-prc

A reader for PRC (ISO 14739-1), the 3D model format a PDF /3D stream of /Subtype /PRC carries (ISO 32000-2 §13.6.3).

Layer: L0, standalone. No dependency on any other PdfCraft crate.
Licence: MIT OR Apache-2.0. Inflation through flate2 with the pure-Rust miniz_oxide backend.
#![forbid(unsafe_code)]. Never panics on input: every read is bounded and returns PrcError.

API

PrcFile::parse(data) -> Result<PrcFile, PrcError>                 // header, file structures, model file
PrcFile::parse_with_limit(data, max_inflated) -> Result<PrcFile, PrcError>
FileStructure::section(SectionKind) -> &[u8]                       // inflated globals / tree / tessellation / geometry / extra geometry
FileStructure::schema() -> Result<Schema, PrcError>                // the globals section's leading schema
Schema::read(&mut BitReader) / Schema::skip_added_fields(entity_type, &mut BitReader)
BitReader: bit, bits, character, unsigned_integer, integer, integer_vbn, double_vbn, nbits_then_unsigned, string, float_as_bytes, double

MAX_INFLATED_BYTES (512 MiB) bounds every section together; TooLarge reports the limit hit.
Schema programs (how a newer producer describes fields it added) run under a step ceiling (2^22) and a nesting ceiling (64).
Unsupported names constructs the reader cannot step over (schema pointer fields, Value_CurveIs3D).
Not yet in the crate: the Double code table, so BitReader::double returns UnknownDoubleCode; the product tree and tessellation readers.