ABBYY FineReader Engine ile IronOCR: .NET OCR

Pratikte Dil Paketi Parçalanması

Her dil için bir paket sonucu, proje dosyanızda somut olarak ortaya çıkar. Beş Avrupa dilinde belgeleri işleyen bir uygulama için, paket manifesti şu şekilde görünür:

<PackageReference Include="RasterEdge.XImage.OCR" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.English" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.German" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.French" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.Spanish" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.Italian" Version="12.4.0" />

<PackageReference Include="RasterEdge.XImage.OCR" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.English" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.German" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.French" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.Spanish" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.Italian" Version="12.4.0" />

Çekirdek ve dil paketleri arasındaki sürüm uyumsuzlukları çalıştırma zamanında başlatma hatalarına neden olur. 12.4.0 sürümünde olan RasterEdge.XImage.OCR ve 12.3.0 sürümünde olan XImage.OCR.Language.English — kısmi bir güncellemeden sonra gerçekçi bir senaryo — kütüphanenin çalışma zamanında sürüm senkronizasyonunu net bir şekilde tanımlamayan hatalarla çökmesine neden olur. CI/CD ardışık düzeniniz şimdi 6 ayrı geri yükleme işlemi ve 6 bağımsız hata noktası içeriyor. Küresel bir dağıtım için Asya dilleri eklemek, Çince Basitleştirilmiş, Çince Geleneksel, Japonca ve Korece için kendi paketine ihtiyaç duyan CJK paketlerini ekler ve 10 dilli bir uygulamayı 11 ayrı NuGet bağımlılığına çıkarır.

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

XImage.OCR Yaklaşımı

XImage.OCR, her dili ayrı bir NuGet paketi olarak dağıtır. Temel yükleme komutu sadece OCR motorunu yükler. Ardından her gereken dili yüklersiniz:

# XImage.OCR: Install sequence for a multilingual application
dotnet add package RasterEdge.XImage.OCR
dotnet add package XImage.OCR.Language.English
dotnet add package XImage.OCR.Language.German
dotnet add package XImage.OCR.Language.French
dotnet add package XImage.OCR.Language.Spanish
dotnet add package XImage.OCR.Language.Italian
dotnet add package XImage.OCR.Language.Portuguese
dotnet add package XImage.OCR.Language.ChineseSimplified
dotnet add package XImage.OCR.Language.ChineseTraditional
dotnet add package XImage.OCR.Language.Japanese
# 10 languages = 11 package commands

# XImage.OCR: Install sequence for a multilingual application
dotnet add package RasterEdge.XImage.OCR
dotnet add package XImage.OCR.Language.English
dotnet add package XImage.OCR.Language.German
dotnet add package XImage.OCR.Language.French
dotnet add package XImage.OCR.Language.Spanish
dotnet add package XImage.OCR.Language.Italian
dotnet add package XImage.OCR.Language.Portuguese
dotnet add package XImage.OCR.Language.ChineseSimplified
dotnet add package XImage.OCR.Language.ChineseTraditional
dotnet add package XImage.OCR.Language.Japanese
# 10 languages = 11 package commands

Kodu kendisi de aynı karmaşıklığı yansıtır. Çok dilli OCR kurmak, kütüphanenin bunu derleme zamanında doğrulayamaması nedeniyle tüm dil paketlerinin zaten yüklü olmasını gerektirir:

// XImage.OCR: Language codes must match installed packages exactly
// If XImage.OCR.Language.German is not installed, this fails at runtime

var ocrHandler = new OCRHandler();

//Lisans aktivasyonurequired before any OCR operation
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-license-key");

// Set multiple languages — each requires its own NuGet package installed
ocrHandler.Languages = new[] { "eng", "deu", "fra", "spa", "ita" };

string result = ocrHandler.Process(imagePath);

// XImage.OCR: Language codes must match installed packages exactly
// If XImage.OCR.Language.German is not installed, this fails at runtime

