PaddleOCR vs IronOCR: .NET OCR Library Comparison

The Three-Model Pipeline in Practice

Every PaddleOCR inference call runs three neural networks back-to-back. The code below shows the complete setup path that a developer encounters before any text is returned:

// Five packages required before this compiles:
// dotnet add package Sdcb.PaddleOCR
// dotnet add package Sdcb.PaddleOCR.Models.Online
// dotnet add package Sdcb.PaddleInference.runtime.win64.mkl
// dotnet add package OpenCvSharp4
// dotnet add package OpenCvSharp4.runtime.win

using Sdcb.PaddleOCR;
using Sdcb.PaddleOCR.Models.Online;
using OpenCvSharp;

// Async download from Baidu servers — blocks first run for 10-30 seconds
FullOcrModel models = await OnlineFullModels.ChineseV4.DownloadAsync();

// PaddleOcrAll bundles detection, classification, and recognition
using PaddleOcrAll ocr = new PaddleOcrAll(models)
{
    AllowRotateDetection = true,
    Enable180Classification = true
};

// OpenCV required — no file path shortcut
using Mat mat = Cv2.ImRead("document.png");

if (mat.Empty())
{
    throw new FileNotFoundException("Could not load image");
}

// Three neural networks fire in sequence
PaddleOcrResult result = ocr.Run(mat);

Console.WriteLine(result.Text);

// Five packages required before this compiles:
// dotnet add package Sdcb.PaddleOCR
// dotnet add package Sdcb.PaddleOCR.Models.Online
// dotnet add package Sdcb.PaddleInference.runtime.win64.mkl
// dotnet add package OpenCvSharp4
// dotnet add package OpenCvSharp4.runtime.win

using Sdcb.PaddleOCR;
using Sdcb.PaddleOCR.Models.Online;
using OpenCvSharp;

// Async download from Baidu servers — blocks first run for 10-30 seconds
FullOcrModel models = await OnlineFullModels.ChineseV4.DownloadAsync();

// PaddleOcrAll bundles detection, classification, and recognition
using PaddleOcrAll ocr = new PaddleOcrAll(models)
{
    AllowRotateDetection = true,
    Enable180Classification = true
};

// OpenCV required — no file path shortcut
using Mat mat = Cv2.ImRead("document.png");

if (mat.Empty())
{
    throw new FileNotFoundException("Could not load image");
}

// Three neural networks fire in sequence
PaddleOcrResult result = ocr.Run(mat);

Console.WriteLine(result.Text);

Imports Sdcb.PaddleOCR
Imports Sdcb.PaddleOCR.Models.Online
Imports OpenCvSharp

' Five packages required before this compiles:
' dotnet add package Sdcb.PaddleOCR
' dotnet add package Sdcb.PaddleOCR.Models.Online
' dotnet add package Sdcb.PaddleInference.runtime.win64.mkl
' dotnet add package OpenCvSharp4
' dotnet add package OpenCvSharp4.runtime.win

' Async download from Baidu servers — blocks first run for 10-30 seconds
Dim models As FullOcrModel = Await OnlineFullModels.ChineseV4.DownloadAsync()

' PaddleOcrAll bundles detection, classification, and recognition
Using ocr As New PaddleOcrAll(models) With {
    .AllowRotateDetection = True,
    .Enable180Classification = True
}

    ' OpenCV required — no file path shortcut
    Using mat As Mat = Cv2.ImRead("document.png")

        If mat.Empty() Then
            Throw New FileNotFoundException("Could not load image")
        End If

        ' Three neural networks fire in sequence
        Dim result As PaddleOcrResult = ocr.Run(mat)

        Console.WriteLine(result.Text)
    End Using
End Using

The result.Regions array contains individual text region objects, each with a Text string, a Score confidence value, and a Rect bounding box. To filter by confidence: result.Regions.Where(r => r.Score > 0.8). Region ordering is spatial, not reading-order guaranteed, so sorting by region.Rect.Center.Y then region.Rect.Center.X is a common pattern.

