Syncfusion OCR Library vs IronOCR: .NET OCR

The tessdata Dependency

Every Syncfusion OCR deployment requires a tessdata folder containing .traineddata files for each language the application needs. These files are not bundled with the NuGet package:

// tessdata path is required — files are not bundled with the package
private const string TessDataPath = @"tessdata/";

// OCRProcessor constructor: fails if tessdata directory is missing
// or if the required .traineddata files are absent
using var processor = new OCRProcessor(TessDataPath);
processor.Settings.Language = Languages.English;

// Perform OCR on the loaded PDF
processor.PerformOCR(document);

// Extract text requires a separate loop over pages
var text = new StringBuilder();
foreach (PdfLoadedPage page in document.Pages)
{
    text.AppendLine(page.ExtractText());
}

// tessdata path is required — files are not bundled with the package
private const string TessDataPath = @"tessdata/";

// OCRProcessor constructor: fails if tessdata directory is missing
// or if the required .traineddata files are absent
using var processor = new OCRProcessor(TessDataPath);
processor.Settings.Language = Languages.English;

// Perform OCR on the loaded PDF
processor.PerformOCR(document);

// Extract text requires a separate loop over pages
var text = new StringBuilder();
foreach (PdfLoadedPage page in document.Pages)
{
    text.AppendLine(page.ExtractText());
}

Imports System.Text

' tessdata path is required — files are not bundled with the package
Private Const TessDataPath As String = "tessdata/"

' OCRProcessor constructor: fails if tessdata directory is missing
' or if the required .traineddata files are absent
Using processor As New OCRProcessor(TessDataPath)
    processor.Settings.Language = Languages.English

    ' Perform OCR on the loaded PDF
    processor.PerformOCR(document)

    ' Extract text requires a separate loop over pages
    Dim text As New StringBuilder()
    For Each page As PdfLoadedPage In document.Pages
        text.AppendLine(page.ExtractText())
    Next
End Using

The tessdata folder must exist on the deployment target. For Docker containers, that means baking the files into the image (adding 50–500MB depending on language count). For Azure App Service, it means deploying the folder alongside the application. For CI/CD pipelines, it means scripting file downloads or checking tessdata into source control. This is pure operational overhead, not a technical limitation that gets solved once — it follows every new environment.

Detailed Feature Comparison

Syncfusion Approach

Developers who need preprocessing must pull in a separate imaging library (System.Drawing, SkiaSharp, ImageSharp, or similar), implement the filter logic, serialize the result to a file or stream, embed it in a PDF, then pass it to OCRProcessor. That is the full chain:

// Syncfusion: no preprocessing API — external library required before OCR
// This shows only the OCR portion; image manipulation is extra
using var document = new PdfLoadedDocument(preprocessedPdfPath);

// tessdata path — must exist on deployment target
using var processor = new OCRProcessor(@"tessdata/");
processor.Settings.Language = Languages.English;

// Step 1: OCR pass (adds text layer)
processor.PerformOCR(document);

// Step 2: Text extraction (separate iteration)
var text = new StringBuilder();
foreach (PdfLoadedPage page in document.Pages)
{
    text.AppendLine(page.ExtractText());
}

return text.ToString();

// Syncfusion: no preprocessing API — external library required before OCR
// This shows only the OCR portion; image manipulation is extra
using var document = new PdfLoadedDocument(preprocessedPdfPath);

// tessdata path — must exist on deployment target
using var processor = new OCRProcessor(@"tessdata/");
processor.Settings.Language = Languages.English;

// Step 1: OCR pass (adds text layer)
processor.PerformOCR(document);

// Step 2: Text extraction (separate iteration)
var text = new StringBuilder();
foreach (PdfLoadedPage page in document.Pages)
{
    text.AppendLine(page.ExtractText());
}

return text.ToString();

Imports Syncfusion.Pdf
Imports Syncfusion.OCR
Imports System.Text

