VellumPdf.Layout 2.3.0

VellumPdf.Layout

The high-level document builder of VellumPdf, a dependency-free PDF library for .NET 10 implemented clean-room from ISO 32000. It pulls in VellumPdf.Kernel, so for most applications this is the only package you need to add.

• Paragraphs, headings, lists, tables, images, pie charts, header/footer bands, and bookmarks.
• Automatic pagination and tagged content for accessible, archival output.
• PDF/A-2b/2u/2a conformance, CI-validated with veraPDF.

Install

dotnet add package VellumPdf.Layout

Usage

using VellumPdf.Fonts;             // Standard14
using VellumPdf.Layout;            // Document
using VellumPdf.Layout.Core;       // TextStyle
using VellumPdf.Layout.Elements;   // Heading, Paragraph

using var doc = new Document();
doc.SetDefaultFont(new TextStyle { Font = Standard14.Helvetica, FontSize = 11 });
doc.Add(new Heading("Hello, world!"));
doc.Add(new Paragraph("Generated with VellumPdf — no native dependencies."));
doc.Save("hello.pdf");

Need precise, low-level drawing instead? Use the VellumPdf.Kernel canvas directly.

Documentation

Layout guide, with a capability table and worked examples: https://github.com/Tim81/VellumPDF/blob/main/docs/layout-guide.md

Quick start and examples: https://github.com/Tim81/VellumPDF#quick-start

Capabilities

Built from src/VellumPdf.Layout/PublicAPI.Shipped.txt and the test suite, not from the roadmap prose — a row is only marked Supported where a test or a public member proves it. See the Layout guide for the narrative walkthrough this table summarizes.

The VellumPdf family

Roadmap

Planned direction, tracked as GitHub milestones. These are scopes, not commitments — the milestones carry no due dates. 2.3.0 is the latest published release.

Scope past 2.5 runs as two parallel tracks, because auditing the layout engine turned up more work than the PDF 2.0 conformance gap did. Both ship from the same version numbers.

Kernel and conformance

Layout

Editing existing documents. The only breaking milestone is 3.0.

What this library implements of ISO 32000-2 today is inventoried, reference by reference, in PDF 2.0 conformance. It emits a %PDF-2.0 header, which is not the same as conformance, and the table says which is which. The Reader guide and Layout guide each carry a capability table doing the same job for their own package, checked against the code and test suite rather than against this roadmap.

VellumPdf.Reader is marked Preview in the table above; expect its public surface to settle as these milestones land. VellumPdf.Conformance graduated to Stable in 2.0.

License

Apache-2.0. Source and issues: https://github.com/Tim81/VellumPDF