Detailed Feature Comparison

PaddleOCR Approach

The Chinese model pipeline performs well because the detection and recognition networks were trained on large-scale Chinese document datasets by Baidu, whose core business involves processing Chinese web content at scale.

// Chinese model: highest accuracy for CJK documents
FullOcrModel models = await OnlineFullModels.ChineseV4.DownloadAsync();

using PaddleOcrAll ocr = new PaddleOcrAll(models)
{
    AllowRotateDetection = true,
    Enable180Classification = true
};

using Mat mat = Cv2.ImRead("chinese-invoice.png");
PaddleOcrResult result = ocr.Run(mat);

// Filter low-confidence regions for cleaner output
var highConfidence = result.Regions
    .Where(r => r.Score >= 0.8)
    .OrderBy(r => r.Rect.Center.Y)
    .ThenBy(r => r.Rect.Center.X);

foreach (var region in highConfidence)
{
    Console.WriteLine($"{region.Text} ({region.Score:P0})");
}

// Chinese model: highest accuracy for CJK documents
FullOcrModel models = await OnlineFullModels.ChineseV4.DownloadAsync();

using PaddleOcrAll ocr = new PaddleOcrAll(models)
{
    AllowRotateDetection = true,
    Enable180Classification = true
};

using Mat mat = Cv2.ImRead("chinese-invoice.png");
PaddleOcrResult result = ocr.Run(mat);

// Filter low-confidence regions for cleaner output
var highConfidence = result.Regions
    .Where(r => r.Score >= 0.8)
    .OrderBy(r => r.Rect.Center.Y)
    .ThenBy(r => r.Rect.Center.X);

foreach (var region in highConfidence)
{
    Console.WriteLine($"{region.Text} ({region.Score:P0})");
}

Imports System
Imports System.Linq
Imports OpenCvSharp

' Chinese model: highest accuracy for CJK documents
Dim models As FullOcrModel = Await OnlineFullModels.ChineseV4.DownloadAsync()

Using ocr As New PaddleOcrAll(models) With {
    .AllowRotateDetection = True,
    .Enable180Classification = True
}

    Using mat As Mat = Cv2.ImRead("chinese-invoice.png")
        Dim result As PaddleOcrResult = ocr.Run(mat)

        ' Filter low-confidence regions for cleaner output
        Dim highConfidence = result.Regions _
            .Where(Function(r) r.Score >= 0.8) _
            .OrderBy(Function(r) r.Rect.Center.Y) _
            .ThenBy(Function(r) r.Rect.Center.X)

        For Each region In highConfidence
            Console.WriteLine($"{region.Text} ({region.Score:P0})")
        Next
    End Using
End Using

The confidence filter pattern (r.Score >= 0.8) is important because the deep learning detection step will occasionally flag non-text regions as text. Without filtering, noise regions appear in the output. Sorting by Rect.Center.Y then Rect.Center.X approximates reading order but does not guarantee it for complex multi-column layouts.

IronOCR Approach

IronOCR's Chinese Simplified support installs as a NuGet package and requires no model management. Accuracy on Chinese documents runs at 85-90% — lower than PaddleOCR's 95%+ on the same material, but sufficient for many production use cases, particularly when the documents have consistent formatting.

// dotnet add package IronOcr.Languages.ChineseSimplified

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.ChineseSimplified;

using var input = new OcrInput();
input.LoadImage("chinese-invoice.png");

// Preprocessing handles rotation, noise, and contrast automatically
input.Deskew();
input.DeNoise();

var result = ocr.Read(input);

// Word-level results with coordinates
foreach (var word in result.Words)
{
    Console.WriteLine($"{word.Text} at ({word.X},{word.Y}) — {word.Confidence}%");
}

// dotnet add package IronOcr.Languages.ChineseSimplified

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.ChineseSimplified;

using var input = new OcrInput();
input.LoadImage("chinese-invoice.png");

// Preprocessing handles rotation, noise, and contrast automatically
input.Deskew();
input.DeNoise();

var result = ocr.Read(input);

