Getting started with OnePDF

dotnet new console -o PdfStart
cd PdfStart
dotnet add package RecursiveAI.OnePdf --version 1.11.0
dotnet add package RecursiveAI.OnePdf.Layout --version 1.11.0   # only for generating documents

using OnePdf;
using OnePdf.Text;
 
using PdfDocument doc = PdfDocument.Open("report.pdf");
Console.WriteLine($"{doc.PageCount} pages, PDF {doc.Version}, title: {doc.Info.Title}");
 
// The text of every page, in reading order.
IReadOnlyList<PdfPageText> pages = doc.ExtractText();
Console.WriteLine(pages[0].Text);
 
// Words with their boxes, in PDF points with the origin at the lower left of the page.
PdfPageText first = doc.Pages[0].ExtractText();
foreach (PdfTextWord word in first.Words.Take(5))
    Console.WriteLine($"{word.Text,-10} left={word.Bounds.Left:F1} bottom={word.Bounds.Bottom:F1} width={word.Bounds.Width:F1}");

6 pages, PDF 1.7, title: Harbor trial report
Harbor trial report
 
Week 1
 
Prepared by Jane Doe, account 4471-2290. The harbor trial ran for six weeks. Each crew logged its
...
Left column: crews on the north quay. Left column:
crews on the north quay. Left column: crews on the
...
Right column: crews on the south quay. Right column:
...
Harbor     left=54.0 bottom=727.7 width=27.5
trial      left=84.0 bottom=727.7 width=14.5

using OnePdf;
 
// Merge two files into a new document.
using (PdfDocument a = PdfDocument.Open("chapter-1.pdf"))
using (PdfDocument b = PdfDocument.Open("chapter-2.pdf"))
using (PdfDocument merged = PdfDocument.Merge([a, b]))
{
    merged.SetInfo("Title", "Chapters 1 and 2");
    merged.Save("chapters.pdf");
}
 
// Rotate and delete pages of an existing file. Page indexes are zero-based.
using (PdfDocument doc = PdfDocument.Open("report.pdf", new PdfOpenOptions { AllowEditing = true }))
{
    doc.RotatePage(0, 90);       // clockwise, added to the current rotation
    doc.RemovePages([4, 5]);     // the last two pages
    doc.Save("report-edited.pdf");
}
 
// Split into files of two pages each.
using (PdfDocument doc = PdfDocument.Open("report.pdf"))
{
    int n = 1;
    foreach (PdfDocument part in PdfDocument.Split(doc, pagesPerPart: 2))
    {
        part.Save($"report-part-{n++}.pdf");
        part.Dispose();
    }
}

using OnePdf;
 
using PdfDocument doc = PdfDocument.Open("of345.pdf", new PdfOpenOptions { AllowEditing = true });
PdfAcroForm form = doc.Form ?? throw new InvalidOperationException("The file has no form.");
 
foreach (PdfFormField field in form.TerminalFields.Take(6))
    Console.WriteLine($"{field.FullName} ({field.Kind})");
 
form.SetValue("name", "Ada Lovelace");
form.SetValue("title", "Analyst");
form.SetChecked("xyes1", true);
doc.Save("of345-filled.pdf");

name (Text)
dob (Text)
title (Text)
homeaddr (Text)
agcy (Text)
xyes1 (CheckBox)

using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
using OnePdf;
 
// A self-signed certificate for trying this out. In production, load your own certificate with its private key.
using RSA key = RSA.Create(3072);
var request = new CertificateRequest("CN=Example Signer", key, HashAlgorithmName.SHA256, RSASignaturePadding.Pkcs1);
request.CertificateExtensions.Add(new X509KeyUsageExtension(X509KeyUsageFlags.DigitalSignature | X509KeyUsageFlags.NonRepudiation, critical: true));
using X509Certificate2 certificate = request.CreateSelfSigned(DateTimeOffset.UtcNow.AddDays(-1), DateTimeOffset.UtcNow.AddYears(1));
 
