Tesseract C# vs IronOCR: Hangi OCR Kütüphanesini .NET'te Kullanmalısınız?

Pratikte Miras Kalan .NET Framework Hedefleme

.NET Framework 4.5 üzerindeki sert sınır sadece bir onay kutusu değildir — aşağıya doğru her mimari kararı şekillendirir. Tesseract.Net.SDK'a bağlı bir proje, .csproj'ında <TargetFramework>net8.0</TargetFramework>'yi hedefleyemez. mcr.microsoft.com/dotnet/sdk:8.0 kullanılarak bir GitHub Actions koşucusu tarafından inşa edilemez. Bir Linux konteyneri çalıştıran bir Kubernetes pod'una dağıtılamaz. Kurumun geri kalanı o hattı aşar hareket ederken, OCR servisi bir yetim olur.

SDK'nın kendi başlatım kodu bunu doğrudan açığa çıkarır. tesseract-net-sdk-basic-ocr.cs içindeki temel kullanım deseni, açık bir Windows platformu koruması içerir:

// Install: Install-Package Tesseract.Net.SDK
// Platform: Windows ONLY (.NET Framework 2.0-4.5)
using Patagames.Ocr;

public string ExtractTextSimple(string imagePath)
{
    // Platform check — Tesseract.Net.SDK is Windows-only
    if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
    {
        throw new PlatformNotSupportedException(
            "Tesseract.Net.SDK only supports Windows.");
    }

    // Verify tessdata exists
    if (!Directory.Exists(@".\tessdata"))
    {
        throw new DirectoryNotFoundException(
            "tessdata folder not found. Download traineddata files from GitHub.");
    }

    using (var api = OcrApi.Create())
    {
        api.Init(Languages.English);       // loads eng.traineddata (~40 MB)
        return api.GetTextFromImage(imagePath);
    }
}

// Install: Install-Package Tesseract.Net.SDK
// Platform: Windows ONLY (.NET Framework 2.0-4.5)
using Patagames.Ocr;

public string ExtractTextSimple(string imagePath)
{
    // Platform check — Tesseract.Net.SDK is Windows-only
    if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
    {
        throw new PlatformNotSupportedException(
            "Tesseract.Net.SDK only supports Windows.");
    }

    // Verify tessdata exists
    if (!Directory.Exists(@".\tessdata"))
    {
        throw new DirectoryNotFoundException(
            "tessdata folder not found. Download traineddata files from GitHub.");
    }

    using (var api = OcrApi.Create())
    {
        api.Init(Languages.English);       // loads eng.traineddata (~40 MB)
        return api.GetTextFromImage(imagePath);
    }
}

Imports Patagames.Ocr
Imports System.Runtime.InteropServices
Imports System.IO

Public Function ExtractTextSimple(ByVal imagePath As String) As String
    ' Platform check — Tesseract.Net.SDK is Windows-only
    If Not RuntimeInformation.IsOSPlatform(OSPlatform.Windows) Then
        Throw New PlatformNotSupportedException("Tesseract.Net.SDK only supports Windows.")
    End If

    ' Verify tessdata exists
    If Not Directory.Exists(".\tessdata") Then
        Throw New DirectoryNotFoundException("tessdata folder not found. Download traineddata files from GitHub.")
    End If

    Using api = OcrApi.Create()
        api.Init(Languages.English) ' loads eng.traineddata (~40 MB)
        Return api.GetTextFromImage(imagePath)
    End Using
End Function

İki savunma kontrolü, tek bir OCR çalışmasına başlamadan önce görülür: Windows'u doğrulayın, tessdata'yı doğrulayın. Herhangi bir Windows olmayan konak üzerinde, yöntem çalıştırıcıya ulaşmadan önce atar. Tessdata klasörü dağıtım sırasında kopyalanmamış olan her makinede, tekrar atar. Her iki kontrol da standart kalıp değildir — her ikisi de geliştiricilerin üretimde karşılaştığı başarısızlık modlarını temsil eder.

Ayrıntılı Özellik Karşılaştırması

Tesseract.Net.SDK Yaklaşımı

Tesseract.Net.SDK, .NET Framework 2.0'dan 4.5'e kadar hedef alır. Bağlı olduğu her proje, bu çerçeve sürümlerinden birine yönelmelidir. Taşıma karşılaştırma dosyası, bu kısıtlamayı kurulum bölümünde doğrular:

// Install: Install-Package Tesseract.Net.SDK
// License: Commercial (Patagames)
// Platform: Windows ONLY (.NET Framework 2.0-4.5)
//
// Requirements:
//   - tessdata folder must exist in bin/Debug/ or bin/Release/
//   - Download traineddata files from https://github.com/tesseract-ocr/tessdata
//   - Windows operating system (no Linux/macOS support)

using Patagames.Ocr;

// Multi-language setup — all traineddata files must be manually downloaded
using (var api = OcrApi.Create())
{
    // Combine languages with bitwise OR
    api.Init(Languages.English | Languages.German | Languages.French);

    string text = api.GetTextFromImage(imagePath);
    return text;
}

// Install: Install-Package Tesseract.Net.SDK
// License: Commercial (Patagames)
// Platform: Windows ONLY (.NET Framework 2.0-4.5)
//
// Requirements:
//   - tessdata folder must exist in bin/Debug/ or bin/Release/
//   - Download traineddata files from https://github.com/tesseract-ocr/tessdata
//   - Windows operating system (no Linux/macOS support)

using Patagames.Ocr;

// Multi-language setup — all traineddata files must be manually downloaded
using (var api = OcrApi.Create())
{
    // Combine languages with bitwise OR
    api.Init(Languages.English | Languages.German | Languages.French);

    string text = api.GetTextFromImage(imagePath);
    return text;
}

Imports Patagames.Ocr

' Install: Install-Package Tesseract.Net.SDK
' License: Commercial (Patagames)
' Platform: Windows ONLY (.NET Framework 2.0-4.5)
'
' Requirements:
'   - tessdata folder must exist in bin/Debug/ or bin/Release/
'   - Download traineddata files from https://github.com/tesseract-ocr/tessdata
'   - Windows operating system (no Linux/macOS support)

' Multi-language setup — all traineddata files must be manually downloaded
Using api = OcrApi.Create()
    ' Combine languages with bitwise OR
    api.Init(Languages.English Or Languages.German Or Languages.French)

    Dim text As String = api.GetTextFromImage(imagePath)
    Return text
End Using

using (var api = OcrApi.Create()) deseni kalıplaşmış .NET Framework 2.0'dır. C# 8.0 using var bildirimi yerine C# 1.0 using ifadesini kullanır. Ad alanı Patagames.Ocr. Dil kombinasyonu, bir enum üzerinde bitwise OR kullanır. Bu kodun hiçbiri, SDK tarzı bir proje dosyasında bir net6.0 veya net8.0 hedef çerçeveye karşı derlenmez, çünkü Tesseract.Net.SDK kendisi uyumlu bir derleme üretmiyor.

.NET Framework 4.5'te sıkışıp kalan ekipler, orada isteyerek sıkışmıyor. Oradalar çünkü bağımlılıklar — bazen bir OCR kütüphanesi dahil — yükseltilemez. Tesseract.Net.SDK seçmek, bu bağımlılık zincirini derinleştirir.

IronOCR Yaklaşımı

IronOCR, .NET 9'a kadar ve her modern .NET çalışma zamanı ile .NET Framework 4.6.2'yi destekler. Aynı paket ikili tümünde çalışır. .NET Framework 4.8'den .NET 8'e bir projeyi yükseltmek OCR kütüphanesini değiştirmeyi gerektirmez.

// Works on .NET Framework 4.6.2, .NET Core, .NET 5/6/7/8/9
// Same NuGet package, same API, same results
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

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

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

// Works on .NET Framework 4.6.2, .NET Core, .NET 5/6/7/8/9
// Same NuGet package, same API, same results
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

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

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

Imports IronOcr

' Works on .NET Framework 4.6.2, .NET Core, .NET 5/6/7/8/9
' Same NuGet package, same API, same results

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

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

Dim result = ocr.Read("document.jpg")
Console.WriteLine(result.Text)
Console.WriteLine($"Confidence: {result.Confidence}%")

Dil enuemleri üzerinde bitwise OR yok. Tessdata klasörü yok. Platform kontrolü yok. IronTesseract kurulum rehberi, tüm desteklenen çalışma zamanları için yapılandırma seçeneklerini tek bir belgede kapsar.

Orta taşıma sırasında ekipler için pratik sonuç: bir ASP.NET Core 8 projesi ile bir eski .NET Framework 4.8 projesi aynıIronOCR hizmet katmanını paylaşabilir. Koşullu derleme yok, ayrı kütüphane sürümleri yok, uyumsuz API'leri örtbas etmeye yönelik soyutlama katmanı yok.