' Syncfusion: no preprocessing API — external library required before OCR
' This shows only the OCR portion; image manipulation is extra
Using document As New PdfLoadedDocument(preprocessedPdfPath)

    ' tessdata path — must exist on deployment target
    Using processor As New OCRProcessor("tessdata/")
        processor.Settings.Language = Languages.English

        ' Step 1: OCR pass (adds text layer)
        processor.PerformOCR(document)

        ' Step 2: Text extraction (separate iteration)
        Dim text As New StringBuilder()
        For Each page As PdfLoadedPage In document.Pages
            text.AppendLine(page.ExtractText())
        Next

        Return text.ToString()
    End Using
End Using

The pattern for image input is worse. Syncfusion's OCRProcessor does not accept image files. A developer who needs to OCR a JPG must create a PdfDocument, add a page, load the image as a PdfBitmap, draw it onto the page, save the PDF to a MemoryStream, reload it as a PdfLoadedDocument, then run the OCR pass — nine steps before text extraction:

// Syncfusion: OCR an image — requires full PDF creation round-trip
using var pdfDoc = new PdfDocument();
var page = pdfDoc.Pages.Add();
var image = new PdfBitmap(imagePath);
page.Graphics.DrawImage(image, 0, 0, page.Size.Width, page.Size.Height);

using var stream = new MemoryStream();
pdfDoc.Save(stream);
stream.Position = 0;

using var loadedDoc = new PdfLoadedDocument(stream);
using var processor = new OCRProcessor(@"tessdata/");
processor.Settings.Language = Languages.English;
processor.PerformOCR(loadedDoc);

var text = new StringBuilder();
foreach (PdfLoadedPage p in loadedDoc.Pages)
    text.AppendLine(p.ExtractText());

return text.ToString();

// Syncfusion: OCR an image — requires full PDF creation round-trip
using var pdfDoc = new PdfDocument();
var page = pdfDoc.Pages.Add();
var image = new PdfBitmap(imagePath);
page.Graphics.DrawImage(image, 0, 0, page.Size.Width, page.Size.Height);

using var stream = new MemoryStream();
pdfDoc.Save(stream);
stream.Position = 0;

using var loadedDoc = new PdfLoadedDocument(stream);
using var processor = new OCRProcessor(@"tessdata/");
processor.Settings.Language = Languages.English;
processor.PerformOCR(loadedDoc);

var text = new StringBuilder();
foreach (PdfLoadedPage p in loadedDoc.Pages)
    text.AppendLine(p.ExtractText());

return text.ToString();

Imports Syncfusion.Pdf
Imports Syncfusion.OCR
Imports System.IO
Imports System.Text

' Syncfusion: OCR an image — requires full PDF creation round-trip
Dim text As New StringBuilder()

Using pdfDoc As New PdfDocument()
    Dim page = pdfDoc.Pages.Add()
    Dim image As New PdfBitmap(imagePath)
    page.Graphics.DrawImage(image, 0, 0, page.Size.Width, page.Size.Height)

    Using stream As New MemoryStream()
        pdfDoc.Save(stream)
        stream.Position = 0

        Using loadedDoc As New PdfLoadedDocument(stream)
            Using processor As New OCRProcessor("tessdata/")
                processor.Settings.Language = Languages.English
                processor.PerformOCR(loadedDoc)

                For Each p As PdfLoadedPage In loadedDoc.Pages
                    text.AppendLine(p.ExtractText())
                Next
            End Using
        End Using
    End Using
End Using

Return text.ToString()

IronOCR Approach

IronOCR's preprocessing pipeline runs automatically on images before the OCR engine processes them. For standard documents, calling Read() is sufficient. For degraded scans, the preprocessing filters are chainable on the OcrInput object:

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

// Explicit preprocessing when needed
input.Deskew();
input.DeNoise();
input.Contrast();
input.Binarize();
input.EnhanceResolution(300);

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

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

// Explicit preprocessing when needed
input.Deskew();
input.DeNoise();
input.Contrast();
input.Binarize();
input.EnhanceResolution(300);

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

