GdPicture.API
14.4.12
Prefix Reserved
dotnet add package GdPicture.API --version 14.4.12
NuGet\Install-Package GdPicture.API -Version 14.4.12
<PackageReference Include="GdPicture.API" Version="14.4.12" />
<PackageVersion Include="GdPicture.API" Version="14.4.12" />
<PackageReference Include="GdPicture.API" />
paket add GdPicture.API --version 14.4.12
#r "nuget: GdPicture.API, 14.4.12"
#:package GdPicture.API@14.4.12
#addin nuget:?package=GdPicture.API&version=14.4.12
#tool nuget:?package=GdPicture.API&version=14.4.12
.NET SDK README
Intelligent PDF & document processing SDKs: from scanning to barcodes to OCR to conversion to robust PDF processing — if you can think of it, this library can probably do it.
Getting Started
Setting up the SDK
using GdPicture14;
LicenseManager licence = new LicenseManager();
licence.RegisterKEY(""); // Set a demo key
Converting a Word Document to a PDF
// After Setting up the SDK
using GdPictureDocumentConverter converter = new GdPictureDocumentConverter();
converter.LoadFromFile(@"input.docx");
converter.SaveAsPDF(@"output.pdf");
Converting an Image File into Searchable PDF (OCR)
Note: For using the OCR with GdPicture the optional nuget GdPicture.Resources is required.
Method 1: Saving intermediary output in a file
// After Setting up the SDK
using GdPicturePDF pdf = new GdPicturePDF();
using GdPictureDocumentConverter converter = new GdPictureDocumentConverter();
converter.LoadFromFile(@"input.png");
converter.SaveAsPDF(@"output_intermediary.pdf");
pdf.LoadFromFile(@"output_intermediary.pdf", true);
pdf.OcrPages("*", 0, "eng", "", "", 200);
pdf.SaveToFile(@"output_with_ocr.pdf");
Method 2: With a memory stream
// After Setting up the SDK
using GdPicturePDF pdf = new GdPicturePDF();
using GdPictureDocumentConverter converter = new GdPictureDocumentConverter();
converter.LoadFromFile(@"input.png");
using MemoryStream stream = new MemoryStream();
converter.SaveAsPDF(stream);
pdf.LoadFromStream(stream);
pdf.OcrPages("*", 0, "eng", "", "", 200);
pdf.SaveToFile(@"output_with_ocr.pdf");
If you would like to see more examples, please visit the code samples page in our guides.
Introduction
GdPicture.NET is a Nutrient SDK for OCR, data extraction, editing, converting, generating PDFs, barcodes, scanning, and much more. It offers developers a rich API for quickly adding PDF, imaging, and intelligent data processing capabilities to any .NET application. There are many code samples, and it comes supported by the amazing team at Nutrient.
- Low-Level APIs: For fine-grained control
- High Fidelity: Accurate, reliable document conversion and OCR
- Prebuilt Features: Convert, edit, sign, form fill, and more
System Compatibility
Deployment
GdPicture.NET assemblies are available for the following frameworks:
- .NET 8.0
- .NET Framework 4.6.2
Using different GdPicture.NET assemblies, you can deploy the application you build to various operating systems, as outlined in the table below.
| GdPicture.NET Assembly | Operating Systems Supported for Deployment |
|---|---|
| .NET 8.0 or newer | Linux* (x64, arm64), Microsoft Windows 10 (x64/x86) or newer, Microsoft Windows Server Core 2012 (x64) or newer, macOS 14 or newer (x64/ arm64) |
| .NET Framework 4.6.2 | Microsoft Windows Vista (x64/x86) or newer Microsoft Windows Server 2008 (x64/x86) or newer |
The .NET 8.0 assembly on Linux requires GLIBC 2.34 or newer (for example Amazon Linux 2023, Debian 12, Ubuntu 22.04).
Package Overview and Dependencies
GdPicture repository contains multiple packages designed to provide flexibility, scalability, and targeted functionality for various platforms and use cases. Below is an overview of each package and its role within the ecosystem:
Main package
- GdPicture.API: A cross-platform package that provides core API-level functionality. Serves as the foundation for all other GdPicture packages and can be used independently for document processing and manipulation tasks.
Optional package
- GdPicture.Resources: Resources for GdPicture required for OCR processing.
Alternative packages
- GdPicture: A Windows-only package that wraps GdPicture.API. Starting from 14.4, the WPF and WinForms viewers are available as separate packages: GdPicture.WPF and GdPicture.WinForms.
- DocuVieware: A standalone package offering a rich viewer and collaboration solution. Ideal for web-based projects that require advanced document viewing, annotation, and sharing capabilities.
- GdPicture.MAUI: A cross-platform package that extends GdPicture.API capabilities by adding GdViewer MAUI viewer component (Preview).
Supported File Types
GdPicture.NET library enables you to load, save, and convert numerous file types, and a full list of file types can be found here.
- PDF, PDF/A
- Microsoft Office: DOC, DOCM, DOCX, DOTX, PPT, PPTM, PPTX, PPSX, XLS, XLSM, XLSX
- CAD: DXF
- Image: AI, BMP, CUR, CUT, DDS, DIB, DICOM, EMF, EXIF, EXR, G3, GIF, HDR, HEIF/HEIC, ICO, IFF, J2K, J2C, JB2, JBIG2, JIF, JFIF, JNG, JP2, JPEG, JPG, JPE, KOA, LBM, MNG, PBM, PBM RAW, PCD, PCT, PICT, PIC, PCX, PFM, PGM, PGM RAW, PJPEG, PNG, PNM, PPM, PPM RAW, PSD, RAS, RAW, RLE, SGI, SVG, TGA, TARGA, TIFF, TIF, WBMP, WAP, WBM, WMF, WSQ, XBM, XPM
- RAW Camera Image: 3FR, ARW, BAY, BMQ, CAP, CINE, CR2, CR3, CRW, CS1, DC2, DCR, DRF, DSC, DNG, ERF, FFF, HDR, IA, IIQ, KC2, K25, KDC, MDC, MEF, MOS, MRW, NEF, NRW, ORF, PEF, PTX, PXN, QTK, RAF, RAW, RDC, RW2, RW1, RWZ, SR2, SRF, SRW, STI
- Web: HTM, HTML, MHT, MHTML
- Email: EML, MSG
- Text: ODT, RTF, TXT
- PostScript: PS (Currently, PostScript implementation is experimental.)
Key Features, Documentation & Support
Nutrient offers comprehensive guides and code samples to help you quickly integrate and customize your application. It comes with full technical support that includes direct access to the engineers who built the product. Whether you have questions getting started with our SDK, or you want to know how to best integrate new features into your app, we're here to help you find a solution.
Most popular guides:
- Load a file: Load PDF documents, images and about 100 different file formats. This is the first step in using the full potential of our library. Loading files to one of our custom classes allows you to perform different actions on those files. You can use different kind of sources, such as a local machine, a byte array, a stream object, or remote URLs.
- Conversion: Convert various formats — including Office documents, images, emails, and webpages — into high-quality PDFs. Seamlessly convert PDFs back to Office formats while preserving original styling and layout.
- OCR: Leverage advanced OCR technology for zonal, full-page, and template-based text recognition, enabling searchable PDF/A creation, automated document classification, and fast processing, including barcode and specialized data decoding.
- Editor: Programmatically edit PDFs, images, and other file formats in your application. Leverage an intuitive API to manipulate, merge, split, insert, and remove PDF pages in your workflows. Easily adjust images with more than 50 unique filters, including blur, sharpen, red-eye correction, sepia, smooth, and soften. Dynamically insert text and image watermarks to protect your confidential documents and images.
- Extraction: Harness our API to automatically extract key-value pairs, tables, and structured data.
- Barcodes: Automate the recognition and decoding of 1D, 2D, and postal barcodes (including QR, Micro QR, Data Matrix, PDF417, Aztec Code, MaxiCode, and USPS Intelligent Mail). Dynamically generate barcodes in vector or raster format for insertion into image or PDF files.
- PDF Generation: Leverage a lightning-fast PDF generation engine that can merge data with templates.
- TWAIN and WIA Scanning (Windows Specific Feature): Capture images from any scanner devices and digital cameras using our enterprise-grade TWAIN and WIA toolkit, and leverage high- and low-level APIs to customize the process.
- Hyper-compression: Dramatically reduce file sizes for various document types using our mixed raster content (MRC) compression engine, which calibrates specific settings to deliver high-fidelity outputs without noticeable data loss.
- PDF/A: Convert more than 100 file types into ISO-compliant, searchable PDF/A formats with full conformance support and veraPDF validation, ideal for automated workflows and high-volume processing.
API
Changelog
For a detailed list of the changes included in each version, refer to the changelog.
License
When you integrate GdPicture.NET into your application, a trial license is activated automatically, meaning there's no need for a license key. This trial license provides the following:
- Support: Access to technical support is included.
- Watermarking: A prominent watermark (text overlay) will appear on all documents.
- Trial Notifications: Regular reminders indicating that the product is in trial mode.
For a comprehensive evaluation, please contact our Sales team to request a demo license key. This demo license enables you to explore our product for a 60-day period without watermarks or trial notifications.
Copyright 2025 Nutrient. All rights reserved.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- BouncyCastle.Cryptography (>= 2.5.0)
- DocumentFormat.OpenXml (>= 3.2.0)
- GdPicture.runtimes.linux (= 14.4.12)
- GdPicture.runtimes.macos (= 14.4.12)
- GdPicture.runtimes.windows (= 14.4.12)
- Google.Protobuf (>= 3.33.2)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- OpenMcdf (>= 3.1.4)
- Pkcs11Interop (>= 5.2.0)
- protobuf-net (>= 3.2.56)
- RtfPipe (>= 2.0.7677.4303)
- System.IO.Packaging (>= 10.0.5)
- System.Security.Cryptography.Pkcs (>= 10.0.13)
- System.Windows.Extensions (>= 10.0.5)
-
net8.0
- BouncyCastle.Cryptography (>= 2.5.0)
- DocumentFormat.OpenXml (>= 3.2.0)
- GdPicture.runtimes.linux (= 14.4.12)
- GdPicture.runtimes.macos (= 14.4.12)
- GdPicture.runtimes.windows (= 14.4.12)
- Google.Protobuf (>= 3.33.2)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.3)
- OpenMcdf (>= 3.1.4)
- Pkcs11Interop (>= 5.2.0)
- protobuf-net (>= 3.2.56)
- RtfPipe (>= 2.0.7677.4303)
- System.IO.Packaging (>= 8.0.1)
- System.Security.Cryptography.Pkcs (>= 8.0.2)
- System.Windows.Extensions (>= 8.0.0)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on GdPicture.API:
| Package | Downloads |
|---|---|
|
DocuVieware.API
Universal HTML5 Viewer and Document Management Kit |
|
|
GdPicture.XtractFlow
XtractFlow for GdPicture.NET |
|
|
GdPicture.MAUI
MAUI PDF Viewer |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 14.4.12 | 213 | 11/15/2026 |
| 14.4.11.1 | 1,628 | 10/26/2026 |
| 14.4.10 | 3,113 | 10/15/2026 |
| 14.4.9 | 19,720 | 9/18/2026 |
| 14.4.8.1 | 3,486 | 8/27/2026 |
| 14.4.8 | 1,423 | 8/21/2026 |
| 14.4.7 | 3,083 | 7/28/2026 |
| 14.4.6.1 | 993 | 7/18/2026 |
| 14.4.6 | 317 | 7/17/2026 |
| 14.4.5.1 | 2,414 | 6/29/2026 |
| 14.4.5 | 528 | 6/25/2026 |
| 14.4.4 | 1,592 | 6/12/2026 |
| 14.4.3 | 4,416 | 5/22/2026 |
| 14.4.2 | 5,528 | 5/6/2026 |
| 14.4.1 | 5,530 | 4/3/2026 |
| 14.4.0 | 948 | 3/26/2026 |
| 14.3.26 | 6,160 | 2/27/2026 |
| 14.3.25 | 612 | 2/20/2026 |
| 14.3.24 | 2,494 | 2/5/2026 |
### 14.4.12
* Upgrades System.Security.Cryptography.Pkcs to fix denial-of-service vulnerabilities CVE-2026-70162 and CVE-2026-84008. (GH#3806)
* Fixes `FetchLatestChromeHeadlessShell` leaving older Chrome versions behind and deleting folders it didn't create. (L#GDPIC-1683)
* Fixes garbled Unicode attachment filenames when reading MSG emails. (L#MAMBO-2066)
* Fixes loading the SDK on Red Hat Enterprise Linux 9, Rocky Linux 9 and AlmaLinux 9. (GH#4135)
* Fixes the COM edition GdPicture.NET.14.dll in the installer shipping without a code signature. (L#GDPIC-1597)
#### Barcode
* Fixes an intermittent crash of the process while reading Aztec and Micro QR barcodes: removing a corner of a candidate shape read past the end of a buffer. (L#GDBC-500)
* Fixes Code 128 barcodes on low-resolution scans being read as a string of digits instead of their text. (L#GDBC-501)
#### Imaging
* Adds GdPictureImaging Scanner methods to scan on macOS (ImageCaptureCore) and on Windows and Linux (TWAIN). (GH#3430)
* Improves DWG and DXF conversion with R13 and R14 DWG support, wipeouts, draw order, true-color layers and 3D meshes. (L#GDPIC-1564)
* Upgrades bundled image codecs and network libraries to versions that fix published security vulnerabilities. (GH#3938)
* Changes TwainSetDebugMode and TwainSetErrorMessage to log messages instead of showing message boxes. (GH#3430)
* Fixes a crash when reading or writing the pixels of an image area larger than 2 GB. (GH#3817)
* Fixes ConvertTo8BppQ, ConvertTo4BppQ and GIF saving dropping content from the lower part of an image, which left PDF pages rendered at 24 bits per pixel blank. (L#GDPIC-1653)
* Fixes DWG and DXF conversions drawing content from layers that AutoCAD does not plot. (L#GDPIC-1564)
* Fixes DWG files that converted to a blank page or to only part of the drawing. (L#GDPIC-1411, L#GDPIC-1564)
* Fixes GdPictureImaging.ClearImage filling 4-bit images with the wrong color. (GH#4000)
* Fixes misplaced arcs, circles, polylines and blocks drawn in tilted or mirrored planes in DWG and DXF conversions. (L#GDPIC-1564)
#### OCR
* Fixes image-processing warnings written to the standard error output during OCR. (L#OCR-1115)
* Fixes wrong page orientation detection for pages with a small text area, such as an ID card scanned on a blank sheet. (L#OCR-1090)
#### Office
* Adds optional error details for failed DocProcessor conversions. (L#GDPIC-1673)
* Adds support for loading and converting Word 2003 XML (WordprocessingML 2003) documents. (L#MAMBO-2142)
* Improves diagnostics for confirmed invalid Word packages in DocProcessor. (L#GDPIC-1680)
* Improves the speed and file size of Office to PDF conversion for documents with gradient fills. (L#MAMBO-2160)
* Fixes a gray line along the edges of transparent EMF and WMF pictures in Office documents converted to PDF. (L#MAMBO-2086)
* Fixes a thin gray edge around transparent PNG pictures when converting Word documents and other files to PDF. (L#MAMBO-2128)
* Fixes Arabic letters dropped from Word documents converted to PDF when the font draws their joined forms through OpenType substitutions, as Simplified Arabic, Dubai and Arabic Typesetting do. (L#MAMBO-2154)
* Fixes chart titles missing from Excel, PowerPoint and Word documents converted to PDF when the file leaves out the autoTitleDeleted setting, as files written by XlsxWriter, Google Sheets and older Excel versions do. (L#MAMBO-2140)
* Fixes Excel headers and footers converted at the edge of the page instead of at their header and footer margins, and pictures inserted in headers and footers missing from the converted PDF. Excel sheets set to be centered on the page are now centered. (L#MAMBO-2138)
* Fixes Excel sheets converted by DocProcessor ignoring the page margins set in the sheet. (L#MAMBO-2138)
* Fixes footnotes and endnotes referenced from right-to-left text being dropped when converting Word documents to PDF. (L#MAMBO-2086)
* Fixes garbled Hebrew and other non-Latin subjects in older MSG emails that declare their code page. (L#DV-798)
* Fixes justified right-to-left Word documents breaking a line between a word and the punctuation written against it, so a comma or closing parenthesis no longer starts a line. (L#MAMBO-2163)
* Fixes lines and arrows drawn on Excel sheets, and cells with a single diagonal border, missing from the converted PDF. Excel sheets set to print in black and white are now converted the way Excel prints them. (L#MAMBO-2120)
* Fixes list numbers and right-to-left paragraph indents of Word 97-2003 (.doc) documents converted to PDF: Arabic, Hebrew and other list number styles, lists with no number, and indents saved by Word 97. (L#MAMBO-2086)
* Fixes list numbers in right-to-left paragraphs of Word documents converted to PDF being drawn with the Latin font instead of the complex-script one. (L#MAMBO-2159)
* Fixes MSG email bodies being cut off after the first line when preformatted text was displayed. (L#GDPIC-1395)
* Fixes Office documents converted to PDF so legacy VML shapes, picture colour modes, transparent picture colours and grouped shapes look as they do in Word and PowerPoint. (L#MAMBO-2139)
* Fixes Office documents failing to open in .NET Framework web applications that impersonate users. (L#DV-776)
* Fixes PowerPoint presentations failing to convert with InvalidParameter when a theme has no name, and slides being drawn with another slide master's theme when two themes share a name. (L#MAMBO-2150)
* Fixes right-to-left tables in Word documents being drawn on the wrong side of the page: their alignment and indentation now start from the right edge, as in Word. (L#MAMBO-2164)
* Fixes subtitle text in PowerPoint presentations shifted right, or placed at the wrong height, when the slide master sets the text box margins or vertical alignment. (L#MAMBO-2135)
* Fixes the height of empty paragraphs whose paragraph mark is right-to-left in Word documents converted to PDF: they now use the complex-script font and size, as Word does. (L#MAMBO-2086)
* Fixes Word 2003 XML documents being detected as Flat OPC Word documents and failing to load with GenericError; they now report UnsupportedFormat, and rejected Flat OPC loads no longer leave temporary files behind. (L#MAMBO-2141)
* Fixes Word 97-2003 (.doc) documents converted to PDF drawing table rows in the wrong columns, so right-to-left tables no longer collapse and rows Word shows as a separate table no longer shift the table around them. (L#MAMBO-2086)
* Fixes Word documents converted to PDF repeating the content of a nested table, or pushing a table onto a later page, when the table holds floating pictures or nested floating tables; nested tables in vertical-text cells now stay upright. (L#MAMBO-2149)
* Fixes Word documents created with WPS Office failing to open with InvalidParameter when a VML shape has an empty type. (L#MAMBO-2173)
#### PDF
* Adds a FIPS mode that runs all document cryptography in the operating system's FIPS 140-3 validated module and refuses non-approved algorithms. (L#NAT-681)
* Adds GdPictureDocumentUtilities.SetCryptoBackend to run PDF signing and encryption on Botan, BouncyCastle or the OS. (GH#3677)
* Adds GdPictureDocumentUtilities.SetFipsMode: FIPS mode, detected or forced, runs PDF cryptography on the OS library and refuses RC4, MD5 and SHA-1. (L#NAT-666)
* Adds PDF signature validation against trusted certificates, with revocation and timestamp checks (ETSI EN 319 102-1). (L#GDPIC-1671)
* Adds GdPictureDocumentUtilities.SetFipsMode and GetFipsMode to force or read FIPS mode, in .NET and in the COM edition. (L#NAT-681)
* Adds HTML conversion controls and private-network allow lists while preserving linked local resources. (GH#4055)
* Adds in-place PDF tag moves, grouping, unwrapping, merging and removal through structure import. (GH#3862)
* Improves PDF/UA auto-tagging: captions are tagged as Caption, and footnotes as Note, referenced from their calls. (L#DWS-1221)
* Changes PDF encryption to run in the library SetCryptoBackend selects: BouncyCastle by default, not the OS library. (GH#3677)
* Changes PDF redaction to write black-and-white images losslessly, so content outside a redaction area keeps its shape. (GH#4000)
* Changes the page marker in PDF to Markdown output from nutrient-page-start to document-page. (L#XT-840)
* Fixes GdPicturePDF.SaveToFile with encryption saving the document unencrypted when the encryption scheme is refused. (L#NAT-666)
* Fixes PKCS#12 files that demand excessive key-derivation work tying up a signing thread; they are now refused. (GH#3677)
* Fixes valid digital signatures reported as invalid when their signature data ends with a zero byte. (GH#3677)
* Fixes a crash when adding a 1-bit, 4-bit or 8-bit image larger than 4 GB to a PDF. (GH#3817)
* Fixes GetSignatureInfo returning CertificateWrongFormat for adbe.x509.rsa_sha1 signatures. (L#NAT-666)
* Fixes invalid-content reporting for PDFs whose readable catalog lacks a usable page-tree dictionary. (L#DWS-1272)
* Fixes malformed PDF trailers being reported as access-denied errors. (GH#3901)
* Fixes new signature fields always named Signature1: they take the signer name, with periods as _ and _2 added if taken. (L#GDPDF-1545)
* Fixes PDF redaction leaving pixels of inline, undecodable, 4-bit and rotated images under a redaction area. (GH#4000)
* Fixes PDF redaction removing text that a page draws after a form XObject. (GH#4000)
* Fixes PDF tag reading order. Ordered tag imports now require patch mode without conformance conversion. (GH#3999)
* Fixes PDF text extraction joining words when a font leaves its blank space glyph out of the Unicode map. (L#XT-827)
* Fixes PDF text extraction placing form field values at the wrong position when the page content leaves a scale in effect. (L#XT-634)
* Fixes PDF/UA auto-tagging giving images the actual text "Image", which screen readers read instead of the alt text. (L#DWS-1215)
* Fixes PDF/UA auto-tagging joining headings to nearby text or lists, flattening heading levels and missing ordered lists. (L#DWS-1217, L#DWS-1218, L#DWS-1219)
* Fixes PDF/UA auto-tagging tagging running headers, footers and page numbers as paragraphs instead of artifacts. (L#DWS-1216)
* Fixes PDF/UA auto-tagging titling a multi-page document after its last page's heading instead of its first. (L#DWS-1220)
* Fixes signature fields below a parent form field being left out when PDF signatures are counted, read or validated. (L#GDPIC-1671)
* Fixes the media-load timeout being ignored when converting EML and MSG emails to PDF. (L#DV-536)
* Fixes unsafe HTML markup in HTML and Markdown exports by escaping document text by default. (L#GDPIC-1676)
* Fixes verification of RSA-PSS signatures with a non-default salt length and of DSA signatures over SHA-2. (GH#3677)
#### Templating
* API: Adds AddSubTemplateFromFile and AddSubTemplateFromBytes to GdPictureOfficeTemplateBuilder. (L#OFTAPI-30)
* Adds DOCX sub-templates to Word templates: a placeholder can insert another Word document, filled from the same data. (L#OFTAPI-30)
* Adds formatted HTML placeholder values to PowerPoint and Excel templates, with lists and links. (L#OFTAPI-29)
* Fixes Word template processing failing when an HTML value in a header or footer adds the document's first list. (L#OFTAPI-30)
#### Viewers
* Fixes a crash in the COM edition viewer when the host application unmasks floating-point exceptions, such as Xbase++. (L#GDPIC-942)
* Fixes a crash in the WPF GdViewer when a text annotation's edit box is closed right after it opens. (L#GDPIC-1665)