ZingPDF.OCR 1.0.60

dotnet add package ZingPDF.OCR --version 1.0.60
                    
NuGet\Install-Package ZingPDF.OCR -Version 1.0.60
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ZingPDF.OCR" Version="1.0.60" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ZingPDF.OCR" Version="1.0.60" />
                    
Directory.Packages.props
<PackageReference Include="ZingPDF.OCR" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add ZingPDF.OCR --version 1.0.60
                    
#r "nuget: ZingPDF.OCR, 1.0.60"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package ZingPDF.OCR@1.0.60
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=ZingPDF.OCR&version=1.0.60
                    
Install as a Cake Addin
#tool nuget:?package=ZingPDF.OCR&version=1.0.60
                    
Install as a Cake Tool

ZingPDF logomark

ZingPDF.OCR

ZingPDF.OCR supplies image-candidate OCR and an explicit rendered-page OCR mode for mixed text, scans and tiled images.

.NET compatibility

Targets net8.0, with .NET 8 as the minimum. Runtime validation covers .NET 8, 9, and 10 on Windows. .NET Framework 4.x and applications targeting .NET 6 or 7 are not supported. Native dependencies and deployment requirements remain package-specific. See runtime and platform requirements.

Installation

dotnet add package ZingPDF.OCR

The built-in TesseractOcrEngine also needs Tesseract language data at runtime. See the official Tesseract documentation for setup details.

Quick start

using ZingPDF;
using ZingPDF.OCR;

using var pdf = Pdf.Load(File.OpenRead("scanned.pdf"));
var engine = new TesseractOcrEngine("./tessdata", "eng");

var text = await pdf.ExtractPlainTextWithOcrAsync(engine);

This preserves the default: return existing nonblank embedded text, otherwise OCR the largest supported image XObject. A digital header can therefore bypass a scanned body, and one candidate can omit other image tiles. Use the rendered-page mode for visible-page input coverage:

var result = await pdf.ExtractTextWithOcrAsync(1, engine, new PdfOcrOptions
{
    Mode = PdfOcrMode.RenderedPage,
    Dpi = 300,
    MaxPixelCount = 50_000_000
}, cancellationToken);

Console.WriteLine(result.Source);
Console.WriteLine(result.InputCoverage);

Rendered-page mode uses PDFium to produce a PNG of the visible crop/media intersection with page rotation and annotations. It ignores PreferEmbeddedText and sends that rendered image to the selected IOcrEngine. InputCoverage describes the supplied image, not recognition accuracy or recovered-text completeness. Source distinguishes embedded text, a single image candidate, a rendered page and no input.

Main workflows

  • extract OCR text from scanned or image-based PDF pages
  • combine OCR with the main text extraction workflow
  • use the built-in TesseractOcrEngine or a custom IOcrEngine

Current limits

  • image-candidate mode processes one usable image XObject; it does not cover arbitrary page drawing commands or multiple scan tiles
  • JPEG, JPEG 2000 passthrough, and common 8-bit RGB or grayscale streams are supported candidate inputs; rendered-page mode uses PNG output from the page renderer
  • rendered-page mode requires the native PDFium rendering dependencies on the deployed platform; install and validate them before disabling runtime network access
  • rendering resolution is 72–600 DPI; the default is 300 DPI and the default rendered-image limit is 50 million pixels
  • cancellation is checked between operations and passed to the engine; native rendering and in-process OCR are not guaranteed to stop immediately after cancellation, so enforce hard job deadlines in a separately supervised worker
  • TesseractOcrEngine requires native Tesseract support and language data files at runtime

Licensing

ZingPDF is proprietary software. Review LICENSE.txt and ensure you have paid license coverage with sufficient seats, or another applicable commercial agreement, before commercial use or commercial bundling. Versions released during a paid subscription remain licensed within the purchased scope after it ends; new versions and support require an active subscription.

Evaluation and other non-commercial use are free.

Support and compatibility

See SUPPORT.md in the package root or docs/project/SUPPORT.md in the repository for the current support stance and release-readiness notes.

Product 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 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.60 118 11/3/2026
1.0.59 131 10/11/2026
1.0.58 158 5/28/2026
1.0.57 130 5/25/2026
1.0.56 133 5/15/2026
1.0.54 152 4/19/2026
1.0.53 140 4/19/2026
1.0.51 131 4/19/2026
1.0.49 129 4/9/2026
1.0.48 141 4/7/2026
1.0.45 142 4/6/2026
1.0.44 135 4/6/2026
1.0.43 136 4/6/2026