MODI OCR C# vs. IronOCR: Wybór odpowiedniej biblioteki optycznego rozpoznawania znaków w C#

Inicjalizacja silnika i zależność od tessdata

Każde działanieTesseractOCRzaczyna się od inicjalizacji Engine, która wymaga folderu tessdata zawierającego pliki językowe .traineddata pobrane ręcznie z zewnętrznych repozytoriów:

// tessdata/eng.traineddata must exist before this line runs
// Downloaded separately: curl -L -o tessdata/eng.traineddata
//   https://github.com/tesseract-ocr/tessdata_best/raw/main/eng.traineddata
using var engine = new Engine(@"./tessdata", Language.English, EngineMode.Default);
using var image = TesseractOCR.Pix.Image.LoadFromFile("document.png");
using var page = engine.Process(image);

string text = page.Text;
float confidence = page.MeanConfidence; // Returns 0.0-1.0 float

// tessdata/eng.traineddata must exist before this line runs
// Downloaded separately: curl -L -o tessdata/eng.traineddata
//   https://github.com/tesseract-ocr/tessdata_best/raw/main/eng.traineddata
using var engine = new Engine(@"./tessdata", Language.English, EngineMode.Default);
using var image = TesseractOCR.Pix.Image.LoadFromFile("document.png");
using var page = engine.Process(image);

string text = page.Text;
float confidence = page.MeanConfidence; // Returns 0.0-1.0 float

Imports TesseractOCR

' tessdata/eng.traineddata must exist before this line runs
' Downloaded separately: curl -L -o tessdata/eng.traineddata
'   https://github.com/tesseract-ocr/tessdata_best/raw/main/eng.traineddata
Using engine As New Engine("./tessdata", Language.English, EngineMode.Default)
    Using image As Pix.Image = TesseractOCR.Pix.Image.LoadFromFile("document.png")
        Using page As Page = engine.Process(image)
            Dim text As String = page.Text
            Dim confidence As Single = page.MeanConfidence ' Returns 0.0-1.0 float
        End Using
    End Using
End Using

Konstruktor Engine akceptuje ścieżkę do katalogu tessdata i wartość enum Language. Jeśli katalog nie istnieje, brakuje pliku .traineddata lub wersja pliku nie pasuje do wersji silnika Tesseract, inicjalizacja zgłasza wyjątek. Są to trzy najczęstsze błędy produkcyjne występujące w każdej nakładce Tesseract, aTesseractOCRdziedziczy je wszystkie. W pliku README projektu znajduje się kod sprawdzający, czy folder tessdata i poszczególne pliki językowe są obecne przed próbą skompilowania silnika — co pokazuje, jak często programiści napotykają ten problem.

Szczegółowe porównanie funkcji

Podejście TesseractOCR

Plik basic-ocr.cs w tym repozytorium zawiera metodę ValidateTessData(), którą projekt zaleca uruchomić przed jakąkolwiek operacją OCR. Ten wzorzec obronny istnieje, ponieważ tryb awarii — wyjątek TesseractException rzucony w połowie procesu — jest na tyle powszechny, że przykłady biblioteki się przed tym zabezpieczają:

// From BasicOcrService in tesseractocr-basic-ocr.cs
private void ValidateTessData()
{
    if (!Directory.Exists(_tessDataPath))
    {
        throw new DirectoryNotFoundException(
            $"tessdata folder not found at: {_tessDataPath}\n" +
            "Download traineddata files from: https://github.com/tesseract-ocr/tessdata_best");
    }

    string engTrainedData = Path.Combine(_tessDataPath, "eng.traineddata");
    if (!File.Exists(engTrainedData))
    {
        throw new FileNotFoundException(
            $"eng.traineddata not found in {_tessDataPath}\n" +
            "Download from: https://github.com/tesseract-ocr/tessdata_best/raw/main/eng.traineddata");
    }
}

// From BasicOcrService in tesseractocr-basic-ocr.cs
private void ValidateTessData()
{
    if (!Directory.Exists(_tessDataPath))
    {
        throw new DirectoryNotFoundException(
            $"tessdata folder not found at: {_tessDataPath}\n" +
            "Download traineddata files from: https://github.com/tesseract-ocr/tessdata_best");
    }

    string engTrainedData = Path.Combine(_tessDataPath, "eng.traineddata");
    if (!File.Exists(engTrainedData))
    {
        throw new FileNotFoundException(
            $"eng.traineddata not found in {_tessDataPath}\n" +
            "Download from: https://github.com/tesseract-ocr/tessdata_best/raw/main/eng.traineddata");
    }
}

Private Sub ValidateTessData()
    If Not Directory.Exists(_tessDataPath) Then
        Throw New DirectoryNotFoundException(
            $"tessdata folder not found at: {_tessDataPath}" & vbCrLf &
            "Download traineddata files from: https://github.com/tesseract-ocr/tessdata_best")
    End If

    Dim engTrainedData As String = Path.Combine(_tessDataPath, "eng.traineddata")
    If Not File.Exists(engTrainedData) Then
        Throw New FileNotFoundException(
            $"eng.traineddata not found in {_tessDataPath}" & vbCrLf &
            "Download from: https://github.com/tesseract-ocr/tessdata_best/raw/main/eng.traineddata")
    End If