Tesseract.Net.SDK Yaklaşımı

Tesseract.Net.SDK, Windows x86 ve x64 yerel ikilileri ile birlikte gelir. Tesseract motorunu başlatan P/Invoke çağrıları, bu Windows DLL'lerine çözümlenir. Bir Linux host üzerinde — mcr.microsoft.com/dotnet/aspnet:8.0, ubuntu veya alpine tabanlı herhangi bir Docker konteynerı dahil — DLL yüklenemez ve uygulama çalışma zamanında DllNotFoundException fırlatır.

tesseract-net-sdk-pdf-processing.cs'dan paralel işleme örneği, Linux'u düşünmeden önce bile Windows'un kendisinde toplu işler için bunun ne anlama geldiğini açıklar:

// Windows-only: Parallel.ForEach with separate engine per thread
// Each engine loads ~40-100 MB per language
Parallel.ForEach(
    imagePaths,
    new ParallelOptions { MaxDegreeOfParallelism = 4 },
    imagePath =>
    {
        // WARNING: Must create separate OcrApi for each thread!
        // Memory usage: 4 threads × 100MB = 400MB minimum
        using (var api = OcrApi.Create())
        {
            api.Init(Languages.English);
            string text = api.GetTextFromImage(imagePath);
            results[imagePath] = text;
        }
    });

// Windows-only: Parallel.ForEach with separate engine per thread
// Each engine loads ~40-100 MB per language
Parallel.ForEach(
    imagePaths,
    new ParallelOptions { MaxDegreeOfParallelism = 4 },
    imagePath =>
    {
        // WARNING: Must create separate OcrApi for each thread!
        // Memory usage: 4 threads × 100MB = 400MB minimum
        using (var api = OcrApi.Create())
        {
            api.Init(Languages.English);
            string text = api.GetTextFromImage(imagePath);
            results[imagePath] = text;
        }
    });

Dört paralel iş parçacığı, dört motor örneği, 400 MB'lık dil verisi aynı anda yüklendi — ve bu sadece İngilizce için. Alman ve Fransız ekleyin ve bu temel iki katına çıkar. SDK, bunu hafifletmek için hiçbir havuz mekanizması sunmaz. Mimari, genellikle her pod başına bellek tavanları uygulayan modern konteyner kaynak sınırları ile uyumsuzdur.

Azure Functions üzerinde bir Linux Tüketim Planına giden bir yol yoktur, AWS Lambda'ya giden bir yol yoktur (ki bu Amazon Linux üzerinde çalışır), ve Google Cloud Run'a giden bir yol yoktur. Her büyük sunucusuz platform Linux'a varsayılan olarak ayarlanır. Tesseract.Net.SDK, tasarımla tümünden dışlanmıştır.

IronOCR Yaklaşımı

IronOCR, Debian tabanlı görüntülerde libgdiplus için ek bir yapılandırma gerektirmeden Docker'a dağıtılır. Docker dağıtım rehberi, hem Linux hem de Windows konteynerlerini kapsar. Aynı şey Linux dağıtımları, Azure ve AWS için de geçerlidir.

Thread güvenliği, IronTesseract içine inşa edilmiştir. Bir örnek tüm paralel işçileri çalıştırır:

// Cross-platform: Windows, Linux, macOS, Docker
// Single instance — thread-safe
using IronOcr;

var ocr = new IronTesseract();

// Single engine instance shared across all threads
//Hayırmemory multiplication
Parallel.ForEach(imagePaths, imagePath =>
{
    using var input = new OcrInput();
    input.LoadImage(imagePath);
    var result = ocr.Read(input);
    SaveResult(imagePath, result.Text);
});

// Cross-platform: Windows, Linux, macOS, Docker
// Single instance — thread-safe
using IronOcr;

var ocr = new IronTesseract();

// Single engine instance shared across all threads
//Hayırmemory multiplication
Parallel.ForEach(imagePaths, imagePath =>
{
    using var input = new OcrInput();
    input.LoadImage(imagePath);
    var result = ocr.Read(input);
    SaveResult(imagePath, result.Text);
});

Imports IronOcr

' Cross-platform: Windows, Linux, macOS, Docker
' Single instance — thread-safe
Dim ocr As New IronTesseract()