// Word-level results with coordinates
foreach (var word in result.Words)
{
    Console.WriteLine($"{word.Text} at ({word.X},{word.Y}) — {word.Confidence}%");
}

Imports IronOcr

' dotnet add package IronOcr.Languages.ChineseSimplified

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.ChineseSimplified

Using input As New OcrInput()
    input.LoadImage("chinese-invoice.png")

    ' Preprocessing handles rotation, noise, and contrast automatically
    input.Deskew()
    input.DeNoise()

    Dim result = ocr.Read(input)

    ' Word-level results with coordinates
    For Each word In result.Words
        Console.WriteLine($"{word.Text} at ({word.X},{word.Y}) — {word.Confidence}%")
    Next
End Using

For teams that need multiple languages simultaneously — such as mixed Chinese/English documents — IronOCR handles the combination with AddSecondaryLanguage. PaddleOCR requires switching model sets between languages, which means separate download calls and separate engine instances.

The trade-off is specific: PaddleOCR wins on pure CJK accuracy. IronOCR wins on English/Latin accuracy (97-99% vs. 92-95%), preprocessing for poor-quality scans, and the operational simplicity of not managing model files. Teams processing documents in a mix of languages, or primarily processing European-language documents with occasional CJK content, will find IronOCR's accuracy profile more useful in aggregate. See the IronOCR tutorials hub for multi-language and preprocessing examples.

PaddleOCR Approach

PaddleOCR ships models separately from the NuGet package. Three model directories are required for a full-pipeline OCR run, and each approach to sourcing them has a different trade-off:

// Option A: Online download — simplest, but requires Baidu server access
// This runs on application startup; first run blocks for 10-30 seconds
FullOcrModel onlineModels = await OnlineFullModels.ChineseV4.DownloadAsync();

// Option B: Pre-downloaded local models — for air-gapped or compliance environments
// Developer must manually download and maintain three directories:
//   models/ch_PP-OCRv4_det_infer/
//   models/ch_ppocr_mobile_v2.0_cls_infer/
//   models/ch_PP-OCRv4_rec_infer/
FullOcrModel localModels = new FullOcrModel(
    LocalDetectionModel.FromDirectory("models/ch_PP-OCRv4_det_infer"),
    LocalClassificationModel.FromDirectory("models/ch_ppocr_mobile_v2.0_cls_infer"),
    LocalRecognitionModel.FromDirectory("models/ch_PP-OCRv4_rec_infer")
);

// Option C: Embedded model package — adds 100MB to NuGet restore, simplest deployment
// dotnet add package Sdcb.PaddleOCR.Models.LocalV4

// Japanese and Korean require separate model downloads:
FullOcrModel japaneseModels = await OnlineFullModels.JapanV4.DownloadAsync();
FullOcrModel koreanModels = await OnlineFullModels.KoreanV4.DownloadAsync();

// Option A: Online download — simplest, but requires Baidu server access
// This runs on application startup; first run blocks for 10-30 seconds
FullOcrModel onlineModels = await OnlineFullModels.ChineseV4.DownloadAsync();

// Option B: Pre-downloaded local models — for air-gapped or compliance environments
// Developer must manually download and maintain three directories:
//   models/ch_PP-OCRv4_det_infer/
//   models/ch_ppocr_mobile_v2.0_cls_infer/
//   models/ch_PP-OCRv4_rec_infer/
FullOcrModel localModels = new FullOcrModel(
    LocalDetectionModel.FromDirectory("models/ch_PP-OCRv4_det_infer"),
    LocalClassificationModel.FromDirectory("models/ch_ppocr_mobile_v2.0_cls_infer"),
    LocalRecognitionModel.FromDirectory("models/ch_PP-OCRv4_rec_infer")
);

// Option C: Embedded model package — adds 100MB to NuGet restore, simplest deployment
// dotnet add package Sdcb.PaddleOCR.Models.LocalV4

