Struct DocumentBuilder 

pub struct DocumentBuilder { /* private fields */ }

High-level builder for creating multi-page PDF documents with automatic layout.

Wraps FlowLayout with an owned-chaining API so you can build a complete document in a single expression.

Example

use oxidize_pdf::layout::DocumentBuilder;
use oxidize_pdf::Font;

let mut doc = DocumentBuilder::a4()
    .add_text("Invoice #001", Font::HelveticaBold, 18.0)
    .add_spacer(10.0)
    .add_text("Date: 2026-04-09", Font::Helvetica, 12.0)
    .build()
    .unwrap();

doc.save("invoice.pdf").unwrap();

Implementations

impl DocumentBuilder

pub fn a4() -> Self

Create a builder with A4 page size and default 72pt margins.

pub fn new(config: PageConfig) -> Self

Create a builder with custom page configuration.

pub fn add_text(self, text: &str, font: Font, font_size: f64) -> Self

Add a text block with default line height (1.2).

pub fn add_text_with_line_height( self, text: &str, font: Font, font_size: f64, line_height: f64, ) -> Self

Add a text block with custom line height.

pub fn add_spacer(self, points: f64) -> Self

Add vertical spacing in points.

pub fn add_table(self, table: Table) -> Self

Add a table.

pub fn add_image( self, name: &str, image: Arc<Image>, max_width: f64, max_height: f64, ) -> Self

Add an image scaled to fit within max dimensions, left-aligned.

pub fn add_image_centered( self, name: &str, image: Arc<Image>, max_width: f64, max_height: f64, ) -> Self

Add an image scaled to fit, centered horizontally.

pub fn add_rich_text(self, rich: RichText) -> Self

Add a single line of mixed-style text.

pub fn build(self) -> Result<Document>

Build the document, creating pages as needed for all added elements.