using (PdfDocument doc = PdfDocument.Open("report.pdf", new PdfOpenOptions { AllowEditing = true }))
{
    doc.Sign("report-signed.pdf", PdfSigningCredential.FromCertificate(certificate), new PdfSigningOptions
    {
        FieldName = "Approval",
        Reason = "Approved for release",
        PageIndex = 5,
        Rectangle = new PdfRectangle(54, 400, 254, 460),   // omit for an invisible signature
    });
}
 
using (PdfDocument signed = PdfDocument.Open("report-signed.pdf"))
{
    PdfSignatureReport report = signed.VerifySignatures(new PdfSignatureVerifyOptions { TrustAnchors = [certificate] });
    foreach (PdfSignatureVerification v in report.Signatures)
        Console.WriteLine($"{v.Signature.FieldName}: valid={v.IsValid}, chain={v.Chain}, coverage={v.Coverage}");
}

Approval: valid=True, chain=Trusted, coverage=WholeDocument

using System.Globalization;
using OnePdf.Layout;
 
var us = CultureInfo.GetCultureInfo("en-US");
var lines = new (string Item, int Quantity, decimal Price)[]
{
    ("Design review", 2, 450.00m),
    ("Implementation, hours", 12, 120.00m),
    ("Hosting, October", 1, 80.00m),
};
decimal total = lines.Sum(l => l.Quantity * l.Price);
 
LayoutDocument.Compose(doc =>
{
    doc.Title("Invoice 2026-104").Language("en-US");
    doc.Page(page =>
    {
        page.Size(PageSize.Letter);
        page.Margin(54);
        page.Content().Column(col =>
        {
            col.Spacing(14);
            col.Item().Row(row =>
            {
                row.RelativeItem().Heading(1).Text("Invoice").FontSize(26).Bold();
                row.RelativeItem().AlignEnd().Text("No. 2026-104\nOctober 26, 2026");
            });
            col.Item().Text("Bill to: Example Co., 100 Main Street, Springfield");
            col.Item().Table(table =>
            {
                table.Columns(c => { c.Relative(3); c.Constant(60); c.Constant(90); c.Constant(90); });
                table.CellPadding(5);
                table.CellBorder(0.5, Colors.LightGrey);
                table.HeaderRow(r =>
                {
                    r.Cell().Text("Item").Bold();
                    r.Cell().AlignEnd().Text("Qty").Bold();
                    r.Cell().AlignEnd().Text("Price").Bold();
                    r.Cell().AlignEnd().Text("Amount").Bold();
                });
                foreach (var l in lines)
                {
                    table.Row(r =>
                    {
                        r.Cell().Text(l.Item);
                        r.Cell().AlignEnd().Text(l.Quantity.ToString(us));
                        r.Cell().AlignEnd().Text(l.Price.ToString("C", us));
                        r.Cell().AlignEnd().Text((l.Quantity * l.Price).ToString("C", us));
                    });
                }
                table.FooterRow(r =>
                {
                    r.Cell().Span(3).AlignEnd().Text("Total").Bold();
                    r.Cell().AlignEnd().Text(total.ToString("C", us)).Bold();
                });
            });
        });
        page.Footer().AlignCenter().Text("Payment due within 30 days.").FontSize(9);
    });
}).Save("invoice.pdf");

                                                                                       No. 2026-104
Invoice                                                                             October 26, 2026
 
Bill to: Example Co., 100 Main Street, Springfield
 
 Item                                                           Qty         Price          Amount
 
 Design review                                                        2   $450.00          $900.00
 
 Implementation, hours                                            12      $120.00        $1,440.00
 
 Hosting, October                                                     1    $80.00           $80.00
 
                                                                            Total        $2,420.00

dotnet add package RecursiveAI.OnePdf.Fonts --version 1.11.0
dotnet add package RecursiveAI.OnePdf.Hyphenation --version 1.11.0