kitepdf-pdf/io.github.yuroyami.kitepdf.render/PageRenderer

PageRenderer

class PageRenderer(canvas: KiteCanvas, resolver: IndirectResolver, formState: PdfFormState? = null)

The content-stream interpreter. It translates parsed Operations into KiteCanvas draw calls while maintaining the full PDF graphics-state stack (ISO 32000-1 §8 + §9).

Architecture mirrors MuPDF's pdf_processor / pdf_op_run.c:

Walk operations one by one.
Mutate the GraphicsStack for state-changing ops.
Accumulate path construction in a KitePath.Builder.
On paint operators, hand the path off to the device.
Inside BT…ET, run the text state machine (Tm/Tlm/Tj/TJ/'/" etc.).

The interpreter is single-pass and stateless w.r.t. previous pages: every call to render starts with a fresh state stack.

Constructors

PageRenderer

constructor(canvas: KiteCanvas, resolver: IndirectResolver, formState: PdfFormState? = null)

Types

XObjectSlot

class XObjectSlot(val objectNumber: Long?, val stream: PdfStream)

An XObject with the indirect object number it resolved from (null for the rare ref-less inline entry). The number keys the decoded caches.

Functions

render

fun render(page: PdfPage, deviceCtm: KiteMatrix = defaultDeviceCtm(page), annotations: (PdfAnnotation) -> Boolean = { true })

Paints page under deviceCtm, then the annotations that annotations accepts. { false } leaves the page content on its own (#133).

renderAnnotations

fun renderAnnotations(page: PdfPage, deviceCtm: KiteMatrix = defaultDeviceCtm(page), annotations: (PdfAnnotation) -> Boolean = { true })

Paints only the annotations annotations accepts, and none of the page's own content.