GdPicture.API 14.3.0.1

.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.OCR** 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.

** The .NET 8.0 assembly on Linux requires GLIBC 2.29 or newer.*

Package Overview and Dependencies

graph BT;
    subgraph "Cross-Platform API"
	     B["GdPicture.API"];
    end
    
		subgraph "Windows Only + GdViewer"
	    A["GdPicture"] --> B
    end
    
    subgraph "Server-Side Web Viewer"
	    C["DocuVieware"] --> B
	  end
	  
	  subgraph "Cross-Platform GdViewer (Preview)"
	    D["GdPicture.MAUI"] --> B
    end

%%    subgraph "Native Runtime"
%%    B --> E["GdPicture.runtimes.windows"];
%%    B --> F["GdPicture.runtimes.linux"];
%%    B --> G["GdPicture.runtimes.macos"];
%%    end

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 lightweight document processing and manipulation tasks.

Optional package

• GdPicture.Resources.OCR: Resources for GdPicture required for OCR processing.

Alternative packages

• **GdPicture:** A Windows-only package that wraps GdPicture.API and extends its capabilities by adding GdViewers (WPF and Winform).
• **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 and 2D barcodes (including QR, Micro QR, Data Matrix, PDF417, Aztec Code, and MaxiCode). 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

Read the full API reference.

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.

Docuvieware

GdPicture