Imports IronOcr

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

    ' Explicit preprocessing when needed
    input.Deskew()
    input.DeNoise()
    input.Contrast()
    input.Binarize()
    input.EnhanceResolution(300)

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

Images and PDFs use the same API. The same Read() call handles both. There is no intermediate document creation, no tessdata path to configure, and no page iteration loop — just the result. See the image filters tutorial for a full treatment of available preprocessing operations, and the low quality scan example for real-world accuracy comparisons on degraded input.

Syncfusion Approach

The OCRProcessor constructor takes the tessdata path as its first argument. If the directory does not exist or the required .traineddata file is missing, the constructor throws immediately. Production deployments must validate this before the first OCR call:

// Syncfusion tessdata validation — production code needs this
private const string TessDataPath = @"tessdata/";

public bool ValidateTessdata()
{
    if (!Directory.Exists(TessDataPath))
        return false; // Application fails to OCR entirely

    var requiredLanguages = new[] { "eng", "fra", "deu" };
    foreach (var lang in requiredLanguages)
    {
        string filePath = Path.Combine(TessDataPath, $"{lang}.traineddata");
        if (!File.Exists(filePath))
            return false;
    }
    return true;
}

// Language configuration using bitwise flags
// Requires ALL flagged language files in tessdata folder
processor.Settings.Language = Languages.English | Languages.French;

// Syncfusion tessdata validation — production code needs this
private const string TessDataPath = @"tessdata/";

public bool ValidateTessdata()
{
    if (!Directory.Exists(TessDataPath))
        return false; // Application fails to OCR entirely

    var requiredLanguages = new[] { "eng", "fra", "deu" };
    foreach (var lang in requiredLanguages)
    {
        string filePath = Path.Combine(TessDataPath, $"{lang}.traineddata");
        if (!File.Exists(filePath))
            return false;
    }
    return true;
}

// Language configuration using bitwise flags
// Requires ALL flagged language files in tessdata folder
processor.Settings.Language = Languages.English | Languages.French;

Imports System.IO

' Syncfusion tessdata validation — production code needs this
Private Const TessDataPath As String = "tessdata/"

Public Function ValidateTessdata() As Boolean
    If Not Directory.Exists(TessDataPath) Then
        Return False ' Application fails to OCR entirely
    End If

    Dim requiredLanguages = New String() {"eng", "fra", "deu"}
    For Each lang In requiredLanguages
        Dim filePath As String = Path.Combine(TessDataPath, $"{lang}.traineddata")
        If Not File.Exists(filePath) Then
            Return False
        End If
    Next
    Return True
End Function

' Language configuration using bitwise flags
' Requires ALL flagged language files in tessdata folder
processor.Settings.Language = Languages.English Or Languages.French

Docker deployments must add tessdata to the image. A typical Dockerfile addition:

# tessdata must be baked into the container image
COPY tessdata/ /app/tessdata/
# eng.traineddata alone is 23-94MB depending on quality tier
# Five languages = 100-500MB added to every image layer

That overhead compounds: every image rebuild copies the tessdata files, every layer cache miss re-downloads them, and every deployment target needs the folder at the exact path the application expects.

IronOCR Approach

IronOCR's language packs install through NuGet. The package manager handles download, versioning, and updates. No folder management, no path configuration:

# Language packs install via NuGet — no manual downloads
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.ChineseSimplified

# Language packs install via NuGet — no manual downloads
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.ChineseSimplified

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);
ocr.AddSecondaryLanguage(OcrLanguage.English);

var result = ocr.Read("multilingual-document.pdf");

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);
ocr.AddSecondaryLanguage(OcrLanguage.English);

var result = ocr.Read("multilingual-document.pdf");

Imports IronOcr

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.French
ocr.AddSecondaryLanguage(OcrLanguage.German)
ocr.AddSecondaryLanguage(OcrLanguage.English)

Dim result = ocr.Read("multilingual-document.pdf")

Docker images do not need a tessdata layer. CI pipelines do not need tessdata download steps. Air-gapped environments can use a local NuGet feed rather than scripting binary file management. The Docker deployment guide and Linux deployment guide cover the specifics for each platform.

