DocuVieware.API
3.4.12
Prefix Reserved
dotnet add package DocuVieware.API --version 3.4.12
NuGet\Install-Package DocuVieware.API -Version 3.4.12
<PackageReference Include="DocuVieware.API" Version="3.4.12" />
<PackageVersion Include="DocuVieware.API" Version="3.4.12" />
<PackageReference Include="DocuVieware.API" />
paket add DocuVieware.API --version 3.4.12
#r "nuget: DocuVieware.API, 3.4.12"
#:package DocuVieware.API@3.4.12
#addin nuget:?package=DocuVieware.API&version=3.4.12
#tool nuget:?package=DocuVieware.API&version=3.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.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.
| 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
- DocuVieware.runtimes.macos (>= 3.4.12)
- DocuVieware.runtimes.windows (>= 3.4.12)
- GdPicture.API (>= 14.4.12)
- Newtonsoft.Json (>= 13.0.3)
- protobuf-net (>= 3.2.56)
-
net8.0
- DocuVieware.runtimes.macos (>= 3.4.12)
- DocuVieware.runtimes.windows (>= 3.4.12)
- GdPicture.API (>= 14.4.12)
- Newtonsoft.Json (>= 13.0.3)
- protobuf-net (>= 3.2.56)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on DocuVieware.API:
| Package | Downloads |
|---|---|
|
DocuVieware.Blazor
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 3.4.12 | 84 | 11/15/2026 |
| 3.4.11.1 | 163 | 10/26/2026 |
| 3.4.10 | 322 | 10/15/2026 |
| 3.4.9 | 1,319 | 9/18/2026 |
| 3.4.8.1 | 620 | 8/27/2026 |
| 3.4.8 | 868 | 8/21/2026 |
| 3.4.7 | 1,141 | 7/28/2026 |
| 3.4.6.1 | 186 | 7/18/2026 |
| 3.4.6 | 149 | 7/17/2026 |
| 3.4.5.1 | 328 | 6/29/2026 |
| 3.4.5 | 170 | 6/25/2026 |
| 3.4.4 | 456 | 6/12/2026 |
| 3.4.3 | 223 | 5/22/2026 |
| 3.4.2 | 957 | 5/6/2026 |
| 3.4.1 | 318 | 4/3/2026 |
| 3.4.0 | 191 | 3/26/2026 |
| 3.3.26 | 408 | 2/27/2026 |
| 3.3.25 | 340 | 2/20/2026 |
| 3.3.24 | 257 | 2/5/2026 |
### 3.4.12
#### DocuVieware
* Improves right-to-left pages: dialogs, comments and panels mirror, and each text keeps its own direction. (L#DV-798)
* Replaces the DocuVieware TWAIN connector with the Nutrient Scanning Connector, which scans on Windows and on Macs with Apple silicon. Each user approves the sites that may scan: the acquisition dialog, a scan or the new DocuViewareAPI.TwainGetSourcesAsync asks them, and TwainGetSources returns null until they have. After they refuse a site twice, the prompt also offers to stop it asking, and the diagnostics page lists the blocked sites so they can unblock one. On Windows, the scanner list shows each scanner's bitness, such as "Fujitsu fi-7160 (64-bit)", and lists a driver installed in both bitnesses twice, so users can pick its 32-bit or 64-bit version; a plain scanner name still scans, with the 64-bit version when there is one. The scanner driver's dialog no longer appears: without a custom configuration, scans use the feeder when the scanner has one (the flatbed otherwise) at 200 dpi in color, and TwainSetConfig's hideUI and xferCount are ignored. TwainSetConfig's extConfig sets the scanner's image processing capabilities on Windows (blank page discard, color filter, brightness, contrast, threshold, deskew, automatic rotation, rotation, border detection, automatic brightness and double feed detection); the browser console names the ones a scanner refuses, other capabilities are not sent, and macOS ignores them. A scan that ends with paper still in the feeder shows a notice that pages may be missing. Scans stop with an error when a scanner keeps sending pages (2000 by default, or the same page 25 times in a row) or sends no page for five minutes, and on Windows a scanner driver that fails, after a paper jam for example, no longer stays stuck until the connector restarts. DocuVieware offers the connector's installer for the user's platform and asks for an update when a newer one ships. DocuViewareManager.SetLegacyTwainConnectorMode keeps the previous connector for sites that need it. The acquisition dialog has a Details panel with the connector's state and the exact error code, and the connector installs a "Nutrient Scanning Connector diagnostics" shortcut that checks the installation and tests the scanners. Scanner names and connector messages now appear as plain text in the dialog, so a scanner name can no longer inject HTML into the page. In the Blazor component, TwainGetLocalServiceStatus now returns a TwainLocalServiceStatus. (GH#3978)
* Fixes annotation dialogs keeping earlier text: new text annotations open empty, editing shows the annotation's text. (L#DV-784)
* Fixes copied right-to-left text swapping adjacent numbers and moving percent and currency signs. (L#DV-597)
* Fixes dropdown lists in PSPDFKitLight theme dialogs opening to the left of the selected value. (GH#4105)
* Fixes Dutch browsers getting Romanian labels when the viewer detects the language automatically. (L#DV-798)
* Fixes mistranslated and English-only scan and text selection labels in most viewer languages. (L#DV-798)
* Fixes mistranslated and overly literal Hebrew button labels in the viewer dialogs. (L#DV-786)
* Fixes Office documents intermittently failing to load in IIS applications that impersonate users. (L#DV-776)
* Fixes right-to-left text such as Hebrew being reversed when copied from the viewer. (L#DV-597, L#DV-798)
* Fixes search missing Hebrew and Arabic text in Office files and showing reversed snippets in results. (L#DV-743)
* Fixes search results dropping document text that looks like HTML tags. (L#DV-798)
* Fixes text selection in right-to-left lines taking the wrong part of a number or date. (L#DV-597)
* Fixes text selection losing lines when a drag crosses right-to-left and left-to-right text. (L#DV-597)
* Fixes the copy menu interrupting the next text selection. (L#DV-597)
* Fixes the preview hint in the annotation and signature dialogs always showing in English. (L#DV-798)
* Fixes the signature text preview placing bottom-aligned text outside its box. (L#DV-798)
* Fixes the text annotation dialog so its preview and alignment buttons match how right-to-left text is drawn. (L#DV-785)
* Fixes viewers that stopped loading when several opened at once right after the application started. (GH#4108)