var ocrHandler = new OCRHandler();

//Lisans aktivasyonurequired before any OCR operation
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-license-key");

// Set multiple languages — each requires its own NuGet package installed
ocrHandler.Languages = new[] { "eng", "deu", "fra", "spa", "ita" };

string result = ocrHandler.Process(imagePath);

Imports RasterEdge.XImage.OCR

' XImage.OCR: Language codes must match installed packages exactly
' If XImage.OCR.Language.German is not installed, this fails at runtime

Dim ocrHandler As New OCRHandler()

' Lisans aktivasyonu required before any OCR operation
License.LicenseManager.SetLicense("your-license-key")

' Set multiple languages — each requires its own NuGet package installed
ocrHandler.Languages = New String() {"eng", "deu", "fra", "spa", "ita"}

Dim result As String = ocrHandler.Process(imagePath)

Bir dil paketi eksikse veya yanlış sürümdeyse, başarısızlık OCR çağrısı sırasında çalışma zamanında meydana gelir, derleme zamanında veya paket geri yükleme sırasında değil. Bir dağıtım ardışık düzeninde, bu problem geliştiricinin makinesinde değil, üretim veya ön üretim ortamlarında keşfetmek anlamına gelir.

IronOCR Yaklaşımı

IronOCR tek bir paket olarak yüklenir. Yaygın Batı dilleri desteği varsayılan olarak paketlenmiştir; ek dil paketleri, aynı tek paket deseni izleyerek isteğe bağlı paketler olarak yüklenir, ancak bozulmuş bir durumdan ziyade çalışan bir durumdan başlarsınız:

# IronOCR: Install everything in one command
dotnet add package IronOcr
# English included. Add specific language packs only when needed.
dotnet add package IronOcr.Languages.German

# IronOCR: Install everything in one command
dotnet add package IronOcr
# English included. Add specific language packs only when needed.
dotnet add package IronOcr.Languages.German

Çok dilli OCR için kod, runtime hatalarını ortadan kaldıran tür güvenli OcrLanguage enum değerlerini kullanır, yanlış yazılmış dil tanımlayıcılarından kaynaklanan hatalar:

// IronOCR: Type-safe languages, single package
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("multilingual-document.jpg");
Console.WriteLine(result.Text);

// IronOCR: Type-safe languages, single package
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("multilingual-document.jpg");
Console.WriteLine(result.Text);

Imports IronOcr

' IronOCR: Type-safe languages, single package
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("multilingual-document.jpg")
Console.WriteLine(result.Text)

IronTesseract kurulum kılavuzu dil yapılandırmasını detaylı olarak kapsar. birden çok dil nasıl yapılır kılavuzu, karışık dil içeriğine sahip belgeler için birincil ve ikincil dilleri birleştirerek izah eder.

10 dilli bir uygulama için: XImage.OCR 11 paket, .csproj 'de 11 satır ve güncellemeler geldiğinde tüm 11 için devam eden sürüm senkronizasyonu gerektirir. IronOCR, .csproj'da 1 paket ve gerektiğinde isteğe bağlı dil başına paketler gerektirir. Bu farklılık ekipler genelinde katlanır.

XImage.OCR Yaklaşımı

XImage.OCR, görüntüleri doğrudan Tesseract'a iletir. 2 derece eğik, tarayıcı gürültüsü ve 150 DPI çözünürlüklü taranmış bir fatura olduğu gibi işlenir. OCRHandler görüntü düzeltme için bir yöntem sunmaz:

// XImage.OCR:Hayırpreprocessing available
// A skewed, noisy, low-DPI scan goes straight to Tesseract

var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";

// Direct OCR on problematic image — skew, noise, and low resolution
// all degrade accuracy with no mitigation available in the library
string result = ocrHandler.Process(imagePath);

// To improve results, you would need:
// - External library (OpenCV.NET, ImageSharp, etc.)
// - 100-200 lines of deskew and noise-reduction code
// - Per-document-type tuning
// - Image processing expertise your OCR developer may not have