Syncfusion Approach

The community license requires all five of the following conditions simultaneously:

• Annual gross revenue below $1,000,000 USD (all sources including investment income)
• Five or fewer developers (full-time, part-time, and contractors who write code)
• Ten or fewer total employees (developers plus sales, marketing, and administrative staff)
• Lifetime outside funding below $3,000,000
• Not a government entity

Syncfusion reserves the right to audit compliance at any time. License registration looks straightforward:

// Syncfusion: suite-wide license — community license terms apply
// Revenue < $1M, developers <= 5, employees <= 10, funding < $3M
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-SYNCFUSION-KEY");

// Syncfusion: suite-wide license — community license terms apply
// Revenue < $1M, developers <= 5, employees <= 10, funding < $3M
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-SYNCFUSION-KEY");

' Syncfusion: suite-wide license — community license terms apply
' Revenue < $1M, developers <= 5, employees <= 10, funding < $3M
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-SYNCFUSION-KEY")

When any threshold is crossed — a contractor added to hit a deadline, a large contract that pushes revenue past $1M, a Series A round — the community license becomes invalid and the transition to commercial pricing is immediate. Retroactive compliance is required. The commercial rate is $995 per developer per year for the full Essential Studio suite; there is no OCR-only tier.

A five-developer team using Syncfusion OCR over three years at the base commercial rate pays substantially more in licensing for the same capability available from IronOCR Professional at a one-time $2,999. That difference buys access to over a thousand components that have nothing to do with text extraction from documents.

IronOCR Approach

IronOCR licensing is a per-developer or per-project perpetual purchase with no revenue restrictions, no employee count limits, and no audit provisions:

// IronOCR: no revenue restrictions, no employee count limits
// Perpetual license — use indefinitely after one-time purchase
IronOcr.License.LicenseKey = "YOUR-IRONOCR-KEY";

// IronOCR: no revenue restrictions, no employee count limits
// Perpetual license — use indefinitely after one-time purchase
IronOcr.License.LicenseKey = "YOUR-IRONOCR-KEY";

' IronOCR: no revenue restrictions, no employee count limits
' Perpetual license — use indefinitely after one-time purchase
IronOcr.License.LicenseKey = "YOUR-IRONOCR-KEY"

The Lite tier ($999 one-time, one developer) covers most individual project scenarios. Professional ($2,999 one-time, ten developers) is the direct comparison point to Syncfusion's per-developer annual model. Unlimited ($5,999 one-time) removes all developer and project count restrictions. A team that grows from five to fifteen developers does not trigger a licensing event.

Syncfusion Approach

Adding preprocessing to a Syncfusion OCR workflow requires a third-party imaging library, additional code, and additional deployment considerations. The pattern from the Syncfusion PDF extraction examples illustrates the gap:

// Syncfusion: manual preprocessing required using separate imaging library
// (System.Drawing, SkiaSharp, ImageSharp, etc. — not included in Syncfusion OCR)

// After external preprocessing, image must be embedded in PDF before OCR:
using var pdfDoc = new PdfDocument();
var page = pdfDoc.Pages.Add();
var processedImage = new PdfBitmap(processedImagePath); // result of external preprocessing
page.Graphics.DrawImage(processedImage, 0, 0, page.Size.Width, page.Size.Height);

using var stream = new MemoryStream();
pdfDoc.Save(stream);
stream.Position = 0;

using var loadedDoc = new PdfLoadedDocument(stream);
using var processor = new OCRProcessor(@"tessdata/");
processor.Settings.Language = Languages.English;
processor.PerformOCR(loadedDoc);

// Text extraction loop still required after preprocessing + OCR
var text = new StringBuilder();
foreach (PdfLoadedPage p in loadedDoc.Pages)
    text.AppendLine(p.ExtractText());

// Syncfusion: manual preprocessing required using separate imaging library
// (System.Drawing, SkiaSharp, ImageSharp, etc. — not included in Syncfusion OCR)