End Sub

Problem pogłębia wielojęzyczne OCR. Każdy język wymaga własnego pliku .traineddata — 15 do 50 MB na język — a pliki muszą pochodzić z poprawnej wersji repozytorium. Repozytorium tessdata_best zapewnia wyższą dokładność, ale wolniejsze przetwarzanie; tessdata_fast stawia szybkość ponad dokładnością. Mieszanie wersji lub używanie plików tessdata stworzonych dla Tesseract 4.x z silnikiem Tesseract 5.x powoduje ciche pogorszenie dokładności bez żadnego sygnału o błędzie.

W przypadku wdrożeń Docker pliki tessdata muszą być wbudowane w obraz lub zamontowane w znanej ścieżce. W przypadku potoków CI/CD etap pobierania musi być zautomatyzowany i buforowany. W przypadku środowisk odizolowanych pliki muszą zostać wcześniej przygotowane. Każda konfiguracja wdrożenia to kolejne miejsce, w którym może dojść do niepowodzenia.

// Multi-language requires each .traineddata file pre-downloaded
// eng.traineddata + fra.traineddata + deu.traineddata all required
using var engine = new Engine(@"./tessdata",
    Language.English | Language.French | Language.German,
    EngineMode.Default);

// If any traineddata file is missing, this throws at construction time
using var image = TesseractOCR.Pix.Image.LoadFromFile(imagePath);
using var page = engine.Process(image);

return page.Text;

// Multi-language requires each .traineddata file pre-downloaded
// eng.traineddata + fra.traineddata + deu.traineddata all required
using var engine = new Engine(@"./tessdata",
    Language.English | Language.French | Language.German,
    EngineMode.Default);

// If any traineddata file is missing, this throws at construction time
using var image = TesseractOCR.Pix.Image.LoadFromFile(imagePath);
using var page = engine.Process(image);

return page.Text;

Imports TesseractOCR

' Multi-language requires each .traineddata file pre-downloaded
' eng.traineddata + fra.traineddata + deu.traineddata all required
Using engine As New Engine("./tessdata", Language.English Or Language.French Or Language.German, EngineMode.Default)

    ' If any traineddata file is missing, this throws at construction time
    Using image As TesseractOCR.Pix.Image = TesseractOCR.Pix.Image.LoadFromFile(imagePath)
        Using page As Page = engine.Process(image)
            Return page.Text
        End Using
    End Using
End Using

Podejście IronOCR

IronOCR udostępnia obsługę języków w postaci pakietów NuGet. Wersja angielska jest dołączona do pakietu podstawowego. Dodatkowe języki instaluje się za pomocą jednego polecenia i nie wymagają one konfiguracji ścieżki:

// dotnet add package IronOcr.Languages.French
// dotnet add package IronOcr.Languages.German
// Nie tessdata folder, no download scripts, no path validation

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

using var input = new OcrInput();
input.LoadImage(imagePath);
var result = ocr.Read(input);

return result.Text;

// dotnet add package IronOcr.Languages.French
// dotnet add package IronOcr.Languages.German
// Nie tessdata folder, no download scripts, no path validation

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

using var input = new OcrInput();
input.LoadImage(imagePath);
var result = ocr.Read(input);

return result.Text;

Imports IronOcr

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

Using input As New OcrInput()
    input.LoadImage(imagePath)
    Dim result = ocr.Read(input)
    Return result.Text
End Using

Pakiet językowy jest zależnością NuGet, posiada wersję, jest przywracany automatycznie i wdrażany wraz z plikiem binarnym aplikacji. Brak zewnętrznych repozytoriów GitHub, brak skryptów curl, brak konfiguracji systemu kompilacji do kopiowania plików do katalogu wyjściowego. W przypadku wdrożeń typu air-gapped pakiet NuGet można przywrócić w trybie offline z prywatnego źródła w taki sam sposób, jak każdy inny pakiet. Przewodnik po wielu językach obejmuje konfigurację dla wszystkich ponad 125 obsługiwanych języków.

Podejście TesseractOCR

Plik migration-comparison.cs w tym repozytorium przedstawia wzorzec przetwarzania wstępnego wymagany przez TesseractOCR. Zewnętrzna biblioteka obrazowania (w tym przypadku SixLabors.ImageSharp) musi zostać dodana, parametry filtrów muszą być dostosowane ręcznie, a wstępnie przetworzony obraz musi zostać zapisany do pliku tymczasowego zanimTesseractOCRbędzie mógł go odczytać — ponieważ API TesseractOCR.Pix.Image oczekuje ścieżki pliku:

// Requires: dotnet add package SixLabors.ImageSharp
// Manual preprocessing — each parameter requires tuning per document type

using var image = Image.Load(imagePath);

image.Mutate(x => x.Grayscale());
image.Mutate(x => x.Contrast(1.5f));         // 1.5 is a guess; tune per use case
image.Mutate(x => x.GaussianBlur(0.5f));     // Denoise with blur
image.Mutate(x => x.BinaryThreshold(0.5f)); // Threshold requires manual tuning

// Deskew is NOT in ImageSharp — requires separate Hough transform implementation
// (~50-100 additional lines)

string tempPath = Path.GetTempFileName() + ".png";
try
{
    image.Save(tempPath);

    using var engine = new Engine(@"./tessdata", Language.English);
    using var pixImage = TesseractOCR.Pix.Image.LoadFromFile(tempPath);
    using var page = engine.Process(pixImage);

    return page.Text;
}
finally
{
    File.Delete(tempPath); // Clean up temp file
}

// Requires: dotnet add package SixLabors.ImageSharp
// Manual preprocessing — each parameter requires tuning per document type

using var image = Image.Load(imagePath);

image.Mutate(x => x.Grayscale());
image.Mutate(x => x.Contrast(1.5f));         // 1.5 is a guess; tune per use case
image.Mutate(x => x.GaussianBlur(0.5f));     // Denoise with blur
image.Mutate(x => x.BinaryThreshold(0.5f)); // Threshold requires manual tuning

// Deskew is NOT in ImageSharp — requires separate Hough transform implementation
// (~50-100 additional lines)

string tempPath = Path.GetTempFileName() + ".png";
try
{
    image.Save(tempPath);

    using var engine = new Engine(@"./tessdata", Language.English);
    using var pixImage = TesseractOCR.Pix.Image.LoadFromFile(tempPath);
    using var page = engine.Process(pixImage);

    return page.Text;
}
finally
{
    File.Delete(tempPath); // Clean up temp file
}

Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.Processing
Imports TesseractOCR
Imports System.IO

' Requires: dotnet add package SixLabors.ImageSharp
' Manual preprocessing — each parameter requires tuning per document type

Dim image As Image = Image.Load(imagePath)

image.Mutate(Sub(x) x.Grayscale())
image.Mutate(Sub(x) x.Contrast(1.5F))         ' 1.5 is a guess; tune per use case
image.Mutate(Sub(x) x.GaussianBlur(0.5F))     ' Denoise with blur
image.Mutate(Sub(x) x.BinaryThreshold(0.5F))  ' Threshold requires manual tuning

' Deskew is NOT in ImageSharp — requires separate Hough transform implementation
' (~50-100 additional lines)

Dim tempPath As String = Path.GetTempFileName() & ".png"
Try
    image.Save(tempPath)

    Using engine As New Engine("./tessdata", Language.English)
        Using pixImage As TesseractOCR.Pix.Image = TesseractOCR.Pix.Image.LoadFromFile(tempPath)
            Using page As Page = engine.Process(pixImage)
                Return page.Text
            End Using
        End Using
    End Using
Finally
    File.Delete(tempPath) ' Clean up temp file
End Try

Plik README dlaTesseractOCRwymienia spadki dokładności w przypadku niedoskonałych danych wejściowych: 5-stopniowe przekrzywienie powoduje spadek dokładności z 97% do 65–75%; jakość zdjęć zrobionych aparatem w telefonie spada do 30–50%. Nie są to skrajne przypadki w produkcji — jest to domyślny stan skanowanych dokumentów, zdjęć tablic i faksów. Odzyskanie tej dokładności wymaga korekcji zniekształceń, redukcji szumów i normalizacji kontrastu. Sama funkcja Deskew nie jest dostępna w popularnych bibliotekach obrazówania .NET i wymaga wdrożenia algorytmu wykrywania kąta transformacji Hougha.

Podejście IronOCR

Pipeline przetwarzania wstępnego IronOCR jest wbudowany w OcrInput. Wywołanie Deskew(), DeNoise(), Contrast() i EnhanceResolution() stosuje odpowiednie algorytmy bez zewnętrznych bibliotek, bez plików tymczasowych i bez dostrajania parametrów dla typowych rodzajów dokumentów:

// Nie external imaging library needed
// Nie temp files, no manual parameter tuning

using var input = new OcrInput();
input.LoadImage(imagePath);
input.Deskew();           // Automatic angle detection and correction
input.DeNoise();          // Intelligent noise removal
input.Contrast();         // Automatyczny kontrast enhancement
input.EnhanceResolution(300); // Upscale if below 300 DPI

var result = new IronTesseract().Read(input);

return result.Text;

// Nie external imaging library needed
// Nie temp files, no manual parameter tuning

using var input = new OcrInput();
input.LoadImage(imagePath);
input.Deskew();           // Automatic angle detection and correction
input.DeNoise();          // Intelligent noise removal
input.Contrast();         // Automatyczny kontrast enhancement
input.EnhanceResolution(300); // Upscale if below 300 DPI