// XImage.OCR:Hayırpreprocessing available
// A skewed, noisy, low-DPI scan goes straight to Tesseract

var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";

// Direct OCR on problematic image — skew, noise, and low resolution
// all degrade accuracy with no mitigation available in the library
string result = ocrHandler.Process(imagePath);

// To improve results, you would need:
// - External library (OpenCV.NET, ImageSharp, etc.)
// - 100-200 lines of deskew and noise-reduction code
// - Per-document-type tuning
// - Image processing expertise your OCR developer may not have

' XImage.OCR:Hayırpreprocessing available
' A skewed, noisy, low-DPI scan goes straight to Tesseract

Dim ocrHandler As New OCRHandler()
ocrHandler.Language = "eng"

' Direct OCR on problematic image — skew, noise, and low resolution
' all degrade accuracy with no mitigation available in the library
Dim result As String = ocrHandler.Process(imagePath)

' To improve results, you would need:
' - External library (OpenCV.NET, ImageSharp, etc.)
' - 100-200 lines of deskew and noise-reduction code
' - Per-document-type tuning
' - Image processing expertise your OCR developer may not have

Çözüm, ayrı bir görüntü işleme kütüphanesi çekmek, kendinizi ön işleme kodu yazmak ve kütüphane güncellemeleri boyunca bu kodu korumaktır. Zaten RasterEdge'in ekosisteminde derin olan ekipler için, bazı araçlar diğer RasterEdge SDK bileşenleri aracılığıyla mevcuttur — ancak bu, ek ürünlerin satın alınmasını ve entegrasyonunu gerektirir.

IronOCR Yaklaşımı

IronOCR, belge yükleme ile OCR çalıştırma arasında OcrInput üzerinde zincirlenebilir yöntemler olarak ön işlemeyi uygular. Harici bir kütüphane gerekli değildir:

// IronOCR: Dahili ön işleme pipeline
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

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

// Apply corrections in sequence
input.Deskew();              // Detect and correct rotation angle
input.DeNoise();             // Remove scanner artifacts and noise
input.Contrast();            // Enhance contrast for faded text
input.Binarize();            // Convert to clean black-and-white
input.EnhanceResolution(300); // Scale low-DPI images to 300 DPI

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

// IronOCR: Dahili ön işleme pipeline
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

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

// Apply corrections in sequence
input.Deskew();              // Detect and correct rotation angle
input.DeNoise();             // Remove scanner artifacts and noise
input.Contrast();            // Enhance contrast for faded text
input.Binarize();            // Convert to clean black-and-white
input.EnhanceResolution(300); // Scale low-DPI images to 300 DPI

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

Imports IronOcr

' IronOCR: Dahili ön işleme pipeline
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

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

    ' Apply corrections in sequence
    input.Deskew()              ' Detect and correct rotation angle
    input.DeNoise()             ' Remove scanner artifacts and noise
    input.Contrast()            ' Enhance contrast for faded text
    input.Binarize()            ' Convert to clean black-and-white
    input.EnhanceResolution(300) ' Scale low-DPI images to 300 DPI

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

görüntü kalitesi düzeltme kılavuzu tam ön işleme filtre setini kapsar. Özellikle yönlendirme için, görüntü yönlendirme düzeltme kılavuzu ve sayfa rotasyon algılama çok açılı belgeleri ele alır.

Gerçek dünya belgeleri üzerindeki ön işlemenin pratik etkisi büyüktür. Tesseract, 150 DPI çözünürlükte 5 derece eğik bir taranmış belgede ön işleme olmadan yüzde 60-75 aralığında doğruluk sağlar. Masa düzeltme ve çözünürlük iyileştirmesi ile aynı belge 300 DPI çözünürlükte, doğru rotasyonla 93-97% doğruluğa ulaşır. XImage.OCR, dış kod olmadan bu farkı kapatamaz. IronOCR, 5 yöntem çağrısıyla bunu kapatır.

