Struct LoadOptions 

pub struct LoadOptions { /* private fields */ }

Options that control how a PDF document is loaded into memory.

All options have safe defaults:

• max_file_bytes: Some(256 MiB) — rejects enormous inputs before allocating the full object graph.
• lazy_objstm: false — ObjStm streams are decompressed eagerly, but their container streams are dropped immediately after extraction (saves the decompressed container bytes; Phase 2a optimisation).

Example

let opts = LoadOptions::new()
    .max_file_bytes(64 * 1024 * 1024)   // 64 MiB hard limit
    .lazy_objstm(true);                  // defer ObjStm extraction
let doc = Document::load_mem_with_options(data, &opts)?;
doc.resolve_pending_object_streams()?;   // required when lazy_objstm = true

Implementations

impl LoadOptions

pub fn new() -> Self

Create options with default values.

pub fn max_file_bytes(self, limit: impl Into<Option<usize>>) -> Self

Set the maximum allowed input size in bytes.

Pass None to remove the limit (not recommended in worker-pool contexts).

pub fn lazy_objstm(self, lazy: bool) -> Self

Enable or disable lazy ObjStm decompression.

When true, ObjStm streams are kept compressed in Document::objects and their IDs accumulate in Document::pending_obj_streams. The caller must call Document::resolve_pending_object_streams before using the document.

Trait Implementations

impl Clone for LoadOptions

fn clone(&self) -> LoadOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LoadOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LoadOptions

fn default() -> Self

Returns the “default value” for a type.