var result = new IronTesseract().Read(input);

return result.Text;

Imports IronOcr

Using input As New OcrInput()
    input.LoadImage(imagePath)
    input.Deskew()           ' Automatic angle detection and correction
    input.DeNoise()          ' Intelligent noise removal
    input.Contrast()         ' Automatyczny kontrast enhancement
    input.EnhanceResolution(300) ' Upscale if below 300 DPI

    Dim result = New IronTesseract().Read(input)

    Return result.Text
End Using

W przypadku dokumentów, w których problemy z jakością nie są znane z góry, silnik automatycznie stosuje poprawki bazowe bez wyraźnych wywołań filtrów. Przewodnik po korekcji jakości obrazu obejmuje każdy filtr wraz z opcjami parametrów dla przypadków, w których zachowanie automatyczne wymaga dostosowania. Przewodnik dotyczący korekcji orientacji obrazu obejmuje w szczególności wykrywanie przekrzywienia i obrotu — operacje, które wymagałyby niestandardowej implementacji przy użyciu TesseractOCR. Przykład skanu o niskiej jakości pokazuje różnicę w dokładności w przypadku trudnych dokumentów.

Podejście TesseractOCR

Plik tesseractocr-pdf-processing.cs w tym repozytorium implementuje kompletną usługę OCR dla plików PDF. Wymaga on Docnet.Core jako dodatkowej zależności oraz około 100 linii kodu, aby wykonać to, co IronOCR osiąga w trzech. Podstawowa pętla ekstrakcji obejmuje ładowanie PDF za pomocą Docnet, renderowanie każdej strony do tablic bajtów BGRA, zapisywanie każdej strony do pliku tymczasowego (ponieważ TesseractOCR.Pix.Image.LoadFromFile wymaga ścieżki pliku, a nie tablicy bajtów), przetwarzanie OCR pliku tymczasowego, dodawanie do StringBuilder i usuwanie plików tymczasowych w bloku finally.

// Requires: dotnet add package TesseractOCR
//           dotnet add package Docnet.Core
// Note: Docnet is MIT-licensed; iTextSharp would be AGPL

using var library = DocLib.Instance;
using var docReader = library.GetDocReader(pdfPath, new PageDimensions(dpi, dpi));

int pageCount = docReader.GetPageCount();
var allText = new StringBuilder();
var tempFiles = new List<string>();

try
{
    using var engine = new Engine(_tessDataPath, Language.English, EngineMode.Default);

    for (int pageIndex = 0; pageIndex < pageCount; pageIndex++)
    {
        using var pageReader = docReader.GetPageReader(pageIndex);
        var width = pageReader.GetPageWidth();
        var height = pageReader.GetPageHeight();
        var imageBytes = pageReader.GetImage(); // BGRA bytes

        // TesseractOCR.Pix.Image requires a file path — write to temp
        string tempPath = Path.Combine(_tempDirectory, $"page_{pageIndex}_{Guid.NewGuid()}.png");
        tempFiles.Add(tempPath);
        SaveBgraAsPng(imageBytes, width, height, tempPath); // ~30 lines

        using var image = TesseractOCR.Pix.Image.LoadFromFile(tempPath);
        using var page = engine.Process(image);

        allText.AppendLine($"--- Page {pageIndex + 1} ---");
        allText.AppendLine(page.Text);
    }
}
finally
{
    foreach (var tempFile in tempFiles)
    {
        try { File.Delete(tempFile); } catch { }
    }
}

// Requires: dotnet add package TesseractOCR
//           dotnet add package Docnet.Core
// Note: Docnet is MIT-licensed; iTextSharp would be AGPL

using var library = DocLib.Instance;
using var docReader = library.GetDocReader(pdfPath, new PageDimensions(dpi, dpi));

int pageCount = docReader.GetPageCount();
var allText = new StringBuilder();
var tempFiles = new List<string>();

try
{
    using var engine = new Engine(_tessDataPath, Language.English, EngineMode.Default);

    for (int pageIndex = 0; pageIndex < pageCount; pageIndex++)
    {
        using var pageReader = docReader.GetPageReader(pageIndex);
        var width = pageReader.GetPageWidth();
        var height = pageReader.GetPageHeight();
        var imageBytes = pageReader.GetImage(); // BGRA bytes

        // TesseractOCR.Pix.Image requires a file path — write to temp
        string tempPath = Path.Combine(_tempDirectory, $"page_{pageIndex}_{Guid.NewGuid()}.png");
        tempFiles.Add(tempPath);
        SaveBgraAsPng(imageBytes, width, height, tempPath); // ~30 lines

        using var image = TesseractOCR.Pix.Image.LoadFromFile(tempPath);
        using var page = engine.Process(image);

        allText.AppendLine($"--- Page {pageIndex + 1} ---");
        allText.AppendLine(page.Text);
    }
}
finally
{
    foreach (var tempFile in tempFiles)
    {
        try { File.Delete(tempFile); } catch { }
    }
}