// Japanese and Korean require separate model downloads:
FullOcrModel japaneseModels = await OnlineFullModels.JapanV4.DownloadAsync();
FullOcrModel koreanModels = await OnlineFullModels.KoreanV4.DownloadAsync();

The model version must match the wrapper version. When Sdcb.PaddleOCR updates, pre-downloaded models from the previous version may require re-download. CI/CD pipelines that cache the NuGet restore step must also separately manage model file caching or trigger model downloads during the container build phase. The Docker image comparison shows the consequence: a PaddleOCR container lands at ~1.5GB; an IronOCR container at ~400MB.

IronOCR Approach

IronOCR language models are standard NuGet packages. No download calls, no model directory management, no version synchronization. The NuGet package for IronOCR includes the English model; additional language packs install exactly like any other dependency.

// dotnet add package IronOcr
// dotnet add package IronOcr.Languages.ChineseSimplified
// dotnet add package IronOcr.Languages.Japanese

using IronOcr;

// No async initialization, no model path, no version matching
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.ChineseSimplified;
ocr.AddSecondaryLanguage(OcrLanguage.Japanese);

using var input = new OcrInput();
input.LoadImage("mixed-cjk-document.png");

var result = ocr.Read(input);
Console.WriteLine(result.Text);

// dotnet add package IronOcr
// dotnet add package IronOcr.Languages.ChineseSimplified
// dotnet add package IronOcr.Languages.Japanese

using IronOcr;

// No async initialization, no model path, no version matching
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.ChineseSimplified;
ocr.AddSecondaryLanguage(OcrLanguage.Japanese);

using var input = new OcrInput();
input.LoadImage("mixed-cjk-document.png");

var result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr

' No async initialization, no model path, no version matching
Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.ChineseSimplified
ocr.AddSecondaryLanguage(OcrLanguage.Japanese)

Using input As New OcrInput()
    input.LoadImage("mixed-cjk-document.png")

    Dim result = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

Language packs restore as part of dotnet restore. The Docker build step that copies models/ directories, runs apt-get install libopencv-dev, and adds the CUDA base image simply does not exist in an IronOCR container. For teams using Docker deployment or Azure deployment, the difference in container build complexity is substantial.

PaddleOCR Approach

GPU inference requires an entirely separate software stack outside of NuGet. The environment prerequisites are precise and version-locked:

// Prerequisites (must be installed before this compiles correctly):
// 1. NVIDIA GPU with CUDA capability 3.5+
// 2. NVIDIA Driver 452.39+ (Windows) / 450.80.02+ (Linux)
// 3. CUDA Toolkit 11.8 — exact version, not 12.x
// 4. cuDNN 8.6.0+ for CUDA 11.x
// 5. dotnet add package Sdcb.PaddleInference.runtime.win64.cuda118

using Sdcb.PaddleOCR;
using Sdcb.PaddleOCR.Models.Online;
using Sdcb.PaddleInference;
using OpenCvSharp;

FullOcrModel models = await OnlineFullModels.ChineseV4.DownloadAsync();

// GPU device 0, 1000MB GPU memory pool
using PaddleOcrAll ocr = new PaddleOcrAll(models, PaddleDevice.Gpu(deviceId: 0))
{
    AllowRotateDetection = true,
    Enable180Classification = true
};

using Mat mat = Cv2.ImRead(imagePath);
PaddleOcrResult result = ocr.Run(mat);

// Prerequisites (must be installed before this compiles correctly):
// 1. NVIDIA GPU with CUDA capability 3.5+
// 2. NVIDIA Driver 452.39+ (Windows) / 450.80.02+ (Linux)
// 3. CUDA Toolkit 11.8 — exact version, not 12.x
// 4. cuDNN 8.6.0+ for CUDA 11.x
// 5. dotnet add package Sdcb.PaddleInference.runtime.win64.cuda118

using Sdcb.PaddleOCR;
using Sdcb.PaddleOCR.Models.Online;
using Sdcb.PaddleInference;
using OpenCvSharp;

FullOcrModel models = await OnlineFullModels.ChineseV4.DownloadAsync();

