TrinePDF 1.0.0-beta.1

TrinePDF

A comprehensive PDF generation library for .NET, evolved from the TCPDF PHP library. Targeting .NET 10+.

Overview

TrinePDF is a comprehensive PDF generation library for .NET. It produces PDF files entirely in managed C# code, with no dependency on external PDF renderers or native libraries for core functionality.

Features

Quick Start

using TrinePDF.Core;

// Create a new PDF document (A4, portrait, millimeters)
using var doc = new PdfDocument(PageOrientation.Portrait, PdfUnit.Millimeters, PageSize.A4);

// Set document metadata
doc.Title = "My First PDF";
doc.Author = "Your Name";

// Configure margins
doc.SetMargins(15, 15, 15);

// Add a page
doc.AddPage();

// Set the font and write text
doc.SetFont("Helvetica", FontStyle.Bold, 16);
doc.Cell(0, 10, "Hello from TrinePDF!", newLine: true, align: TextAlign.Center);

doc.SetFont("Helvetica", FontStyle.None, 12);
doc.Cell(0, 8, "This PDF was generated entirely in managed C#.");

// Save to file
doc.Save("output.pdf");

Installation

Install the core library from NuGet:

dotnet add package TrinePDF

For lightweight inline HTML rendering:

dotnet add package TrinePDF.Html.Inline

For full HTML-to-PDF support (browser-based):

dotnet add package TrinePDF.Html

Requirements

• .NET 10 or later
• SkiaSharp, HarfBuzzSharp, and ZXing.Net (pulled automatically via NuGet)
• On Linux, also reference SkiaSharp.NativeAssets.Linux (or .NoDependencies for containers) and HarfBuzzSharp.NativeAssets.Linux; neither base package ships a Linux native binary
• For inline HTML rendering: AngleSharp (included in the TrinePDF.Html.Inline package)
• For full HTML-to-PDF: PuppeteerSharp (included in the TrinePDF.Html package; downloads Chromium on first use)

Documentation

Full documentation is available in the project wiki.

• Getting Started
• User Guides
• API Reference
• Technical Architecture

Attribution

TrinePDF is derived from TCPDF by Nicola Asuni (Tecnick.com LTD), originally licensed under LGPL-3.0. See ATTRIBUTION.md for full details.

Contributing

Contributions are welcome. Please see CONTRIBUTING.md for guidelines on submitting issues, feature requests, and pull requests.

License

This project is dual-licensed:

• Open source: GNU Lesser General Public License v3.0 — see LICENSE
• Commercial: Proprietary license available — see COMMERCIAL-LICENSE.md