Imports Docnet.Core
Imports TesseractOCR
Imports System.IO
Imports System.Text

' Requires: dotnet add package TesseractOCR
'           dotnet add package Docnet.Core
' Note: Docnet is MIT-licensed; iTextSharp would be AGPL

Dim library = DocLib.Instance
Dim docReader = library.GetDocReader(pdfPath, New PageDimensions(dpi, dpi))

Dim pageCount As Integer = docReader.GetPageCount()
Dim allText As New StringBuilder()
Dim tempFiles As New List(Of String)()

Try
    Using engine As New Engine(_tessDataPath, Language.English, EngineMode.Default)
        For pageIndex As Integer = 0 To pageCount - 1
            Using pageReader = docReader.GetPageReader(pageIndex)
                Dim width = pageReader.GetPageWidth()
                Dim height = pageReader.GetPageHeight()
                Dim imageBytes = pageReader.GetImage() ' BGRA bytes

                ' TesseractOCR.Pix.Image requires a file path — write to temp
                Dim tempPath As String = Path.Combine(_tempDirectory, $"page_{pageIndex}_{Guid.NewGuid()}.png")
                tempFiles.Add(tempPath)
                SaveBgraAsPng(imageBytes, width, height, tempPath) ' ~30 lines

                Using image = TesseractOCR.Pix.Image.LoadFromFile(tempPath)
                    Using page = engine.Process(image)
                        allText.AppendLine($"--- Page {pageIndex + 1} ---")
                        allText.AppendLine(page.Text)
                    End Using
                End Using
            End Using
        Next
    End Using
Finally
    For Each tempFile In tempFiles
        Try
            File.Delete(tempFile)
        Catch
        End Try
    Next
End Try

PDFy chronione haslem wymagaja trzeciej biblioteki (iText z licencjonowaniem AGPL lub PDFSharp) do odszyfrowania dokumentu wczesniej, co dodaje kolejne zaleznosc i kolejny problem z licencjonowaniem do przeanalizowania. Komentarz w pliku tesseractocr-pdf-processing.cs na ten temat jest bezpośredni: "TesseractOCR + Docnet nie obsługują bezpośrednio plików PDF chronionych hasłem". Musisz: 1. Użyć biblioteki PDF obsługującej deszyfrowanie... 2. Najpierw odszyfruj/usuń hasło... 3. Zapisz odszyfrowany plik PDF... 4. Następnie przetwórz za pomocą powyższego kodu.

Podejście IronOCR

Obsługa plików PDF w IronOCR jest natywna. Bez zewnętrznych bibliotek, bez plików tymczasowych, bez konwersji formatów bajtowych. Przewodnik dotyczący plików PDF obejmuje wszystkie scenariusze związane z plikami PDF — pełne dokumenty, zakresy stron oraz pliki chronione hasłem:

// Pełna PDF — native, no external library
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadPdf(pdfPath);
var result = ocr.Read(input);
string text = result.Text;

// Plik PDF chroniony hasłem — built-in, one parameter
using var encryptedInput = new OcrInput();
encryptedInput.LoadPdf("encrypted.pdf", Password: "secret");
var encryptedResult = ocr.Read(encryptedInput);

// Specific page range — no manual loop required
using var pageInput = new OcrInput();
pageInput.LoadPdfPages(pdfPath, startPage: 1, endPage: 5);
var pageResult = ocr.Read(pageInput);

// Pełna PDF — native, no external library
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadPdf(pdfPath);
var result = ocr.Read(input);
string text = result.Text;

// Plik PDF chroniony hasłem — built-in, one parameter
using var encryptedInput = new OcrInput();
encryptedInput.LoadPdf("encrypted.pdf", Password: "secret");
var encryptedResult = ocr.Read(encryptedInput);

// Specific page range — no manual loop required
using var pageInput = new OcrInput();
pageInput.LoadPdfPages(pdfPath, startPage: 1, endPage: 5);
var pageResult = ocr.Read(pageInput);

Imports IronTesseract

' Pełna PDF — native, no external library
Dim ocr As New IronTesseract()
Using input As New OcrInput()
    input.LoadPdf(pdfPath)
    Dim result = ocr.Read(input)
    Dim text As String = result.Text
End Using

' Plik PDF chroniony hasłem — built-in, one parameter
Using encryptedInput As New OcrInput()
    encryptedInput.LoadPdf("encrypted.pdf", Password:="secret")
    Dim encryptedResult = ocr.Read(encryptedInput)
End Using

' Specific page range — no manual loop required
Using pageInput As New OcrInput()
    pageInput.LoadPdfPages(pdfPath, startPage:=1, endPage:=5)
    Dim pageResult = ocr.Read(pageInput)
End Using