// GPU device 0, 1000MB GPU memory pool
using PaddleOcrAll ocr = new PaddleOcrAll(models, PaddleDevice.Gpu(deviceId: 0))
{
    AllowRotateDetection = true,
    Enable180Classification = true
};

using Mat mat = Cv2.ImRead(imagePath);
PaddleOcrResult result = ocr.Run(mat);

Imports Sdcb.PaddleOCR
Imports Sdcb.PaddleOCR.Models.Online
Imports Sdcb.PaddleInference
Imports OpenCvSharp

' Prerequisites (must be installed before this compiles correctly):
' 1. NVIDIA GPU with CUDA capability 3.5+
' 2. NVIDIA Driver 452.39+ (Windows) / 450.80.02+ (Linux)
' 3. CUDA Toolkit 11.8 — exact version, not 12.x
' 4. cuDNN 8.6.0+ for CUDA 11.x
' 5. dotnet add package Sdcb.PaddleInference.runtime.win64.cuda118

Dim models As FullOcrModel = Await OnlineFullModels.ChineseV4.DownloadAsync()

' GPU device 0, 1000MB GPU memory pool
Using ocr As New PaddleOcrAll(models, PaddleDevice.Gpu(deviceId:=0)) With {
    .AllowRotateDetection = True,
    .Enable180Classification = True
}

    Using mat As Mat = Cv2.ImRead(imagePath)
        Dim result As PaddleOcrResult = ocr.Run(mat)
    End Using

End Using

If CUDA_PATH is not set, the matching cuDNN DLL is absent from the expected path, or the runtime package version mismatches the installed CUDA toolkit, the call throws a native library load exception. Diagnosing that failure requires checking driver versions, PATH entries, and DLL presence across several directories. In Docker, GPU support requires the nvidia/cuda:11.8.0-cudnn8-runtime-ubuntu22.04 base image plus nvidia-container-toolkit on the host, adding complexity to both the image build and the container runtime configuration.

For CPU-only deployments, PaddleOCR defaults to the MKL-accelerated runtime: ~300-500ms per image with a 3-5 second model-load cold start.

IronOCR Approach

IronOCR is engineered for CPU inference. It delivers 150-300ms per image on standard hardware with no GPU dependency, no CUDA stack, and no driver version concerns. The engine also starts under one second because models are bundled rather than loaded from disk on initialization.

using IronOcr;

// No GPU setup, no CUDA, no driver checks
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

var ocr = new IronTesseract();

// Preprocessing built-in — improves accuracy on poor scans without extra code
using var input = new OcrInput();
input.LoadImage("document.png");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(300);

var result = ocr.Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

using IronOcr;

// No GPU setup, no CUDA, no driver checks
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

var ocr = new IronTesseract();

// Preprocessing built-in — improves accuracy on poor scans without extra code
using var input = new OcrInput();
input.LoadImage("document.png");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(300);

var result = ocr.Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

Imports IronOcr

' No GPU setup, no CUDA, no driver checks
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

Dim ocr As New IronTesseract()

' Preprocessing built-in — improves accuracy on poor scans without extra code
Using input As New OcrInput()
    input.LoadImage("document.png")
    input.Deskew()
    input.DeNoise()
    input.EnhanceResolution(300)

    Dim result = ocr.Read(input)
    Console.WriteLine($"Confidence: {result.Confidence}%")
End Using

For throughput at scale without GPU hardware, IronOCR's thread-safe design allows Parallel.ForEach across a batch of images with separate IronTesseract instances — each processes independently without locking. The multithreading example shows the pattern. At 150-300ms per image on a 4-core CPU, a batch of 100 images completes in 20-40 seconds using parallelism — CPU throughput that makes GPU investment unnecessary for most web API and document pipeline scenarios.

The image quality correction guide covers preprocessing configuration in detail for cases where automatic preprocessing needs tuning.

PaddleOCR Approach

// Requires additional package: PdfiumViewer or similar
using Sdcb.PaddleOCR;
using Sdcb.PaddleOCR.Models.Online;
using OpenCvSharp;
using PdfiumViewer;
using System.Drawing.Imaging;
using System.Text;

