Function pdfs::parsePDFToml
Defined in File PDFFileParser.hpp
Function Documentation
-
auto pdfs::parsePDFToml(const toml::table &deck) -> PDF
Construct a PDF object from a toml-format PDF descriptor.
A toml-format counterpart to parsePDFLegacy(), extending the same basic/advanced PDF descriptor format to toml. The table’s top-level keys form a header, analogous to the first lines of a parsePDFLegacy() file:
”format” (optional string, “basic” or “advanced”; defaults to “basic”)
”breakpoints” (an array of at least two numbers; required if format is “basic”, and not allowed if format is “advanced”)
”method” (optional string, one of the same sampling method names parsePDFLegacy() itself recognizes; defaults to stop-nearest sampling if omitted) Every other top-level key must be a table named segmentN (N = 1, 2, …), numbered sequentially with no gaps, one per PDF segment, each analogous to one “segment”/”type TYPE”/… block in a parsePDFLegacy() file: a required “type” key naming one of the recognized PDFSegment types, plus whatever keys that segment type’s own toml-based constructor requires. If format is “basic”, segmentN’s own [sMin, sMax) range is taken from breakpoints[N-1]/breakpoints[N], the number of segments must be exactly breakpoints.size() - 1, and segment weights are computed (as parsePDFLegacy() itself does) so adjacent segments agree at their shared breakpoint; if “advanced”, each segmentN table must additionally specify its own sMin/sMax/weight directly, and no such continuity is enforced.