Skanowane pliki PDF — scenariusz, w którym połączenie Docnet + przetwarzanie wstępne + OCR wTesseractOCRjest najbardziej uciążliwe — to także scenariusz, w którym pipeline przetwarzania wstępnego IronOCR ma największe znaczenie. Skanowany PDF przechodzi przez LoadPdf(), automatyczne przetwarzanie wstępne, OCR i opcjonalne wyjście PDF z możliwością przeszukiwania w łańcuchu liniowym bez zarządzania plikami tymczasowymi. Przykład PDF OCR i przewodnik po PDF z możliwością przeszukiwania obejmują cały przepływ pracy zawierający result.SaveAsSearchablePdf(), na który nie ma odpowiednika w TesseractOCR.

Podejście TesseractOCR

Przetwarzanie równoległe zTesseractOCRwymaga utworzenia nowego Engine wewnątrz każdej lambdy pracownika:

// WARNING: Engine is NOT thread-safe — must create per thread
// Memory: _maxDegreeOfParallelism * engine footprint (~40-100MB each)

var results = new ConcurrentDictionary<string, string>();

Parallel.ForEach(
    imagePaths,
    new ParallelOptions { MaxDegreeOfParallelism = 4 },
    imagePath =>
    {
        // Per-thread engine — required, expensive (~500ms init, ~50MB memory)
        using var engine = new Engine(@"./tessdata", Language.English, EngineMode.Default);
        using var image = TesseractOCR.Pix.Image.LoadFromFile(imagePath);
        using var page = engine.Process(image);

        results[imagePath] = page.Text;
    });

// WARNING: Engine is NOT thread-safe — must create per thread
// Memory: _maxDegreeOfParallelism * engine footprint (~40-100MB each)

var results = new ConcurrentDictionary<string, string>();

Parallel.ForEach(
    imagePaths,
    new ParallelOptions { MaxDegreeOfParallelism = 4 },
    imagePath =>
    {
        // Per-thread engine — required, expensive (~500ms init, ~50MB memory)
        using var engine = new Engine(@"./tessdata", Language.English, EngineMode.Default);
        using var image = TesseractOCR.Pix.Image.LoadFromFile(imagePath);
        using var page = engine.Process(image);

        results[imagePath] = page.Text;
    });

Imports System.Collections.Concurrent
Imports System.Threading.Tasks

' WARNING: Engine is NOT thread-safe — must create per thread
' Memory: _maxDegreeOfParallelism * engine footprint (~40-100MB each)

Dim results As New ConcurrentDictionary(Of String, String)()

Parallel.ForEach(
    imagePaths,
    New ParallelOptions With {.MaxDegreeOfParallelism = 4},
    Sub(imagePath)
        ' Per-thread engine — required, expensive (~500ms init, ~50MB memory)
        Using engine As New Engine("./tessdata", Language.English, EngineMode.Default)
            Using image As TesseractOCR.Pix.Image = TesseractOCR.Pix.Image.LoadFromFile(imagePath)
                Using page As Page = engine.Process(image)
                    results(imagePath) = page.Text
                End Using
            End Using
        End Using
    End Sub)

Wzorzec ponownego wykorzystania pojedynczego silnika (tworzenie jednego silnika poza pętlą i ponowne wykorzystywanie go sekwencyjnie) działa w przypadku przetwarzania szeregowego, ale zawodzi, jeśli jakikolwiek inny wątek dotknie instancji. Przetwarzanie wsadowe pod obciążeniem wymaga zatem albo zaakceptowania kosztu pamięci silników na wątek, albo wdrożenia puli silników lokalnych dla wątków z ostrożnym zarządzaniem cyklem życia.

Podejście IronOCR

IronTesseract jest odporny na wielowątkowość. Jeden egzemplarz przetwarza żądania z dowolnej liczby współbieżnych wątków:

// Single instance — thread-safe, no per-thread duplication
var ocr = new IronTesseract();

var results = new ConcurrentDictionary<string, string>();

Parallel.ForEach(imagePaths, imagePath =>
{
    using var input = new OcrInput(imagePath);
    results[imagePath] = ocr.Read(input).Text;
});

// Single instance — thread-safe, no per-thread duplication
var ocr = new IronTesseract();

var results = new ConcurrentDictionary<string, string>();

Parallel.ForEach(imagePaths, imagePath =>
{
    using var input = new OcrInput(imagePath);
    results[imagePath] = ocr.Read(input).Text;
});

Imports System.Collections.Concurrent
Imports System.Threading.Tasks

' Single instance — thread-safe, no per-thread duplication
Dim ocr As New IronTesseract()

Dim results As New ConcurrentDictionary(Of String, String)()

Parallel.ForEach(imagePaths, Sub(imagePath)
    Using input As New OcrInput(imagePath)
        results(imagePath) = ocr.Read(input).Text
    End Using
End Sub)

Przykład wielowątkowości ilustruje ten wzorzec. Zajmowana pamięć dla 4 równoległych procesów to jedna instancja silnika zamiast czterech. W przypadku potoków przetwarzania dokumentów w partiach, gdzie liczy się przepustowość, jest to istotna różnica.