// After external preprocessing, image must be embedded in PDF before OCR:
using var pdfDoc = new PdfDocument();
var page = pdfDoc.Pages.Add();
var processedImage = new PdfBitmap(processedImagePath); // result of external preprocessing
page.Graphics.DrawImage(processedImage, 0, 0, page.Size.Width, page.Size.Height);

using var stream = new MemoryStream();
pdfDoc.Save(stream);
stream.Position = 0;

using var loadedDoc = new PdfLoadedDocument(stream);
using var processor = new OCRProcessor(@"tessdata/");
processor.Settings.Language = Languages.English;
processor.PerformOCR(loadedDoc);

// Text extraction loop still required after preprocessing + OCR
var text = new StringBuilder();
foreach (PdfLoadedPage p in loadedDoc.Pages)
    text.AppendLine(p.ExtractText());

Imports System.IO
Imports Syncfusion.Pdf
Imports Syncfusion.OCR

' Syncfusion: manual preprocessing required using separate imaging library
' (System.Drawing, SkiaSharp, ImageSharp, etc. — not included in Syncfusion OCR)

' After external preprocessing, image must be embedded in PDF before OCR:
Dim pdfDoc As New PdfDocument()
Dim page = pdfDoc.Pages.Add()
Dim processedImage As New PdfBitmap(processedImagePath) ' result of external preprocessing
page.Graphics.DrawImage(processedImage, 0, 0, page.Size.Width, page.Size.Height)

Using stream As New MemoryStream()
    pdfDoc.Save(stream)
    stream.Position = 0

    Using loadedDoc As New PdfLoadedDocument(stream)
        Using processor As New OCRProcessor("tessdata/")
            processor.Settings.Language = Languages.English
            processor.PerformOCR(loadedDoc)
        End Using

        ' Text extraction loop still required after preprocessing + OCR
        Dim text As New StringBuilder()
        For Each p As PdfLoadedPage In loadedDoc.Pages
            text.AppendLine(p.ExtractText())
        Next
    End Using
End Using

The result: a third-party imaging dependency, 20+ lines of boilerplate, and a PDF round-trip just to OCR one scanned image. The Syncfusion documentation suggests this pattern explicitly for any document quality below standard printed output.

IronOCR Approach

IronOCR's preprocessing features are part of the core package. Each filter is a method on OcrInput. Developers apply only what the document requires, or rely on automatic correction for standard cases:

using var input = new OcrInput();
input.LoadImage("rotated-noisy-scan.jpg");

// Preprocessing filters built into IronOCR
input.Deskew();                 // Correct rotation
input.DeNoise();                // Remove background noise
input.Contrast();               // Improve contrast
input.Binarize();               // Convert to black/white
input.EnhanceResolution(300);   // Scale to optimal DPI

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

using var input = new OcrInput();
input.LoadImage("rotated-noisy-scan.jpg");

// Preprocessing filters built into IronOCR
input.Deskew();                 // Correct rotation
input.DeNoise();                // Remove background noise
input.Contrast();               // Improve contrast
input.Binarize();               // Convert to black/white
input.EnhanceResolution(300);   // Scale to optimal DPI

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

Imports IronOcr

Using input As New OcrInput()
    input.LoadImage("rotated-noisy-scan.jpg")

    ' Preprocessing filters built into IronOCR
    input.Deskew()                 ' Correct rotation
    input.DeNoise()                ' Remove background noise
    input.Contrast()               ' Improve contrast
    input.Binarize()               ' Convert to black/white
    input.EnhanceResolution(300)   ' Scale to optimal DPI

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

No external imaging library. No PDF round-trip. The same OcrInput object that carries the preprocessing instructions also carries the file path — the two concerns travel together rather than requiring a separate pipeline stage. For production workflows with consistently degraded input, see the image orientation correction guide and image color correction guide for the full set of available filters.

When Community License Growth Triggers a Licensing Event

