JetsonPDF.Writer 1.0.0

JetsonPDF.Writer

The low-level PDF authoring API. Builds PDF documents from scratch, byte by byte, following ISO 32000-2 (PDF 2.0). Headless, pure net8.0, no native deps.

using JetsonPDF;

var doc = new Document
{
    Title = "Hello",
    Author = "Me",
};

var page = doc.AddPage(PageSize.Letter);
page.DrawText("Hello, world!", new Font(FontFamily.Helvetica, 24), x: 72, y: 720);
page.DrawRectangle(72, 600, 200, 80, stroke: Color.Black, fill: Color.RedLight);

doc.Save("hello.pdf");

Save has three overloads: Save(string path), Save(Stream), and a parameterless byte[] Save() for serializing entirely in memory.

If you'd rather think in containers and decorators than in raw page operators, look at JetsonPDF.Fluent (QuestPDF-style) or JetsonPDF.Flow (Word-like retained DOM) — both layer on top of this writer.

What's covered

• Page content: text, vector paths (move/line/curve/close + fill rules), raster images (PNG with alpha + Adam7 + ICC, JPEG, JBIG2, CCITT G3/G4, inline images, image masks), Form XObjects, tiling and shading patterns (axial, radial, function-based, Coons + tensor patches), clipping, graphics state, transforms (PushGraphicsState / PopGraphicsState / Transform).
• Color: Device + CIE-based (CalGray, CalRGB, Lab), ICC, Indexed, Separation, DeviceN / NChannel; PdfFunction Types 0/2/3/4 (sampled + PostScript).
• Fonts: standard 14 (with Adobe Core 14 AFM metrics), TrueType / OpenType embedding with subsetting, CID composite (Identity-H), CFF subsetting on write, Type 3 procedural fonts with /ToUnicode.
• Annotations: Link, Highlight / Underline / StrikeOut / Squiggly, FreeText, Stamp, Caret, FileAttachment + embedded files (Factur-X / associated files via /AF), Popup, Sound, Redact, Line / Polygon / PolyLine, Ink.
• Forms: AcroForm — Tx / Btn / Ch / Sig / barcode widgets, /AA triggers, /CO calculation order, signature /SV seed values, /Lock, DocMDP / FieldMDP transforms, DocTimeStamp incremental (/ETSI.RFC3161), DSS / VRI for PAdES B-LTA.
• Encryption: standard handler — RC4-40, RC4-128, AES-128, AES-256.
• Document metadata: outlines, page labels, named destinations, viewer preferences, page layout / mode, OpenAction, OCG / layers, structure tree (real nested elements + role / class maps + /AF + OBJR refs), /Measure
  • /VP viewports + coordinate systems, PieceInfo.
• Conformance declarations: PDF/A-1b, PDF/A-2/3 (a/u/b variants), PDF/UA-1, PDF/UA-2 — sets the right XMP namespaces and catalog flags. Optional validation via doc.Validate(); opt-in strict mode via Save(throwOnConformanceError: true).
• Post-processing: linearization (Annex F fast-web-view layout with proper Page Offset + Shared Object hint tables), incremental updates, digital signatures (PKCS#7 detached, invisible).

Targets

• net8.0

License

MIT.