Jakość dokumentów jest zróżnicowana

Integracja zTesseractOCRdziała bez zarzutu na skanach o wysokiej jakości 300 DPI. W momencie, gdy jakość dokumentów spada — przekrzywione strony ze skanera płaskiego, faksy o niskim kontraście, zdjęcia paragonów zrobione telefonem — pojawia się luka w dokładności. Własny test porównawczy README pokazuje, że bez wstępnego przetwarzania dokładność zdjęć zrobionych aparatem w telefonie spada do 30–50%. Zbudowanie i dostrojenie potoku przetwarzania wstępnego w ImageSharp lub SkiaSharp w celu odzyskania tej dokładności zajmuje 8–20 godzin pracy programistycznej i wprowadza dodatkową zależność. Zespoły, które sześć miesięcy po początkowej integracji odkrywają, że ich założenie dotyczące "wysokiej jakości skanowania" było błędne, stanowią typowy przypadek migracji z TesseractOCR. Luka w przetwarzaniu wstępnym nie jest problemem konfiguracyjnym, który można rozwiązać raz na zawsze — pojawia się za każdym razem, gdy do procesu trafia nowy typ dokumentu lub metoda przechwytywania.

Dokumenty PDF są częścią procesu wprowadzania danych

Połączenie Docnet.Core +TesseractOCRdo OCR plików PDF działa, ale zastąpienie 3 linii kodu wymaga napisania około 100 linii. Z praktycznego punktu widzenia wymaga to oceny licencji Docnet (MIT), jego działania na różnych platformach, obsługi nieprawidłowo sformatowanych plików PDF oraz interakcji z istniejącym kodem tessdata i kodem przetwarzania wstępnego. Zespoły tworzące systemy zarządzania dokumentami, programy do przetwarzania faktur lub dowolne procesy, w których pliki PDF stanowią główny wkład, zauważają, że podejście oparte na zewnętrznej bibliotece PDF z czasem powoduje coraz więcej utrudnień: obsługa wymiarów stron, wybór DPI do renderowania, logika czyszczenia plików tymczasowych oraz całkowity brak możliwości wyszukiwania w plikach PDF. Zespół, który musi tworzyć pliki PDF z możliwością wyszukiwania na podstawie zeskanowanych danych, nie ma szans na osiągnięcie tego celu, korzystając wyłącznie z TesseractOCR.

Architektura wątków osiąga limity pamięci

Cztery równoległe procesy OCR wTesseractOCRzużywają 200–400 MB pamięci silnika, zanim przetworzony zostanie choćby jeden obraz. Nie stanowi to problemu dla zadania działającego w tle o niskiej przepustowości. Stanowi to problem dla punktu końcowego .NET Core obsługującego wiele jednoczesnych przesyłek dokumentów lub procesora wsadowego zwiększającego przepustowość. Wzorzec silnika oparty na wątkach oznacza również, że każdy nowy wątek ponosi koszt inicjalizacji wynoszący około 500 ms przed przetworzeniem pierwszego dokumentu. Zespoły, które wybrałyTesseractOCRjako usługę działającą w tle, a następnie musiały zwiększyć przepustowość, napotykają ten limit. Przejście na silnik bezpieczny dla wątków całkowicie eliminuje obciążenie związane z każdym wątkiem.

Zmiany w środowisku wdrożeniowym po zakończeniu wstępnego etapu rozwoju

TesseractOCR wymaga plików tessdata wdrożonych razem z aplikacją. W lokalnym środowisku programisty jest to wykonalne. W kontenerze Docker oznacza to albo wbudowanie plików tessdata w obraz (co zwiększa rozmiar obrazu o 15–50 MB na język), albo zamontowanie woluminu w znanej ścieżce (co zwiększa złożoność operacyjną). W potoku CI/CD oznacza to tworzenie skryptów i buforowanie pobranych plików. W usłudze Azure App Service lub AWS Lambda konfiguracja ścieżki tessdata jest kolejnym ustawieniem specyficznym dla środowiska, które może różnić się od konfiguracji używanej podczas programowania. Zespoły, które zaczynają od lokalnej weryfikacji koncepcji, a następnie przechodzą do wdrożenia w kontenerach lub w chmurze, odkrywają, że wymagania dotyczące danych tessdata zachowują się inaczej w każdym środowisku. Pakiety językowe IronOCR oparte na NuGet są wdrażane identycznie wszędzie tam, gdzie pakiet jest przywracany.

Wsparcie społeczności osiąga granicę rozgałęzienia