FullOcrModel models = await OnlineFullModels.ChineseV4.DownloadAsync();
using PaddleOcrAll ocr = new PaddleOcrAll(models);

var results = new StringBuilder();

// Manual PDF-to-image conversion, page by page
using PdfDocument pdf = PdfDocument.Load("document.pdf");

for (int i = 0; i < pdf.PageCount; i++)
{
    // Render page to bitmap — 200 DPI
    using var pageImage = pdf.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi);

    // Save to temp file — OpenCvSharp cannot read from memory easily
    string tempPath = Path.GetTempFileName() + ".png";
    pageImage.Save(tempPath, ImageFormat.Png);

    try
    {
        using Mat mat = Cv2.ImRead(tempPath);
        var result = ocr.Run(mat);
        results.AppendLine($"--- Page {i + 1} ---");
        results.AppendLine(result.Text);
    }
    finally
    {
        File.Delete(tempPath);  // Must clean up temp files
    }
}

return results.ToString();

// Requires additional package: PdfiumViewer or similar
using Sdcb.PaddleOCR;
using Sdcb.PaddleOCR.Models.Online;
using OpenCvSharp;
using PdfiumViewer;
using System.Drawing.Imaging;
using System.Text;

FullOcrModel models = await OnlineFullModels.ChineseV4.DownloadAsync();
using PaddleOcrAll ocr = new PaddleOcrAll(models);

var results = new StringBuilder();

// Manual PDF-to-image conversion, page by page
using PdfDocument pdf = PdfDocument.Load("document.pdf");

for (int i = 0; i < pdf.PageCount; i++)
{
    // Render page to bitmap — 200 DPI
    using var pageImage = pdf.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi);

    // Save to temp file — OpenCvSharp cannot read from memory easily
    string tempPath = Path.GetTempFileName() + ".png";
    pageImage.Save(tempPath, ImageFormat.Png);

    try
    {
        using Mat mat = Cv2.ImRead(tempPath);
        var result = ocr.Run(mat);
        results.AppendLine($"--- Page {i + 1} ---");
        results.AppendLine(result.Text);
    }
    finally
    {
        File.Delete(tempPath);  // Must clean up temp files
    }
}

return results.ToString();

Imports Sdcb.PaddleOCR
Imports Sdcb.PaddleOCR.Models.Online
Imports OpenCvSharp
Imports PdfiumViewer
Imports System.Drawing.Imaging
Imports System.Text

Dim models As FullOcrModel = Await OnlineFullModels.ChineseV4.DownloadAsync()
Using ocr As New PaddleOcrAll(models)

    Dim results As New StringBuilder()

    ' Manual PDF-to-image conversion, page by page
    Using pdf As PdfDocument = PdfDocument.Load("document.pdf")

        For i As Integer = 0 To pdf.PageCount - 1
            ' Render page to bitmap — 200 DPI
            Using pageImage = pdf.Render(i, 200, 200, PdfRenderFlags.CorrectFromDpi)

                ' Save to temp file — OpenCvSharp cannot read from memory easily
                Dim tempPath As String = Path.GetTempFileName() & ".png"
                pageImage.Save(tempPath, ImageFormat.Png)

                Try
                    Using mat As Mat = Cv2.ImRead(tempPath)
                        Dim result = ocr.Run(mat)
                        results.AppendLine($"--- Page {i + 1} ---")
                        results.AppendLine(result.Text)
                    End Using
                Finally
                    File.Delete(tempPath)  ' Must clean up temp files
                End Try
            End Using
        Next
    End Using

    Return results.ToString()
End Using

That is 30+ lines for a single PDF. Adding another NuGet dependency (PdfiumViewer), manual page rendering at a chosen DPI, temp file creation and deletion, and iterative accumulation of results — all before PaddleOCR itself fires. A DPI choice too low degrades accuracy; too high increases processing time. The developer owns that decision.

IronOCR Approach