A startup uses the Syncfusion community license while building their first product. Revenue is $700K. The team is four developers. The product ships well, closes a large enterprise contract, and revenue crosses $1.2M partway through the year. The community license is now invalid. The company must immediately purchase commercial licenses for all developers. At $995 per developer per year, four developers cost $3,980 per year — unplanned, mid-year, and covering components the company never used. If the team was in the middle of a critical delivery cycle, that compliance event lands at the worst possible moment.

The deeper risk is structural. Any team using the community license and growing is building toward a forced license upgrade. The question is not whether the transition will happen but when. Teams that anticipate this and evaluate IronOCR's perpetual model before the threshold is hit save themselves the scramble.

When Image OCR Is a Primary Use Case

Many document processing workflows deal primarily with images: scanned invoices, photographed receipts, camera captures of forms. Syncfusion's architecture assumes PDF as the primary input format. Its processor does not accept images directly. Every image OCR workflow requires a full PDF round-trip — creating a document, embedding the image, saving to a stream, and reloading — before OCR can begin. On a high-volume pipeline processing thousands of invoice images per day, that round-trip adds measurable overhead in both execution time and code complexity.

Teams whose primary use case is image OCR — not PDF text layer extraction — are working against Syncfusion's architectural grain. IronOCR accepts image paths and PDFs with the same single-call API, making image-first workflows as straightforward as PDF-first ones.

When tessdata Deployment Complexity Exceeds the Value Proposition

DevOps engineers maintaining Syncfusion-based OCR applications in containerized environments spend meaningful time on tessdata: adding it to Dockerfiles, keeping it out of version control while ensuring it is available in CI, managing language file versions independently from application versions, and debugging tessdata directory not found errors in new environments. None of that work produces business value. It exists solely because Syncfusion does not bundle what IronOCR bundles.

When the tessdata management overhead becomes a recurring support cost — production incidents, failed deployments, new team members confused by the non-obvious setup requirement — teams begin to calculate whether the Syncfusion suite price is justified for a capability that a simpler tool delivers without the friction.

When Annual Renewal Is a Budget Planning Problem

Syncfusion requires annual renewal to maintain updates and support. A five-developer team paying $995 per developer per year commits to $4,975 annually for as long as the product is in service. A ten-year product costs $49,750 in Syncfusion licensing fees, entirely for OCR capability. IronOCR's perpetual license model means the initial purchase covers indefinite use; the optional annual renewal covers updates and new features, but the library continues to function without it. For finance teams planning multi-year software costs, perpetual licensing eliminates a recurring line item that compounds over time.

When Only OCR Is Needed

Syncfusion's value proposition makes sense when a team actively uses the suite across multiple components — grids, charts, PDF editing, and OCR together in the same product. For teams whose requirement is text extraction, the 1,599 unused components represent a cost with no return. The Essential Studio NuGet graph pulls in several transitive dependencies regardless of which features are used, adding meaningful weight to the build in both package restore time and deployment artifact size. IronOCR's focused scope means the dependency graph contains exactly what a text extraction workflow needs and nothing else.

Removing the tessdata Folder

The first concrete change when migrating is deleting the tessdata folder from the project. Any .csproj file that marks tessdata files as CopyToOutputDirectory = Always or CopyToOutputDirectory = PreserveNewest needs those entries removed. CI/CD pipelines that script tessdata downloads or copy tessdata from a shared location need those steps removed. Dockerfile layers that COPY tessdata/ /app/tessdata/ need to be deleted. Each removal is straightforward, but it is worth auditing all pipeline definitions before testing the migrated application to ensure no orphaned tessdata references remain.

Replacing the Two-Step OCR Pattern

Syncfusion's pattern of calling PerformOCR(document) followed by iterating page.ExtractText() does not have a direct IronOCR equivalent — because IronOCR combines both steps in a single Read() call. The migration for a basic PDF OCR method is a near-complete rewrite of the method body, but one that results in significantly fewer lines:

// Before (Syncfusion): ~15 lines including using statements
using var document = new PdfLoadedDocument(pdfPath);
using var processor = new OCRProcessor(@"tessdata/");
processor.Settings.Language = Languages.English;
processor.PerformOCR(document);
var text = new StringBuilder();
foreach (PdfLoadedPage page in document.Pages)
    text.AppendLine(page.ExtractText());