TesseractOCR ma około 200 tys. pobrań z NuGet. charlesw/tesseract ma około 8 mln. Pytania na Stack Overflow, posty na blogach i problemy na GitHub dotyczące wrapperów Tesseract .NET przytłaczająco odwołują się do API charlesw — TesseractEngine, a nie Engine; Pix.LoadFromFile, a nie TesseractOCR.Pix.Image.LoadFromFile. Rozwiązania, które sprawdzają się w przypadku charlesw, wymagają dostosowania do różnic w API TesseractOCR. Dla zespołów, których głównym modelem wsparcia są zasoby społecznościowe, jest to prawdziwy czynnik zwiększający tarcie.

Zastąpienie przestrzeni nazw i klas

Podstawowa substytucja to Engine do IronTesseract i TesseractOCR.Pix.Image.LoadFromFile() do OcrInput. Zamiana przestrzeni nazw (using TesseractOCR do using IronOcr) obejmuje większość odniesień. GdzieTesseractOCRużywa Language.English |Language.French (bitwise OR on a flags enum),IronOCR uses OcrLanguage.English + OcrLanguage.French (operacja dodawania). Skala zaufania różni się również:TesseractOCRzwraca page.MeanConfidence jako float od 0.0 do 1.0;IronOCR zwraca result.Confidence jako double od 0 do 100. Wszelkie logiki progowe porównujące wartości pewności wymagają aktualizacji.

// Before (TesseractOCR)
using var engine = new Engine(@"./tessdata", Language.English, EngineMode.Default);
using var image = TesseractOCR.Pix.Image.LoadFromFile("document.png");
using var page = engine.Process(image);
float confidence = page.MeanConfidence; // 0.0 to 1.0

// After (IronOCR)
var ocr = new IronTesseract();
using var input = new OcrInput("document.png");
var result = ocr.Read(input);
double confidence = result.Confidence; // 0 to 100

// Before (TesseractOCR)
using var engine = new Engine(@"./tessdata", Language.English, EngineMode.Default);
using var image = TesseractOCR.Pix.Image.LoadFromFile("document.png");
using var page = engine.Process(image);
float confidence = page.MeanConfidence; // 0.0 to 1.0

// After (IronOCR)
var ocr = new IronTesseract();
using var input = new OcrInput("document.png");
var result = ocr.Read(input);
double confidence = result.Confidence; // 0 to 100

Imports TesseractOCR
Imports IronOcr

' Before (TesseractOCR)
Using engine As New Engine("./tessdata", Language.English, EngineMode.Default)
    Using image As TesseractOCR.Pix.Image = TesseractOCR.Pix.Image.LoadFromFile("document.png")
        Using page As Page = engine.Process(image)
            Dim confidence As Single = page.MeanConfidence ' 0.0 to 1.0
        End Using
    End Using
End Using

' After (IronOCR)
Dim ocr As New IronTesseract()
Using input As New OcrInput("document.png")
    Dim result As OcrResult = ocr.Read(input)
    Dim confidence As Double = result.Confidence ' 0 to 100
End Using

Usuń zależności związane z przetwarzaniem wstępnym

Jeśli istniejąca integracjaTesseractOCRposiada już potok przetwarzania wstępnego ImageSharp lub SkiaSharp, kod ten można usunąć po migracji. Wbudowane metody IronOCRDeskew(), DeNoise(), Contrast() i EnhanceResolution() zastępują zewnętrzny łańcuch filtrów. Kod tworzenia i czyszczenia plików tymczasowych wokół wstępnie przetworzonego obrazu również zanika — OcrInput akceptuje ścieżkę pliku, tablicę bajtów, strumień lub Bitmap bezpośrednio bez pisania do pliku pośredniego. Przykład filtrów obrazów obejmuje dostępne filtry i ich odpowiedniki.

Usuń bibliotekę zewnętrzną PDF

Zespoły korzystające z Docnet.Core lub PdfiumViewer do renderowania plików PDF mogą całkowicie usunąć te pakiety. Zastąp całą pętlę renderowania PDF — DocLib.Instance, GetDocReader, GetPageReader, GetImage, SaveBgraAsPng, tworzenie pliku tymczasowego, Pix.Image.LoadFromFile, engine.Process — przez input.LoadPdf(pdfPath). Przewodnik po formatach wejściowych PDF oraz strona poświęcona zastosowaniom OCR w plikach PDF obejmują pełny zakres interfejsu API IronOCR PDF. Usuń folder tessdata z projektu, usuń konfigurację build <CopyToOutputDirectory> dla plików tessdata i aktualizuj obrazy Docker, aby usunąć wszelkie kroki apt-get install tesseract-ocr.

Obszar obsługi błędów ulega zmniejszeniu

TesseractOCR wymaga łapania TesseractOCR.Exceptions.TesseractException dla awarii inicjalizacji silnika, DllNotFoundException dla brakujących bibliotek natywnych i BadImageFormatException dla niezgodności architektury.IronOCRłączy swoje natywne zależności i zarządza inicjalizacją wewnętrznie, więc te typy wyjątków nie mają zastosowania. Pozostała powierzchnia błędów to standard IOException dla problemów z dostępem do plików i IronOcr.Exceptions.OcrException dla specyficznych awarii OCR.