' Single engine instance shared across all threads
' No memory multiplication
Parallel.ForEach(imagePaths, Sub(imagePath)
    Using input As New OcrInput()
        input.LoadImage(imagePath)
        Dim result = ocr.Read(input)
        SaveResult(imagePath, result.Text)
    End Using
End Sub)

Dört iş parçacığı, bir motor örneği, bellekte bir dil veri kopyası. Geçiş ölçütleri içeren bir çok iş parçacığı örneği için IronOCR belgeleri yapılandırma seçeneklerini ayrıntılı olarak kapsar.

Tesseract.Net.SDK Yaklaşımı

Tesseract.Net.SDK'nin PDF desteği yoktur. tesseract-net-sdk-pdf-processing.cs dosyası, başlığında bu sınırlama konusunda açık:

// CRITICAL LIMITATION:
// Tesseract.Net.SDK does NOT support PDF input natively.
// You must use a separate library to convert PDF pages to images first.
// This example uses PdfiumViewer, but alternatives include:
//   - iTextSharp
//   - Ghostscript.NET
//   - Docnet.Core

Sonuç, çoklu kütüphane boru hattıdır. PdfiumViewer yükleyin. Her PDF sayfasını 200–300 DPI'da bir Bitmap'ye işleyin. Bu bitmap'i geçici bir dosyaya yazın. Geçici dosyada api.GetTextFromImage() çalıştırın. Geçici dosyayı silin. Her sayfa için tekrarlayın. Belge ortasında kısmi hatalar için hata yönetimini uygulayın. Hafızayı açık bir şekilde yönetin — ProcessLargeTiff örneği, büyük belgelerde bellek yetersizliği hatalarını önlemek için her on sayfada GC.Collect()'ı zorunlu kılar.

Bu, basitleştirilmiş bir örnek değil, gerçek üretim kodudur. Sadece Windows üzerinde, sadece .NET Framework üzerinde çalışır ve ikinci bir ticari veya açık kaynak bağımlılığı gerektirir ki bu da kendi dağıtım yönetimini gerektirir.

IronOCR Yaklaşımı

IronOCR, PDF'leri yerel olarak okur. İkincil kütüphane yok, geçici dosyalar yok, sayfa render döngüsü yok:

// Native PDF OCR — no PdfiumViewer, no temp files
using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadPdf("scanned-report.pdf");   // native PDF support
var result = ocr.Read(input);

// Access page-by-page results
foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}: {page.Text}");
}

// Or produce a searchable PDF output
result.SaveAsSearchablePdf("searchable-report.pdf");

// Native PDF OCR — no PdfiumViewer, no temp files
using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadPdf("scanned-report.pdf");   // native PDF support
var result = ocr.Read(input);

// Access page-by-page results
foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}: {page.Text}");
}

// Or produce a searchable PDF output
result.SaveAsSearchablePdf("searchable-report.pdf");

Imports IronOcr

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    input.LoadPdf("scanned-report.pdf") ' native PDF support
    Dim result = ocr.Read(input)

    ' Access page-by-page results
    For Each page In result.Pages
        Console.WriteLine($"Page {page.PageNumber}: {page.Text}")
    Next

    ' Or produce a searchable PDF output
    result.SaveAsSearchablePdf("searchable-report.pdf")
End Using

Şifre korumalı PDF'ler, bir ek parametre gerektirir: input.LoadPdf("encrypted.pdf", Password: "secret"). Belirli sayfa aralıkları input.LoadPdfPages("document.pdf", 1, 10) kullanır. PDF giriş rehberi ve araştırabilir PDF yapma rehberi tüm varyantları kapsar.

PDF OCR örneği, güven testi ve yapısal çıkış dahil tam deseni gösterir. araştırabilir PDF örneği, taranabilir PDF'lerin indekslendiği ve aranabilir hale geldiği belge arşivleme kullanım durumunu gösterir.

Tesseract.Net.SDK Yaklaşımı

Tesseract motorları resim kalitesine duyarlıdır. Eğik, düşük çözünürlükte veya gürültülü belgeler, ön işleme yapılmadığında önemli ölçüde bozulmuş çıktı üretir. Tesseract.Net.SDK bunun hiçbirini sunmaz.

Taşıma karşılaştırma dosyası, bu boşluğu doğrudan miktarlar:

// Tesseract.Net.SDK: No preprocessing available
// Direct OCR on problematic image = garbage output
using (var api = OcrApi.Create())
{
    api.Init(Languages.English);

    // Direct OCR on problematic image — poor results
    string text = api.GetTextFromImage(imagePath);
    return text;

    // To preprocess, you need:
    // 1. Install Emgu CV or OpenCvSharp
    // 2. Implement Hough transform for skew detection
    // 3. Implement affine rotation for deskew
    // 4. Implement FastNlMeansDenoising for noise reduction
    // 5. Handle all the native OpenCV dependencies
    // This is often 200+ lines of code
}

// Tesseract.Net.SDK: No preprocessing available
// Direct OCR on problematic image = garbage output
using (var api = OcrApi.Create())
{
    api.Init(Languages.English);

    // Direct OCR on problematic image — poor results
    string text = api.GetTextFromImage(imagePath);
    return text;

    // To preprocess, you need:
    // 1. Install Emgu CV or OpenCvSharp
    // 2. Implement Hough transform for skew detection
    // 3. Implement affine rotation for deskew
    // 4. Implement FastNlMeansDenoising for noise reduction
    // 5. Handle all the native OpenCV dependencies
    // This is often 200+ lines of code
}

Imports Tesseract.Net.SDK

' Tesseract.Net.SDK: No preprocessing available
' Direct OCR on problematic image = garbage output
Using api = OcrApi.Create()
    api.Init(Languages.English)

    ' Direct OCR on problematic image — poor results
    Dim text As String = api.GetTextFromImage(imagePath)
    Return text

    ' To preprocess, you need:
    ' 1. Install Emgu CV or OpenCvSharp
    ' 2. Implement Hough transform for skew detection
    ' 3. Implement affine rotation for deskew
    ' 4. Implement FastNlMeansDenoising for noise reduction
    ' 5. Handle all the native OpenCV dependencies
    ' This is often 200+ lines of code
End Using

Yorum abartı değil. .NET'te OpenCV kullanarak bir üretim kalitesinde deskew yüzey uygulaması, başlangıç, açı tespiti, matris hesaplaması ve eğik dönüşümün 100-200 satırıdır. Bu kod daha sonra test edilmeli, korunmalı ve dağıtılmalı—kendi doğal bağımlılık zinciri ile ki bu yine sadece Windows üzerinde çalışır.

IronOCR Yaklaşımı

IronOCR, ilk sınıf API yöntemleri olarak OcrInput üzerinde önişleme paketler. Tesseract.Net.SDK'de bir OpenCV entegrasyonunu gerektiren aynı işlemler burada tekil yöntem çağrılarıdır:

//Yerleşikpreprocessing — no external library required
using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("skewed-invoice-scan.jpg");

input.Deskew();               // automatic angle detection and correction
input.DeNoise();              // scanner artifact removal
input.Contrast();             // contrast enhancement
input.Binarize();             // optimal threshold conversion
input.EnhanceResolution(300); // scale low-DPI images to 300 DPI

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

//Yerleşikpreprocessing — no external library required
using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("skewed-invoice-scan.jpg");

input.Deskew();               // automatic angle detection and correction
input.DeNoise();              // scanner artifact removal
input.Contrast();             // contrast enhancement
input.Binarize();             // optimal threshold conversion
input.EnhanceResolution(300); // scale low-DPI images to 300 DPI

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

Imports IronOcr

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    input.LoadImage("skewed-invoice-scan.jpg")

    input.Deskew()               ' automatic angle detection and correction
    input.DeNoise()              ' scanner artifact removal
    input.Contrast()             ' contrast enhancement
    input.Binarize()             ' optimal threshold conversion
    input.EnhanceResolution(300) ' scale low-DPI images to 300 DPI

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

görüntü kalitesi düzeltme rehberi ve görüntü renk düzeltme rehberi, tüm mevcut filtreleri öncesi/sonrası doğruluk karşılaştırmalarıyla birlikte belgeler. düşük kalite tarama örneği, tipik gerçek dünya belge koşulları için doğruluk geliştirme rakamlarını gösterir.

Özellikle taranmış belge iş akışları için taranmış belge işleme rehberi, yön tayinini, çok sayfalı işlemeyi ve yığın geçiş optimizasyonunu tek bir makalede kapsar.

.NET Güncellemesi Konuyu Zorluyor

