graphitepdf-render 0.3.0

Overview

graphitepdf-render lowers layout output into typed render commands and also provides the concrete PDF backend used in the production crate-native pipeline.

Scope

graphitepdf-render contains:

• RenderDocument, RenderPage, and RenderCommand
• typed operations for text, images, SVG, fills, borders, transforms, forms, and debug overlays
• RenderEngine for lowering safe layout output into render commands
• RendererSession, PdfRenderBackend, and render_to_* helpers for end-to-end PDF generation

Installation

cargo add graphitepdf-render

API Summary

Example

use graphitepdf_font::{FontSource, StandardFont};
use graphitepdf_layout::{Document, LayoutEngine, LayoutStyle, Node, Page};
use graphitepdf_primitives::Pt;
use graphitepdf_render::{RenderEngine, render_to_bytes};
use graphitepdf_textkit::{TextBlock, TextSpan};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let block = TextBlock::from(TextSpan::new("Render me")?);
    let document = Document::new().with_page(
        Page::new([
            Node::text(block).with_style(
                LayoutStyle::new()
                    .with_font_family("Helvetica")
                    .with_font_source(FontSource::standard(StandardFont::Helvetica))
                    .with_font_size(Pt::new(12.0)),
            ),
        ]),
    );

    let layout = LayoutEngine::new().layout_document(&document)?;
    let render_document = RenderEngine::new().build(&layout)?;
    assert_eq!(render_document.pages.len(), 1);

    let pdf = render_to_bytes(&document)?;
    assert!(pdf.starts_with(b"%PDF-1.7"));
    Ok(())
}

Design Principles

• keep render commands typed and inspectable
• separate layout decisions from backend emission details
• make the production PDF path available without forcing callers through the root crate
• reuse kit for low-level PDF mechanics rather than re-implementing them here

Role In GraphitePDF

This crate is the canonical bridge from layout output to final PDF generation. It is the core of the production layout -> render -> kit -> PDF path.

License

MIT