return text.ToString();

// After (IronOCR): 1 line
return new IronTesseract().Read(pdfPath).Text;

// Before (Syncfusion): ~15 lines including using statements
using var document = new PdfLoadedDocument(pdfPath);
using var processor = new OCRProcessor(@"tessdata/");
processor.Settings.Language = Languages.English;
processor.PerformOCR(document);
var text = new StringBuilder();
foreach (PdfLoadedPage page in document.Pages)
    text.AppendLine(page.ExtractText());
return text.ToString();

// After (IronOCR): 1 line
return new IronTesseract().Read(pdfPath).Text;

Imports Syncfusion.Pdf
Imports Syncfusion.OCR
Imports System.Text

' Before (Syncfusion): ~15 lines including using statements
Using document As New PdfLoadedDocument(pdfPath)
    Using processor As New OCRProcessor("tessdata/")
        processor.Settings.Language = Languages.English
        processor.PerformOCR(document)
        Dim text As New StringBuilder()
        For Each page As PdfLoadedPage In document.Pages
            text.AppendLine(page.ExtractText())
        Next
        Return text.ToString()
    End Using
End Using

' After (IronOCR): 1 line
Return New IronTesseract().Read(pdfPath).Text

For callers that need page-level results rather than concatenated text, result.Pages[] provides the same structure. The read results guide covers the full OcrResult object including words, lines, paragraphs, and coordinate data.

Converting Language Configuration

Syncfusion uses a Languages enum with bitwise flags to combine multiple languages: Languages.English | Languages.French. IronOCR uses a primary language plus additive secondary languages:

// Syncfusion (remove)
processor.Settings.Language = Languages.English | Languages.French | Languages.German;

// IronOCR (replace with)
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;
ocr.AddSecondaryLanguage(OcrLanguage.French);
ocr.AddSecondaryLanguage(OcrLanguage.German);

// Syncfusion (remove)
processor.Settings.Language = Languages.English | Languages.French | Languages.German;

// IronOCR (replace with)
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;
ocr.AddSecondaryLanguage(OcrLanguage.French);
ocr.AddSecondaryLanguage(OcrLanguage.German);

' Syncfusion (remove)
' processor.Settings.Language = Languages.English Or Languages.French Or Languages.German

' IronOCR (replace with)
Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.English
ocr.AddSecondaryLanguage(OcrLanguage.French)
ocr.AddSecondaryLanguage(OcrLanguage.German)

The OcrLanguage enum in IronOCR distinguishes between quality tiers (e.g., OcrLanguage.EnglishBest for the higher-accuracy LSTM model vs. OcrLanguage.English for the standard model). Choosing the appropriate tier depends on document quality and performance requirements.

Updating Error Handling

Syncfusion OCR codebases commonly contain tessdata validation checks (verifying directory existence, checking for specific .traineddata files) and community license compliance guards. All of these can be removed after migration. IronOCR does not throw tessdata-related exceptions because there is no tessdata to miss. Remaining error handling covers file not found, unsupported format, and license validation, which are identical in nature to any other .NET library:

// IronOCR error handling after migration
// No tessdata validation needed
// No community license compliance checks needed

try
{
    return new IronTesseract().Read(pdfPath).Text;
}
catch (FileNotFoundException ex)
{
    throw new ArgumentException($"PDF file not found: {pdfPath}", ex);
}

// IronOCR error handling after migration
// No tessdata validation needed
// No community license compliance checks needed

try
{
    return new IronTesseract().Read(pdfPath).Text;
}
catch (FileNotFoundException ex)
{
    throw new ArgumentException($"PDF file not found: {pdfPath}", ex);
}

Imports IronOcr

' IronOCR error handling after migration
' No tessdata validation needed
' No community license compliance checks needed

Try
    Return New IronTesseract().Read(pdfPath).Text
Catch ex As FileNotFoundException
    Throw New ArgumentException($"PDF file not found: {pdfPath}", ex)
End Try