IronOCR reads PDFs natively. No conversion library, no temp files, no per-page loop at the call site:

using IronOcr;

var ocr = new IronTesseract();

// Native PDF input — no external library needed
using var input = new OcrInput();
input.LoadPdf("document.pdf");

var result = ocr.Read(input);

// Per-page access available if needed
foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}: {page.Text.Length} chars");
}

// Produce a searchable PDF in one additional line
result.SaveAsSearchablePdf("searchable-output.pdf");

using IronOcr;

var ocr = new IronTesseract();

// Native PDF input — no external library needed
using var input = new OcrInput();
input.LoadPdf("document.pdf");

var result = ocr.Read(input);

// Per-page access available if needed
foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}: {page.Text.Length} chars");
}

// Produce a searchable PDF in one additional line
result.SaveAsSearchablePdf("searchable-output.pdf");

Imports IronOcr

Dim ocr As New IronTesseract()

' Native PDF input — no external library needed
Using input As New OcrInput()
    input.LoadPdf("document.pdf")

    Dim result = ocr.Read(input)

    ' Per-page access available if needed
    For Each page In result.Pages
        Console.WriteLine($"Page {page.PageNumber}: {page.Text.Length} chars")
    Next

    ' Produce a searchable PDF in one additional line
    result.SaveAsSearchablePdf("searchable-output.pdf")
End Using

Password-protected PDFs use the same LoadPdf path with a Password parameter. The PDF input guide and searchable PDF guide cover multi-page and output options in detail. For organizations digitizing scanned document archives — where every file arrives as a PDF — this difference eliminates a significant layer of integration code.

When Language Requirements Expand Beyond 14

A project begins processing Chinese invoices — PaddleOCR handles it well. Then the customer base expands and documents arrive in Polish, Dutch, Greek, Vietnamese, and Turkish. PaddleOCR's 14 supported languages do not cover any of these. The migration becomes necessary because the tool cannot grow with the use case. Adding Polish support in IronOCR is a single NuGet package addition and a one-line config change. Teams that scope a project as "initially Chinese-heavy but eventually multi-regional" need to decide upfront whether to start with a tool that can scale language coverage without a rewrite.

When the Setup Cost Exceeds the Problem Budget

The PaddleOCR documentation estimates first-time setup at 30-60 minutes for CPU and 2-8 hours for GPU. Developer time at $100/hour means the first GPU configuration attempt costs $200-800 before the first production image is processed. IronOCR setup is a single install command and a four-line code sample — under five minutes. For internal tools, prototypes, or projects where OCR is a secondary feature rather than the core product, that time difference determines whether the OCR feature ships in the current sprint or gets deprioritized. Getting started with IronOCR takes less time than configuring a CUDA environment.

When PDF Workflows Dominate

Organizations digitizing scanned document archives, processing fax-to-PDF pipelines, or extracting data from PDF-format invoices and contracts face a structural problem with PaddleOCR: every PDF requires an additional library, manual page rendering, temp file management, and DPI selection logic before PaddleOCR can process it. That is not incidental complexity — it is permanent maintenance. Teams that discover their workload is 80%+ PDF-based after initial PaddleOCR integration typically migrate when the PDF conversion layer becomes a source of bugs rather than when PaddleOCR itself fails.

When Compliance Reviews Flag the Baidu Origin

Enterprise security teams in government, defense, healthcare, and financial services organizations increasingly apply review criteria to components with origins in Chinese-state-connected companies. PaddleOCR is a Baidu project; model downloads connect to Baidu Cloud Storage by default; the PaddlePaddle framework is a Baidu product. The code runs locally and documents are not transmitted, but the model artifacts originate from Baidu infrastructure. For FedRAMP, ITAR, or CMMC environments, that provenance triggers a compliance review that can block adoption. IronOCR is a product of Iron Software, a US-based company, processes all content locally, makes no external connections, and requires no model downloads from any third-party server.

When GPU Infrastructure Is Not in Place

