esegece.sgcPDF.Community 2026.10.0

sgcPDF .NET

sgcPDF is a PDF library for .NET by eSeGeCe. It creates, parses, edits, renders, signs, encrypts and optimizes PDF documents, fills and flattens forms, extracts text and images, and writes PDF/A and tagged PDF. It is a fully managed port of the sgcPDF Delphi library, one C# file per Delphi unit, with the same class names (TsgcPDFDocument, TsgcPDFPage, TsgcPDFEditor and so on).

Packages

Each package also ships as a free Community edition with the .Community suffix (esegece.sgcPDF.Community, esegece.sgcPDF.WinForms.Community, esegece.sgcPDF.Wpf.Community, esegece.sgcPDF.Avalonia.Community, esegece.sgcPDF.sgcSign.Community), see Editions.

netstandard2.0 reaches .NET Framework 4.6.2 and later, Mono and Xamarin. The only third party dependencies are System.Security.Cryptography.Pkcs (CMS for signatures and certificate encryption) and, on netstandard2.0 and net472, System.Memory.

Install

dotnet add package esegece.sgcPDF
dotnet add package esegece.sgcPDF.WinForms
dotnet add package esegece.sgcPDF.sgcSign

Only the first one is required. Add the WinForms package for on screen rendering and the viewer controls, and the sgcSign package for PAdES signatures through sgcSign. For the free Community edition use the same ids with the .Community suffix, for example dotnet add package esegece.sgcPDF.Community.

Features

• Create documents: text with the 14 standard fonts or embedded TrueType, CFF and CJK fonts (subset, Unicode), lines, shapes, gradients, transparency, images (JPEG, PNG, BMP, TIFF), tables, 1D and 2D barcodes (QR Code, DataMatrix, EAN, UPC and more), bookmarks, links, annotations and layers.
• Parse and edit existing files: classic and stream cross reference tables, incremental updates, merge, split, extract and rotate pages, watermarks, page numbers, true redaction, optimizer.
• Forms: create AcroForm fields, fill, flatten, import and export the form data.
• Security: RC4 40/128, AES-128 and AES-256 password encryption, and public key (certificate) encryption, both ways.
• Signatures: sign with a certificate (PFX or Windows store), verify signatures and the certificate chain, and PAdES B-B to B-LTA through the sgcSign bridge.
• Standards: PDF/A-1b, 2b and 3b, tagged PDF (PDF/UA-1, PDF/A-2a), embedded files and Factur-X / ZUGFeRD attachments.
• Extraction: text per page with search, and images to files or streams.
• Rendering: platform independent renderer core with all image types and colour spaces (JPEG, JPEG 2000, CCITT, JBIG2), shadings, patterns, soft masks, blend modes, optional content, annotation appearances and embedded fonts. TsgcPDFRendererRaster renders pages to PNG or BMP on any platform, and the WinForms package adds the GDI backend and the viewer controls.
• HTML to PDF: TsgcPDFHTMLRenderer lays out an HTML string or file on PDF pages.

Quick start

Create a PDF, save it, then load it again and extract its text:

using System;
using esegece.sgcPDF;

class Program
{
    static void Main()
    {
        // Create a one page A4 document and save it
        using (TsgcPDFDocument oDoc = new TsgcPDFDocument())
        {
            TsgcPDFPage oPage = oDoc.AddPage(595, 842);
            oPage.DrawText("Hello from sgcPDF", 50, 780, TsgcPDFStandardFont.sfHelveticaBold, 24);
            oPage.DrawLine(50, 770, 545, 770, 1.0);
            oPage.DrawText("Created with sgcPDF .NET.", 50, 740, TsgcPDFStandardFont.sfHelvetica, 12);
            oDoc.SaveToFile("hello.pdf");
        }

        // Load it again and extract the text of every page
        using (TsgcPDFDocument oDoc = new TsgcPDFDocument())
        {
            oDoc.LoadFromFile("hello.pdf");
            for (int i = 0; i < oDoc.PageCount(); i++)
                Console.WriteLine(oDoc.ExtractTextW(i));
        }
    }
}

Output:

Hello from sgcPDF
Created with sgcPDF .NET.

Show a PDF in a Windows Forms application

With esegece.sgcPDF.WinForms:

TsgcPDFViewerControl oViewer = new TsgcPDFViewerControl();
oViewer.Parent = this;
oViewer.Dock = DockStyle.Fill;
oViewer.LoadFromFile("hello.pdf");

The control supports zoom, text selection, search, form filling, links, layers and printing. TsgcPDFThumbnailView and TsgcPDFOutlineView add a page strip and a bookmark tree.

Sign to PAdES with sgcSign

With esegece.sgcPDF.sgcSign (namespaces esegece.sgcPDF and esegece.sgcSign):

TsgcPFXKeyProvider oKey = new TsgcPFXKeyProvider();
oKey.LoadFromFile("certificate.pfx", "password");

TsgcPDFPAdESSigner oSigner = new TsgcPDFPAdESSigner();
oSigner.KeyProvider = oKey;
oSigner.Level = TsgcPDFPAdESLevel.paBT;
oSigner.TSAURL = "http://timestamp.digicert.com";
oSigner.SignPDFFile("hello.pdf", "hello-signed.pdf");

Any sgcSign key provider works in place of the PFX one, for example PEM, CSC remote signing, AWS KMS, Google Cloud KMS or HashiCorp Vault. Plain CMS signatures without sgcSign are available in the core package through TsgcPDFSignatureHandler and TsgcPDFSignatureVerifier.

Demos

The demos folder holds 26 Windows Forms demos targeting net8.0-windows, each a mirror of the Delphi demo with the same name:

Inside the source tree the demos reference the library projects. In a demos only bundle, where ..\source does not exist, demos\Directory.Build.props and demos\Directory.Build.targets switch them to the sgcPDF NuGet packages. Pass -p:SgcPDFUseProject=false to force the package mode. The Community and Registered package choice is switched in one place, demos\Directory.Build.props (SgcPDFCommunity, Community by default).

Build from source

dotnet build sgcPDF.sln -c Release
build\pack.bat

build\pack.bat packs the three packages (with symbol packages) into nupkg in both editions, the Community ones with -p:SgcCommunity=true, and build\release.bat also bundles the demos and the sources into dist. Building the net472 targets needs the .NET Framework 4.7.2 targeting pack. The sgcSign bridge project expects the sgcSign .NET sources next to this tree.

Documentation

Product page, documentation and release notes: https://www.esegece.com

Editions

All editions ship the same feature set. They differ in licensing, not capability.

• Community (esegece.sgcPDF.Community, esegece.sgcPDF.WinForms.Community, esegece.sgcPDF.sgcSign.Community) is free for both commercial and non-commercial use by small teams: individuals and organizations under EUR 1M annual gross revenue and with no more than 5 developers. It shows a brief, non-blocking one-time startup notice. Organizations at or above either threshold need a paid licence. The Community sgcSign bridge depends on esegece.sgcSign.Community.
• Registered (esegece.sgcPDF, esegece.sgcPDF.WinForms, esegece.sgcPDF.sgcSign) removes the notice and carries the commercial licence.

Only one of the two editions should be referenced at a time.

Licence

sgcPDF is commercial software. The Registered packages ship under the licence in LICENSE.txt, and you must accept it to install them. The Community packages ship under LICENSE-Community.txt. See https://www.esegece.com for the licence options.

copyright (c) 2026 eSeGeCe