Ücretsiz Alternatif Farkı

NuGet üzerindeki charlesw/tesseract sarıcısı, 8 milyon+ indirme, aktif bakım ve Apache 2.0 lisansı — ticari kullanım için ücretsiz. XImage.OCR ile esasen aynı OCR çıktısını sağlar çünkü her ikisi de aynı Tesseract motorunu çağırıyor. Farklar:

• Dil desteği: Ücretsiz tessdata 100+ dil içermektedir; XImage.OCR,~15dili ücretli paketler olarak destekliyor
• Topluluk: charlesw/tesseract, 3.000+ Stack Overflow sorusu ve kapsamlı topluluk belgelerine sahip; XImage.OCR 100'den az soruya sahip
• Ön işleme: Her iki kütüphane de yerleşik ön işleme sağlamaz — her ikisi de görüntüleri doğrudan Tesseract'a iletir
• İş parçacığı: Her ikisi de aynı iş parçacığı güvenlik modeli kısıtlamasına sahiptir (iş parçacığı başına örnek gereklidir)

Ticari ürün daha az dile, daha küçük bir topluluğa sahipse, aynı ön işleme farkı ve aynı iş parçacığı modeline sahip olmakla, satıcı desteği ve RasterEdge ekosistemi entegrasyonu dışında ticari değer önerisini tanımlamak zorlaşır.

IronOCR Ticari Alternatif Olarak

IronOCR, otomatik ön işleme, yerel PDF desteği, iş parçacığı güvenli tasarım ve platformlar arası dağıtımı sağlayarak, ne XImage.OCR'nin ne de ücretsiz sarıcıların sağlayamadığı yeteneklerle ticari fiyatlandırmasını haklı çıkarır. $999 Lite lisansı tek seferlik süresiz bir satın alımdır. Soru, ticari bir OCR'nin ödemeye değip değmeyeceği değil — genellikle öyle. Soru, verilen paranın karşılığında ne alındığıdır.

// What the IronOCR Lite license buys vs what commercial pricing buys with XImage.OCR

// IronOCR: Preprocessing, PDF, thread safety, cross-platform in one call
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadPdf("scanned-invoice.pdf");   // Native PDF — no extra SDK
input.Deskew();                          // Built-in preprocessing
input.DeNoise();                         //Hayırexternal library needed
var result = ocr.Read(input);
result.SaveAsSearchablePdf("output.pdf"); // Searchable PDF output
Console.WriteLine($"Confidence: {result.Confidence}%");

// XImage.OCR: Same Tesseract core, no preprocessing, no PDF, not thread-safe
// Requires purchasing and integrating RasterEdge PDF SDK for PDF operations

// What the IronOCR Lite license buys vs what commercial pricing buys with XImage.OCR

// IronOCR: Preprocessing, PDF, thread safety, cross-platform in one call
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadPdf("scanned-invoice.pdf");   // Native PDF — no extra SDK
input.Deskew();                          // Built-in preprocessing
input.DeNoise();                         //Hayırexternal library needed
var result = ocr.Read(input);
result.SaveAsSearchablePdf("output.pdf"); // Searchable PDF output
Console.WriteLine($"Confidence: {result.Confidence}%");

// XImage.OCR: Same Tesseract core, no preprocessing, no PDF, not thread-safe
// Requires purchasing and integrating RasterEdge PDF SDK for PDF operations

Imports IronOcr

' What the IronOCR Lite license buys vs what commercial pricing buys with XImage.OCR

' IronOCR: Preprocessing, PDF, thread safety, cross-platform in one call
Dim ocr As New IronTesseract()
Using input As New OcrInput()
    input.LoadPdf("scanned-invoice.pdf")   ' Native PDF — no extra SDK
    input.Deskew()                         ' Built-in preprocessing
    input.DeNoise()                        ' No external library needed
    Dim result = ocr.Read(input)
    result.SaveAsSearchablePdf("output.pdf") ' Searchable PDF output
    Console.WriteLine($"Confidence: {result.Confidence}%")
