Struct ProcessingLimits 

pub struct ProcessingLimits {
    pub max_file_bytes: u64,
    pub max_stream_bytes: u64,
    pub max_total_memory_bytes: u64,
    pub max_object_depth: u32,
    pub max_operator_count: u64,
    pub max_image_pixels: u64,
    pub max_xfa_nesting_depth: u32,
    pub max_formcalc_depth: u32,
}

Resource limits for a single PDF processing operation.

Construct via ProcessingLimits::default() for standard limits, or use the builder methods to customize for your use case.

Examples

use pdf_engine::limits::ProcessingLimits;

// Default limits (recommended for server-side processing):
let limits = ProcessingLimits::default();

// Stricter limits for WASM/browser context:
let wasm_limits = ProcessingLimits::wasm();

// Custom limits:
let custom = ProcessingLimits::default()
    .max_file_bytes(100 * 1024 * 1024)   // 100 MB
    .max_stream_bytes(64 * 1024 * 1024);  // 64 MB per stream

Fields

max_file_bytes: u64

Maximum PDF file size in bytes. Default: 500 MB.

max_stream_bytes: u64

Maximum decompressed size of any single stream. Default: 256 MB. Prevents zip bombs via FlateDecode or LZWDecode.

max_total_memory_bytes: u64

Maximum total memory allocated per document. Default: 1 GB.

max_object_depth: u32

Maximum object reference depth (prevents stack overflow on recursive refs). Default: 100.

max_operator_count: u64

Maximum content stream operators per page. Default: 10,000,000.

max_image_pixels: u64

Maximum pixel count per image (width × height). Default: 268,435,456 (16384²).

max_xfa_nesting_depth: u32

Maximum XFA template XML nesting depth. Default: 50.

max_formcalc_depth: u32

Maximum FormCalc recursion depth. Default: 200.

Implementations

impl ProcessingLimits

pub fn new() -> Self

Create a new set of limits with default values.

pub fn wasm() -> Self

Strict limits for WASM/browser contexts with limited memory.

• Max file: 50 MB
• Max stream: 32 MB
• Max total memory: 128 MB
• Image pixels: 64 MP (8192×8192)

pub fn unlimited() -> Self

Unlimited: no resource limits (use only in trusted environments).

pub fn max_file_bytes(self, bytes: u64) -> Self

Set maximum PDF file size.

pub fn max_stream_bytes(self, bytes: u64) -> Self

Set maximum decompressed stream size.

pub fn max_total_memory_bytes(self, bytes: u64) -> Self

Set maximum total memory per document.

pub fn max_object_depth(self, depth: u32) -> Self

Set maximum object reference depth.

pub fn max_operator_count(self, count: u64) -> Self

Set maximum content stream operator count.

pub fn max_image_pixels(self, pixels: u64) -> Self

Set maximum image pixel count (width × height).

pub fn max_xfa_nesting_depth(self, depth: u32) -> Self

Set maximum XFA template nesting depth.

pub fn max_formcalc_depth(self, depth: u32) -> Self

Set maximum FormCalc recursion depth.

pub fn check_file_size(&self, bytes: u64) -> Result<(), LimitError>

Check if a file size is within limits. Returns Err with a descriptive message if exceeded.

pub fn check_stream_size(&self, bytes: u64) -> Result<(), LimitError>

Check if a decompressed stream size is within limits.

pub fn check_image_pixels( &self, width: u64, height: u64, ) -> Result<(), LimitError>

Check if image dimensions are within limits.

pub fn check_object_depth(&self, depth: u32) -> Result<(), LimitError>

Check if an object depth is within limits.

Trait Implementations

impl Clone for ProcessingLimits

fn clone(&self) -> ProcessingLimits

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProcessingLimits

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

Formats the value using the given formatter.

impl Default for ProcessingLimits

fn default() -> Self

Returns the “default value” for a type.