Skip to content
lamina

render-too-large

All codes

  • Type: error
  • Kind: limit (a configured limit was exceeded)

What happened

A render backend (lamina-render) refused a request because the tile it asks for is larger than the document’s RenderLimits: more than max_render_pixels pixels, more than max_render_side pixels on a side, or (for hayro, which reads the whole file) an input longer than max_input_bytes.

Why

Page sizes and zoom levels come from files and users, so a render could otherwise ask for a bitmap of any size. The limits are checked before anything is allocated (ADR 0004 §1). The defaults are 16,777,216 pixels per tile (4096 × 4096, iOS Safari’s per-canvas cap), 16,384 pixels per side and 1 GiB of input.

How to fix

At high zoom, render the visible part of the page as tiles of 256 to 512 pixels (RenderRequest::with_clip) instead of the whole page. Raise the limits with RenderOpenOptions::with_limits only when the larger bitmap is intended.

Example

let req = RenderRequest::page(0, 1000.0); // a letter page at 1000×: 612,000 × 792,000 pixels
doc.render(&req, &mut out, &CancelToken::new())?; // render-too-large

Data fields

  • width, height: the tile’s size (tile limits).
  • limit: the limit exceeded.
  • unit: pixels, pixels per side or pixels per side (hayro) (tile limits).
  • len: the input’s length in bytes (the input limit, with limit).