End Using

' XImage.OCR: Same Tesseract core, no preprocessing, no PDF, not thread-safe
' Requires purchasing and integrating RasterEdge PDF SDK for PDF operations

görüntülerden metin okuma öğreticisi ve C# Tesseract OCR kılavuzu tam yetenek setini belgeler. Özellikle IronOCR'nin temel bir Tesseract sarıcısına neden tercih edildiğini değerlendiren ekipler için, özel Neden IronOCR ve Tesseract Değil sayfası, teknik farklılıkları ayrıntılı olarak açıklar.

XImage.OCR Yaklaşımı

XImage.OCR, yerel olarak PDF'leri işlemez. İş akışı, PDF sayfalarını görüntülere dönüştürmek için bağımsız bir ticari satın alma olan RasterEdge PDF SDK'sını gerektirir, ardından XImage.OCR, geçici dosyalar üzerinden sayfa başına bir seferde işler:

// XImage.OCR: PDF requires RasterEdge PDF SDK (additional purchase)
// Workflow: PDF -> render to image -> temp file -> OCR -> delete temp file

var pdfDocument = new PDFDocument(pdfPath); // Requires separate RasterEdge SDK

var results = new System.Text.StringBuilder();
var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    // Render PDF page to image at 200 DPI
    var pageImage = pdfDocument.RenderPage(i, 200);

    string tempPath = Path.GetTempFileName() + ".png";
    pageImage.Save(tempPath);

    try
    {
        string pageText = ocrHandler.Process(tempPath);
        results.AppendLine($"--- Page {i + 1} ---");
        results.AppendLine(pageText);
    }
    finally
    {
        File.Delete(tempPath); // Manual cleanup required
    }
}

return results.ToString();

// XImage.OCR: PDF requires RasterEdge PDF SDK (additional purchase)
// Workflow: PDF -> render to image -> temp file -> OCR -> delete temp file

var pdfDocument = new PDFDocument(pdfPath); // Requires separate RasterEdge SDK

var results = new System.Text.StringBuilder();
var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    // Render PDF page to image at 200 DPI
    var pageImage = pdfDocument.RenderPage(i, 200);

    string tempPath = Path.GetTempFileName() + ".png";
    pageImage.Save(tempPath);

    try
    {
        string pageText = ocrHandler.Process(tempPath);
        results.AppendLine($"--- Page {i + 1} ---");
        results.AppendLine(pageText);
    }
    finally
    {
        File.Delete(tempPath); // Manual cleanup required
    }
}

return results.ToString();

Imports System.Text
Imports System.IO

' XImage.OCR: PDF requires RasterEdge PDF SDK (additional purchase)
' Workflow: PDF -> render to image -> temp file -> OCR -> delete temp file

Dim pdfDocument As New PDFDocument(pdfPath) ' Requires separate RasterEdge SDK

Dim results As New StringBuilder()
Dim ocrHandler As New OCRHandler()
ocrHandler.Language = "eng"

For i As Integer = 0 To pdfDocument.PageCount - 1
    ' Render PDF page to image at 200 DPI
    Dim pageImage = pdfDocument.RenderPage(i, 200)

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

    Try
        Dim pageText As String = ocrHandler.Process(tempPath)
        results.AppendLine($"--- Page {i + 1} ---")
        results.AppendLine(pageText)
    Finally
        File.Delete(tempPath) ' Manual cleanup required
    End Try
Next

Return results.ToString()

Bu desen, geçici dosya yönetimini, açık temizlemeyi ve ikinci bir ticari ürün bağımlılığını tanıtır. Bu desendeki 200 DPI amaçlı işletim, Tesseract doğruluğunun optimal olduğu 300 DPI eşiğinin altına da düşer; bu da kaliteyi daha da etkiler. PDF iş akışları için XImage.OCR kullanan ekipler, başka bir yerde bir ürünün karşıladığı şeyi yapmak için efektif olarak iki ürün için ödeme yapmaktadır.