En yaygın tetikleyici, OCR kalitesinden memnuniyetsizlik değil — planlı bir .NET Framework güncellemesinin OCR katmanında sert bir durma noktasına ulaşmasıdır. .NET Framework 4.7'den .NET 8'e bir belge yönetim uygulamasını yükselten bir ekip, Tesseract.Net.SDK'ın uyumlu bir hedef çerçeve derlemesi üretmediğini keşfeder. Yükseltme ya duraklar ya da OCR hizmeti, HTTP üzerinden iletişim kuran ayrı bir Windows-yalnız işlemi olarak izole edilir — bu da bir ağ sıçraması, ayrı bir dağıtım eseri ve süresiz olarak bakımı yapılması gereken bir uyum şimi ekler. Aktif bir yükseltme yolunda olan çoğu ekip için hiçbiri kabul edilebilir değildir. Tesseract.Net.SDK'yi IronOCR ile değiştirmek, engelleyiciyi ortadan kaldırır ve upgrading temiz bir şekilde devam etmesine izin verir çünkü IronOCR, hem eski .NET Framework 4.6.2+'de hem de.NET 8hedefinde aynı anda çalışır, hizmetin kademeli olarak taşınmasına izin verir.

İşleme Boru Hatının Konteynerleştirilmesi

Belge işleme yükleri, konteynerleştirme için öncelikli adaylar arasındadır: durumsuz, CPU bağımlı ve yatay ölçeklendirmeden faydalanır. Boruhattının geri kalanını konteynerleştiren bir ekip, Tesseract.Net.SDK'nin temel imaj Linux olduğunda Docker imaj yapı adımında başarısız olacağını keşfeder. Seçenekler Windows konteynerleridir — ki bu lisanslama maliyeti taşır, daha büyük imaj boyutları ve çoğu yönetilen Kubernetes hizmetiyle uyumsuzluk taşır ki bu varsayılan olarak Linux düğüm havuzlarına sahiptir — veya gerçekte Linux'u destekleyen bir kütüphanedir. IronOCR, standart bir Dockerfile ile herhangi bir Linux konteynerine dağıtılır. Docker dağıtım rehberi, hem Debian hem de Alpine baz imajları için tam Dockerfile yapılandırmasını sağlar.

Paralel Yığın İşleme Ölçekli Olarak

Tesseract.Net.SDK kullanarak dört paralel çalışanın ve günde 50.000 belge işleyen bir fatura işleme pipeline, İngilizce veri yüklü dört motor örneği için en az 400 MB ayırır. İkinci bir dil ekleyin ve bu ikiye katlanır. OpenCV üzerinden ön işleme ekleyin ve bellek tüketimi daha da yükselir. Pod başına 2 GB bellek sınırı olan bir sınırlı sunucuda veya konteynerleştirilmiş bir dağıtımda bu aritmetik bir dağıtım engelleyici haline gelir. IronOCR'un iş parçacığı güvenli tek örnek modeli, iş parçacığı başına bellek çarpanını ortadan kaldırır. Bir motor örneği, dört, sekiz veya on altı paralel çalışanı tek bir kez yüklü bir dil modeli ile işler. çok iş parçacığı örneği, yapılandırmayı gösterir.

İkincil Bir Bağımlılık Olmadan PDF Yerel İş Akışları

Özellikle belgeleri ana olarak PDF formatında alan — sigorta talepleri, sözleşmeler, faturalar, vergi formları — kuruluşlar Tesseract.Net.SDK ile birleşmiş bir sorunla karşılaşır: bir PDF render kütüphanesini OCR kütüphanesinin yanında sürdürmek zorundadırlar. PdfiumViewer veya iText bir güvenlik yaması yayınladığında, her iki kütüphanenin de eş güdümlü güncellemeleri ve regresyon testleri gereklidir. PDF kütüphanesi belirli bir PDF sürümünü render ederken bir hata meydana geldiğinde, OCR hattı belirgin bir kök neden olmadan hurda metin üretir. IronOCR'un yerel PDF desteği, bu iki kütüphane yığınını bire indirir. Tek bir paket kurulumu ikisini de değiştirir. PDF OCR kullanım durumu sayfası, tam iş akışını kapsar.

Kurumsal Dağıtım Gereksinimleri

