Struct SimpleDocumentBuilder 

pub struct SimpleDocumentBuilder { /* private fields */ }

High-level builder for simple text-only A4 PDF documents.

Does NOT require an area tree or FO pipeline — suitable for reports generated programmatically (audit logs, verification reports, etc.).

Example

use fop_render::pdf::simple::{BuiltinFont, SimpleDocumentBuilder};

let mut builder = SimpleDocumentBuilder::new("My Report");
builder.text("Hello, world!", 12.0, 20.0, 280.0, BuiltinFont::Helvetica);
let bytes = builder.save();
assert!(bytes.starts_with(b"%PDF-"));

Implementations

impl SimpleDocumentBuilder

pub fn new(title: impl Into<String>) -> Self

Create a new builder for a document with the given title.

pub fn set_author(&mut self, s: impl Into<String>) -> &mut Self

Set the document author.

pub fn set_subject(&mut self, s: impl Into<String>) -> &mut Self

Set the document subject.

pub fn set_creation_date(&mut self, s: impl Into<String>) -> &mut Self

Set the document creation date (PDF date format, e.g. D:20260515120000).

pub fn set_lang(&mut self, s: impl Into<String>) -> &mut Self

Set the document language tag (BCP 47, e.g. en-US).

pub fn set_xmp_metadata(&mut self, s: impl Into<String>) -> &mut Self

Set a raw XMP metadata packet to embed in the PDF /Metadata stream.

Dublin Core fields (dc:title, dc:creator, dc:description) are extracted and merged into the /Info dict if the corresponding builder field is not already set. Caller-set values always win.

pub fn text( &mut self, text: &str, size_pt: f32, x_mm: f32, y_mm: f32, font: BuiltinFont, )

Write text at an absolute position on the current page.

Coordinates are in millimetres from the bottom-left corner of the page (standard PDF coordinate system). The font size is in PDF points.

pub fn new_page(&mut self)

Finalise the current page and start a new blank page.

The current page is preserved even if it is empty, matching the behaviour expected by callers that create explicit page-break points.

pub fn save(self) -> Vec<u8>

Serialise all pages to a minimal valid PDF 1.4 byte stream.

The current (last) page is automatically finalised. If no calls to text() or new_page() have been made the resulting PDF will contain a single empty page, which is valid.

pub fn page_height_mm(&self) -> f32

Returns the page height in millimetres (always 297 mm for A4).