IronOCR Yaklaşımı

IronOCR PDF'leri yerel olarak ele alır. Ara adımlar, geçici dosyalar, ikinci SDK yok:

// IronOCR: Native PDF input, no extra dependencies
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using var input = new OcrInput();
input.LoadPdf("scanned-invoice.pdf");  // Direct PDF loading
var result = new IronTesseract().Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");
Console.WriteLine(result.Text);

// IronOCR: Native PDF input, no extra dependencies
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using var input = new OcrInput();
input.LoadPdf("scanned-invoice.pdf");  // Direct PDF loading
var result = new IronTesseract().Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");
Console.WriteLine(result.Text);

Imports IronOcr

' IronOCR: Native PDF input, no extra dependencies
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

Using input As New OcrInput()
    input.LoadPdf("scanned-invoice.pdf")  ' Direct PDF loading
    Dim result = New IronTesseract().Read(input)
    result.SaveAsSearchablePdf("searchable-output.pdf")
    Console.WriteLine(result.Text)
End Using

Parola korumalı PDF'ler bir parametre ekler:

using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);

using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);

Imports IronOcr

Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password: "secret")
    Dim result = New IronTesseract().Read(input)
End Using

PDF giriş kılavuzu çok sayfalı PDF'leri, sayfa aralığı seçimi ve DPI yapılandırmasını kapsar. aranabilir PDF kılavuzu çıktı seçeneklerini belgeler. Belge arşivleme hatları oluşturan ekipler için, C# kullanım durumu sayfasındaki PDF OCR tam iş akışını kapsar.

Paket Yönetimi Bir Bakım Yükü Haline Geldi

İki veya üç XImage.OCR dil paketi ile başlayan ekipler, uygulama 8 veya 10 dile genişlediğinde genellikle bir dönüm noktasına ulaşır. Proje dosyası şimdi 9-11 paket referansı içermekte ve hepsi sürüm senkronizasyonu gerektirmektedir. Sadece çekirdek paketi güncelleyen geliştirici, her dil için OCR'yi sessizce bozdu. CI/CD hattı, paket önbelleği eski bir dil paketi yüklediği için aralıklı olarak başarısız oluyor. Bu aşamada, sürüm senkronizasyon yükü, her dil için paketleme sağladığı değeri aşıyor ve tek pakete geçmek, açık mimari kararı haline geliyor.

Gerçek Dünya Belge Kalitesi, Ön İşleme Gerektirir

XImage.OCR'yi kontrollü, yüksek kaliteli taramalarla dağıtan ekipler başlangıçta doğruluk sorunları ile karşılaşmaz. Sorun, belge hattı genişlediğinde ortaya çıkar — mobil fotoğraf yüklemeleri, eski arşiv taramaları, faks belgeleri, elle doldurularak taranan 150 DPI taraması yapılmış formlar. Ön işlem olmadan, hangi sarıcıyı kullanırsanız kullanın, bu girişler üzerinde Tesseract doğruluğu sıkıntılıdır. Ekipler o zaman bir tercih ile karşı karşıya kalır: kendi ön işleme kütüphanesi entegrasyonunu inşa edip bakım yapmak veya ön işleme yerleşik bir çözümüne geçmek. IronOCR'nin yerleşik masa düzeltme, gürültü azaltma ve çözünürlük iyileştirmesi, tüm dış bağımlılığı ortadan kaldırır ve OCR geliştiricisinin görüntü işleme uzmanlığı gerektirmeden doğruluk iyileştirmesi sağlar.

PDF İş Akışları İkinci bir SDK Satın Alımı Gerektiriyor