PaddleOCR on CPU (300-500ms/image, 3-5 second cold start, 500MB-1GB memory) is slower and heavier than IronOCR on CPU (150-300ms/image, under 1 second cold start, 100-200MB memory). The GPU advantage of PaddleOCR only materializes after CUDA/cuDNN setup, and that advantage only justifies the operational complexity at high volume. Teams running standard cloud infrastructure without GPU instances — EC2 without GPU, Azure App Service, AWS Lambda — are paying the PaddleOCR setup cost without receiving the performance benefit that justifies it.

Package and Namespace Replacement

The package swap removes five dependencies and adds one. Remove Sdcb.PaddleOCR, Sdcb.PaddleOCR.Models.Online, the Sdcb.PaddleInference.runtime.* package, OpenCvSharp4, and OpenCvSharp4.runtime.win from the .csproj. Add IronOcr. Add language packs as NuGet packages for any non-English language that was previously using a downloaded model set.

The using Sdcb.PaddleOCR and using OpenCvSharp directives replace with using IronOcr. The Mat mat = Cv2.ImRead(path) pattern replaces with new OcrInput(path) or input.LoadImage(path). The ocr.Run(mat) call becomes ocr.Read(input). For projects using the image input API, the OcrInput object accepts file paths, byte arrays, streams, and System.Drawing.Bitmap — the OpenCvSharp intermediary disappears entirely.

Result Structure Remapping

PaddleOCR returns result.Regions — an array of PaddleOcrResultRegion objects where region.Score is a float from 0 to 1. IronOCR returns result.Words — where word.Confidence is a percentage from 0 to 100. The confidence filter r.Score >= 0.8 maps to w.Confidence >= 80. Bounding box access changes from region.Rect.Center.X / region.Rect.Size.Width to word.X / word.Width. The structured results guide covers pages, paragraphs, lines, and words.

Spatial sorting (order by Y then X to approximate reading order) is less commonly needed with IronOCR because the Tesseract layout engine performs reading-order analysis as part of its page segmentation step. For documents where PaddleOCR required explicit sort logic, test whether IronOCR's default output order already meets the requirement before porting the sort code.

Preprocessing Transition

PaddleOCR's deep learning detection model tolerates moderate image quality degradation — the neural network handles noise and skew more reliably than Tesseract's classical segmentation pipeline. When migrating to IronOCR, add explicit preprocessing for documents that were previously processed successfully without it:

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("low-quality-scan.png");

// These filters recover the accuracy that PaddleOCR provided automatically
// on noisy or skewed inputs
input.Deskew();
input.DeNoise();
input.Contrast();
input.Binarize();
input.EnhanceResolution(300);

var result = ocr.Read(input);

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("low-quality-scan.png");

// These filters recover the accuracy that PaddleOCR provided automatically
// on noisy or skewed inputs
input.Deskew();
input.DeNoise();
input.Contrast();
input.Binarize();
input.EnhanceResolution(300);

var result = ocr.Read(input);

Imports IronOcr

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    input.LoadImage("low-quality-scan.png")

    ' These filters recover the accuracy that PaddleOCR provided automatically
    ' on noisy or skewed inputs
    input.Deskew()
    input.DeNoise()
    input.Contrast()
    input.Binarize()
    input.EnhanceResolution(300)

    Dim result = ocr.Read(input)
End Using

For scanned documents at non-standard angles or with background noise, these four filters recover most of the accuracy gap. The image orientation correction guide and image color correction guide document each filter's effect on common scan artifacts. Run representative documents through both pipelines before finalizing the migration to verify accuracy meets requirements on the actual document set.

Deployment Cleanup

After migration, the deployment artifact shrinks significantly. Delete the models/ directory tree (three subdirectories, ~21MB of model files), paddle_inference.dll (~200MB), paddle2onnx.dll (~5MB), and the opencv_world*.dll files (~50MB combined). Remove the apt-get install libopencv-dev line from the Dockerfile and the model-copy step. Remove any CI/CD steps that pre-download models or cache model directories. The Docker image drops from ~1.5GB to ~400MB.