Tesseract.Net.SDK için bir Patagames lisansı, tek bir bireysel geliştiriciden e-posta ve forum desteği ile birlikte gelir. SLA, garanti edilen yanıt süresi ve bir yükseltme yolu yoktur. Düzenlemeye tabi sektörlerdeki uygulamalar için — sağlık hizmetleri, finans, devlet — tedarik ekipleri giderek daha fazla yazılım satıcılarının belgelenmiş SLA'lar, güvenlik açıklama işlemleri ve kurumsal devamlılık garantileri sağlamasını talep eder. Patagames, bir bireysel geliştirici tarafından işletildiği için bu gereksinimleri karşılayamaz. IronOCR, kurumsal tedarik gereksinimleri ile uyumlu, özel destek, güvenlik süreçleri ve lisanslama şartlarına sahip ticari bir varlık olan Iron Software tarafından geliştirilmiştir. lisanslama sayfası, mevcut destek seviyelerini belgeler.

Ad Alanı ve Örnek Deseni

Tesseract.Net.SDK'den IronOCR'a geçiş kod değişikliği yüzeyde. using Patagames.Ocr;, using IronOcr; ile değiştirin. OcrApi.Create(), new IronTesseract() ile değiştirin. api.Init(Languages.English), ocr.Language = OcrLanguage.English ile değiştirin. Arayan kodun işlevsel mantığı değişmez. Basit bir çıkarma hizmeti bir saatten kısa sürede taşınabilir.

// Before: Tesseract.Net.SDK
using Patagames.Ocr;

using (var api = OcrApi.Create())
{
    api.Init(Languages.English);
    return api.GetTextFromImage(imagePath);
}

// After: IronOCR
using IronOcr;

var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage(imagePath);
return ocr.Read(input).Text;

// Before: Tesseract.Net.SDK
using Patagames.Ocr;

using (var api = OcrApi.Create())
{
    api.Init(Languages.English);
    return api.GetTextFromImage(imagePath);
}

// After: IronOCR
using IronOcr;

var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage(imagePath);
return ocr.Read(input).Text;

Imports Patagames.Ocr

Using api = OcrApi.Create()
    api.Init(Languages.English)
    Return api.GetTextFromImage(imagePath)
End Using

Imports IronOcr

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

görüntüden metin okuma öğreticisi ve temel OCR örneği, giriş doğrulama ve güven testi ile tamamlanmış çalıştırılabilir örnekler sağlar.

Tessdata Klasörünün Kaldırılması

Göçten sonra, tüm tessdata/ klasörü projeden silinebilir. IronOCR, dil verilerini NuGet paketleri ile birlikte paketler. Tüm .traineddata referanslarını .csproj'den çıkarın, dağıtım betiklerinden tessdata dizinini kaldırın ve eğitimli veriler dosyalarını kopyalayan herhangi bir CI/CD boru hattı adımını kaldırın. IronOcr.Languages.* NuGet paketleri, normal yarıklı paket geri yükleme adımının bir parçası olarak dil verilerini yükler — ayrı bir indirme yok, manuel klasör yapılandırması yok, Visual Studio'da oluşturma eylemi ayarları yok. çoklu diller rehberi, dil paketi kurulmasını kapsar.

PDF Hattı Basitleştirme

OCR'dan önce PDF sayfalarını render etmek amacıyla PdfiumViewer, iText veya Ghostscript.NET yükleyen herhangi bir kod tamamen kaldırılabilir. Tüm çok adımlı geçici dosyaya işleme ardından OCR boru hattını input.LoadPdf(pdfPath) ile değiştirin. Özellikle şifre korumalı PDF'ler, belirli sayfa aralıkları ve 100 sayfayı aşan büyük belgeler için test yapın — bunlar, doğrulama sırasında davranış farklılıklarını en çok açığa çıkarabilecek sınır vakalarıdır.

İş Parçacığı Modeli ve Örnek Ömrü

Tesseract.Net.SDK kodu, genellikle thread-güvenliği sorunlarından kaçınmak için istek başına veya thread başına bir OcrApi örneği oluşturur.IronOCR thread-güvenlidir, bu yüzden IronTesseract örneği bir kez (uygulama başlangıcında veya bir DI konteynerinde bir singleton olarak) oluşturulmalı ve tüm istekler arasında yeniden kullanılmalıdır. Her istek başına yeni bir IronTesseract() oluşturmak, başlatma yükünü boşa harcar. ASP.NET Core'un hizmet konteynerinde bunu bir singleton olarak kaydedin ve gerektiğinde enjeksiyon yapın.