Bir ekibin belge hattı, görüntü dosyalarından PDF'lere genişlediğinde — belge işleme uygulamaları için en yaygın ilerleme yoludur — XImage.OCR, ikinci bir RasterEdge ürünü alımını zorunlu kılar. PDF SDK ayrı bir ticari lisanstır. OCR için ticaret fiyatı ödeyen ekipler, OCR'yi büyük ölçekli iş ortamlarında en yaygın belge formatında çalıştırmak için ikinci bir ticari lisans bütçesi yapmadılar. IronOCR'nin yerel PDF desteği bu kaygıyı ilk günden itibaren gereksiz hale getirir ve PDF OCR örneği entegrasyonun ne kadar doğrudan olduğunu tam olarak gösterir.

Platformlar Arası Dağıtım Gerekli Hale Geliyor

XImage.OCR'nin Windows-öncelikli mimarisi,Linuxüzerinde konteyner tabanlı dağıtım veyamacOSgeliştirme ortamı söz konusu olduğunda katı bir kısıt haline gelir. Modern .NET geliştirme ekipleri, yerel geliştirme içinDockerçalıştırır veLinuxtabanlı konteyner altyapısına dağıtım yapar. YalnızcaWindowsiçin olan bir OCR kütüphanesi o yığında yer alamaz. IronOCR, yapılandırma değişikliğine ihtiyaç duymadan aynı paket ile Windows, Linux,macOSve Docker'ı destekler — Docker dağıtım kılavuzu ve Linux dağıtım kılavuzu kurulumu detaylı bir şekilde açıklar.

İş Parçacığı Güvenliği, Sunucu Uygulamalarında Veri Akışını Sınırlar

Sunucu uygulamasında OCR, toplu işleri işleme veya eşzamanlı HTTP isteklerini ele alma, çoklu iş parçacığı gerektirir. XImage.OCR'nin her thread için ayrı handler modeli, her eş zamanlı thread'in kendi Tesseract motoru örneğini yüklediği ve thread başına dil başına 40-100MB tükettiği anlamına gelir. 5 dilde belge işleyen 4 iş parçacıklı bir sunucu, yalnızca OCR işlemci örnekleri için yaklaşık olarak 900MB–1.2GB yükler. IronOCR'nin iş parçacığı güvenli tasarımı, tüm iş parçacıkları arasında tek bir örneği paylaşır — bu tek örnek, bellek tüketimini artırmadan eşzamanlı istekleri işler. Üretimde bellek ya da geçiş hızı sınırlamalarına takılan ekipler, genellikle bu mimari farkın kök nedenine ulaşıyor.

OCRHandler'i IronTesseract ile Değiştirme

Birincil kod ikamesi basittir. OCRHandler yerini IronTesseract ile değiştirin, dize dil kodlarının ("eng", "deu") yerini tür-güvenli OcrLanguage enum değerleri ile değiştirin ve resim yüklemeyi OcrInput ile sarın. Lisans aktivasyonu, güvenli dağıtım için bir ortam değişkeninden ayarlanabilen LicenseManager.SetLicense() 'dan IronOcr.License.LicenseKey statik özelliğine taşınır:

// Before: XImage.OCR
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-key");
var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";
string text = ocrHandler.Process(imagePath);

// After: IronOCR
IronOcr.License.LicenseKey = Environment.GetEnvironmentVariable("IRONOCR_LICENSE");
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage(imagePath);
var result = ocr.Read(input);
string text = result.Text;

// Before: XImage.OCR
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-key");
var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";
string text = ocrHandler.Process(imagePath);

// After: IronOCR
IronOcr.License.LicenseKey = Environment.GetEnvironmentVariable("IRONOCR_LICENSE");
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage(imagePath);
var result = ocr.Read(input);
string text = result.Text;

Imports System
Imports IronOcr

' Before: XImage.OCR
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-key")
Dim ocrHandler As New OCRHandler()
ocrHandler.Language = "eng"
Dim text As String = ocrHandler.Process(imagePath)

' After: IronOCR
IronOcr.License.LicenseKey = Environment.GetEnvironmentVariable("IRONOCR_LICENSE")
Dim ocr As New IronTesseract()
Using input As New OcrInput()
    input.LoadImage(imagePath)
    Dim result = ocr.Read(input)
    text = result.Text
End Using

Tam görüntü giriş kılavuzu tüm giriş türlerini kapsar: dosya yolları, byte dizileri, akışlar ve URL'ler.

Var Olmadığı Yere Ön İşleme Eklemek

XImage.OCR'den taşınan ekiplerin, daha önce mevcut olmayan ön işlemler ekleme fırsatı vardır. Geçiş, sadece bir sınıf adı değişikliği değil — daha iyi bir seçenek bulunmadığı için sessizce kabul edilen doğruluk sorunlarını düzeltme fırsatıdır. Girdiyi yükledikten sonra, belge türleriniz için uygun filtreleri ekleyin:

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

// Add these lines immediately after loading — no other changes needed
input.Deskew();
input.DeNoise();
input.EnhanceResolution(300);

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

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

// Add these lines immediately after loading — no other changes needed
input.Deskew();
input.DeNoise();
input.EnhanceResolution(300);

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

Imports IronOcr

Using input As New OcrInput()
    input.LoadImage(imagePath)

    ' Add these lines immediately after loading — no other changes needed
    input.Deskew()
    input.DeNoise()
    input.EnhanceResolution(300)

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

görüntü filtreleri öğreticisi, belirli belge kalitesi sorunları için hangi filtrelerin uygulanacağı konusunda rehberlik sağlar. Bunları yalnızca kalitenin değişken olduğu belgelere uygulayın — temiz, yüksek çözünürlüklü taramalar ön işleme gerektirmez ve ek adım işlem süresi ekler.

Paket Listesini Basitleştirme

Projeden tüm XImage.OCR paketlerini kaldırın. Paketin kaldırılması, birden fazla dil yüklü olan uygulamalar için sürecin en uzun kısmıdır:

# Remove all XImage.OCR packages
dotnet remove package RasterEdge.XImage.OCR
dotnet remove package XImage.OCR.Language.English
dotnet remove package XImage.OCR.Language.German
dotnet remove package XImage.OCR.Language.French
# ... remove all language packages

# Add IronOCR
dotnet add package IronOcr

# Remove all XImage.OCR packages
dotnet remove package RasterEdge.XImage.OCR
dotnet remove package XImage.OCR.Language.English
dotnet remove package XImage.OCR.Language.German
dotnet remove package XImage.OCR.Language.French
# ... remove all language packages

# Add IronOCR
dotnet add package IronOcr

CI/CD hattını güncelleyerek birden fazla geri yükleme işlemini kaldırın ve paket bağımlılığı doğrulama adımlarını basitleştirin. Sürüm senkronizasyon mantığı — eğer otomatikleştirilmişse — tamamen silinebilir.

Bölge Tabanlı OCR İşleme

XImage.OCR, ProcessRegion(imagePath, rectangle) aracılığıyla bölge işleme sunar. IronOCR, giriş yükleme zamanında geçirilen CropRectangle aracılığıyla bunu yönetir:

//IronOCR region-based OCR
var region = new CropRectangle(x: 0, y: 0, width: 600, height: 100);
using var input = new OcrInput();
input.LoadImage("invoice.jpg", region);
var text = new IronTesseract().Read(input).Text;

//IronOCR region-based OCR
var region = new CropRectangle(x: 0, y: 0, width: 600, height: 100);
using var input = new OcrInput();
input.LoadImage("invoice.jpg", region);
var text = new IronTesseract().Read(input).Text;

Imports IronOcr

Dim region As New CropRectangle(x:=0, y:=0, width:=600, height:=100)
Using input As New OcrInput()
    input.LoadImage("invoice.jpg", region)
    Dim text As String = New IronTesseract().Read(input).Text
End Using

Bölge tabanlı OCR kılavuzu ve bölge kırpma örneği, faturalar ve formlar gibi sabit düzenli belgeler için yaklaşımı belgelemektedir.