IronOCR ile LLM-Tabanlı OCR: .NET Geliştiricileri Hangisini Seçmeli?

4 Model Yapılandırma Aşırı Yükü

Her RapidOCR.NET uygulaması, karmaşıklıktan bağımsız olarak bu başlangıç bloğu ile başlar:

// RapidOcrNet: 4 paths required — any missing file throws at runtime
var engine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = "./models/det.onnx",      // ~3 MB download
    ClsModelPath = "./models/cls.onnx",      // ~1 MB download
    RecModelPath = "./models/rec_en.onnx",   // ~2–10 MB depending on language
    KeysPath     = "./models/en_keys.txt"    // ~100 KB character dictionary
});

// Text blocks returned — must be sorted and joined manually
var result = engine.Run(imagePath);
var text = string.Join("\n", result.TextBlocks
    .OrderBy(b => b.BoundingBox.Top)
    .ThenBy(b => b.BoundingBox.Left)
    .Select(b => b.Text));

// RapidOcrNet: 4 paths required — any missing file throws at runtime
var engine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = "./models/det.onnx",      // ~3 MB download
    ClsModelPath = "./models/cls.onnx",      // ~1 MB download
    RecModelPath = "./models/rec_en.onnx",   // ~2–10 MB depending on language
    KeysPath     = "./models/en_keys.txt"    // ~100 KB character dictionary
});

// Text blocks returned — must be sorted and joined manually
var result = engine.Run(imagePath);
var text = string.Join("\n", result.TextBlocks
    .OrderBy(b => b.BoundingBox.Top)
    .ThenBy(b => b.BoundingBox.Left)
    .Select(b => b.Text));

Imports System.Linq

' RapidOcrNet: 4 paths required — any missing file throws at runtime
Dim engine = New RapidOcrEngine(New RapidOcrOptions With {
    .DetModelPath = "./models/det.onnx",      ' ~3 MB download
    .ClsModelPath = "./models/cls.onnx",      ' ~1 MB download
    .RecModelPath = "./models/rec_en.onnx",   ' ~2–10 MB depending on language
    .KeysPath = "./models/en_keys.txt"        ' ~100 KB character dictionary
})

' Text blocks returned — must be sorted and joined manually
Dim result = engine.Run(imagePath)
Dim text = String.Join(vbCrLf, result.TextBlocks _
    .OrderBy(Function(b) b.BoundingBox.Top) _
    .ThenBy(Function(b) b.BoundingBox.Left) _
    .Select(Function(b) b.Text))

Çince OCR'ye geçiş bir yapılandırma değişikliği değil—bu bir dosya değişimidir. İngilizce tanıma modeli (en_rec.onnx / en_keys.txt) ve Çince tanıma modeli (ch_rec.onnx / ch_keys.txt) ayrı indirmelerdir. Bir belge hem Çince hem de İspanyolca metin içeriyorsa, ilerleme yolu yoktur: İspanyolca modeller RapidOCR model kataloğunda yer almaz.

.csproj ayrıca derleme sırasında dört dosyanın tamamının kopyalanması için açık MSBuild girdilerini gerektirir:

<ItemGroup>
  <Content Include="models\**\*.*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

<ItemGroup>
  <Content Include="models\**\*.*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

Bu adımı kaçırırsanız, üretim dağıtımı, çalışma zamanında yollar hiçbir şeye çözümlenemediğinde sessizce kırılır.

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

RapidOCR.NET Yaklaşımı

Model dosyaları NuGet paketi ile paketlenmemiştir. RapidOCR projesi için GitHub sürüm sayfalarında bulunurlar ve bant dışı indirilmeli, elle sürümlenmeli ve uygulamanızla dağıtılmalıdır. RapidOCR projesi, daha iyi doğruluk için güncellenmiş modeller yayınladığında, indirimi tekrarlarsınız ve dağıtımınızdaki dosyaları değiştirirsiniz.

CI/CD boru hattında, model dosyaları ya depoya taahhüt edilmelidir (Git geçmişine 15–25 MB ikili veri ekler) ya da özel betiklerle derleme adımında getirilmelidir. Docker konteynerinde, her dilin model seti özel bir COPY talimatı ve azımsanmayacak bir katman ekler. Bir Kubernetes dağıtımında, model dosyaları genellikle monte edilmiş bir hacimde veya görüntüde yer alır, her ikisi de güncellemelerin nasıl yayılacağına dair politikaları gerektirir.

Kaynak dosyalarındaki doğrulama mantığı kırılganlığı somut hale getirir:

// RapidOcrNet: Runtime validation needed because any missing file crashes the engine
public static bool ValidateModelFiles()
{
    var requiredFiles = new[]
    {
        Path.Combine(ModelDirectory, "det.onnx"),
        Path.Combine(ModelDirectory, "cls.onnx"),
        Path.Combine(ModelDirectory, "rec_en.onnx"),
        Path.Combine(ModelDirectory, "en_keys.txt")
    };

    var missingFiles = requiredFiles.Where(f => !File.Exists(f)).ToList();

    if (missingFiles.Any())
    {
        Console.WriteLine("ERROR: Missing required model files:");
        foreach (var file in missingFiles)
            Console.WriteLine($"  - {file}");
        return false;
    }

    return true;
}

// RapidOcrNet: Runtime validation needed because any missing file crashes the engine
public static bool ValidateModelFiles()
{
    var requiredFiles = new[]
    {
        Path.Combine(ModelDirectory, "det.onnx"),
        Path.Combine(ModelDirectory, "cls.onnx"),
        Path.Combine(ModelDirectory, "rec_en.onnx"),
        Path.Combine(ModelDirectory, "en_keys.txt")
    };

    var missingFiles = requiredFiles.Where(f => !File.Exists(f)).ToList();

    if (missingFiles.Any())
    {
        Console.WriteLine("ERROR: Missing required model files:");
        foreach (var file in missingFiles)
            Console.WriteLine($"  - {file}");
        return false;
    }

    return true;
}

Imports System
Imports System.IO
Imports System.Linq

Public Class RapidOcrNet
    Public Shared Function ValidateModelFiles() As Boolean
        Dim requiredFiles = {
            Path.Combine(ModelDirectory, "det.onnx"),
            Path.Combine(ModelDirectory, "cls.onnx"),
            Path.Combine(ModelDirectory, "rec_en.onnx"),
            Path.Combine(ModelDirectory, "en_keys.txt")
        }

        Dim missingFiles = requiredFiles.Where(Function(f) Not File.Exists(f)).ToList()

        If missingFiles.Any() Then
            Console.WriteLine("ERROR: Missing required model files:")
            For Each file In missingFiles
                Console.WriteLine($"  - {file}")
            Next
            Return False
        End If

        Return True
    End Function
End Class

RapidOCR.NET'i kullanan üretim uygulamaları rutin olarak, eksik bir model dosyasının paket yükleme zamanında temiz bir hata üretmediği — motor ilk başlatıldığında çalışma zamanı çökmesine neden olduğu için bu tür başlangıç doğrulamalarını içerir. Bu başarısızlık, geliştirme değil, üretimde yüzeye çıkar.

IronOCR Yaklaşımı

Yönetilecek model dosyası yok. dotnet add package IronOcr'den sonra, motor hazırdır:

// IronOCR: no model downloads, no path configuration, no validation boilerplate
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

// IronOCR: no model downloads, no path configuration, no validation boilerplate
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

' IronOCR: no model downloads, no path configuration, no validation boilerplate
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim text = New IronTesseract().Read("document.jpg").Text

IronTesseract kurulum rehberi tam kurulum yolunu gösterir. İngilizce dışındaki dilleri genişleten dil paketleri, NuGet paketleridir — dotnet add package IronOcr.Languages.French — ve geri yükleme adımı, zaten NuGet bağımlılıklarını geri yükleyen CI/CD boru hatlarında her şeyi halleder. İkili model dosyaları, Dockerfile'daki COPY katmanları veya başlangıç doğrulama betikleri hakkında hiçbir .gitignore kararı yoktur.

Docker'a dağıtan ekipler için IronOCR Docker kılavuzu, Debian/Ubuntu tabanlı görüntülerde tek gereken sistem bağımlılığı (libgdiplus) ve başka bir şey içermez.

RapidOCR.NET Yaklaşımı

RapidOCR.NET'in dil kapsamı kökenini yansıtır. PaddleOCR, Baidu tarafından Çince dilindeki internet aramalarına hizmet etmek için inşa edilmiştir. Modelleri, Çince Basitleştirilmiş ve Geleneksel için mükemmeldir. İngilizce desteği dahil edilmiştir ancak tasarımın birincil hedefi değildi. Japonca ve Korece, topluluk tarafından katkıda bulunulmuş deneysel modellere sahiptir. Geriye kalan her şey — İspanyolca, Fransızca, Almanca, Rusça, Arapça, Hintçe, Portekizce ve 100'den fazla diğer dil — mevcut modeller yok.

Desteklenen diller arasında geçiş yapmak farklı model dosyalarını indirmenizi gerektirir:

// RapidOcrNet:İngilizceengine
var englishEngine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = Path.Combine(modelPath, "det.onnx"),
    ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    RecModelPath = Path.Combine(modelPath, "en_rec.onnx"),   // English-specific
    KeysPath     = Path.Combine(modelPath, "en_keys.txt")    // English-specific
});

// RapidOcrNet: Chinese engine — different rec and keys files required
var chineseEngine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = Path.Combine(modelPath, "det.onnx"),
    ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    RecModelPath = Path.Combine(modelPath, "ch_rec.onnx"),   // Different download
    KeysPath     = Path.Combine(modelPath, "ch_keys.txt")    // Different download
});

// Spanish? NotSupportedException — no model exists

// RapidOcrNet:İngilizceengine
var englishEngine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = Path.Combine(modelPath, "det.onnx"),
    ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    RecModelPath = Path.Combine(modelPath, "en_rec.onnx"),   // English-specific
    KeysPath     = Path.Combine(modelPath, "en_keys.txt")    // English-specific
});

// RapidOcrNet: Chinese engine — different rec and keys files required
var chineseEngine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = Path.Combine(modelPath, "det.onnx"),
    ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    RecModelPath = Path.Combine(modelPath, "ch_rec.onnx"),   // Different download
    KeysPath     = Path.Combine(modelPath, "ch_keys.txt")    // Different download
});

// Spanish? NotSupportedException — no model exists

' RapidOcrNet:İngilizceengine
Dim englishEngine = New RapidOcrEngine(New RapidOcrOptions With {
    .DetModelPath = Path.Combine(modelPath, "det.onnx"),
    .ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    .RecModelPath = Path.Combine(modelPath, "en_rec.onnx"),   ' English-specific
    .KeysPath = Path.Combine(modelPath, "en_keys.txt")        ' English-specific
})

' RapidOcrNet: Chinese engine — different rec and keys files required
Dim chineseEngine = New RapidOcrEngine(New RapidOcrOptions With {
    .DetModelPath = Path.Combine(modelPath, "det.onnx"),
    .ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    .RecModelPath = Path.Combine(modelPath, "ch_rec.onnx"),   ' Different download
    .KeysPath = Path.Combine(modelPath, "ch_keys.txt")        ' Different download
})

' Spanish? NotSupportedException — no model exists

Aynı sıradan İngilizce, Çince ve İspanyolca belgeleri işlemek isteyen bir uygulamanın RapidOCR.NET'te İspanyol belgeleri için uygun bir yolu yoktur.

IronOCR Yaklaşımı

IronOCR 125+dili destekler, her biri bir NuGet dil paketi olarak mevcuttur. Geçiş, IronTesseract örneğindeki bir enum özelliği atamasıdır — dosya indirmeleri yok, motor yeniden oluşturma yok:

// IronOCR: language switching is a property change, not a file swap
var ocr = new IronTesseract();

// English
ocr.Language = OcrLanguage.English;

// Chinese Simplified
ocr.Language = OcrLanguage.ChineseSimplified;

// Spanish — no model download needed
ocr.Language = OcrLanguage.Spanish;

// Arabic — just works
ocr.Language = OcrLanguage.Arabic;

// Russian — just works
ocr.Language = OcrLanguage.Russian;

var result = ocr.Read("document.jpg");

// IronOCR: language switching is a property change, not a file swap
var ocr = new IronTesseract();

// English
ocr.Language = OcrLanguage.English;

// Chinese Simplified
ocr.Language = OcrLanguage.ChineseSimplified;

// Spanish — no model download needed
ocr.Language = OcrLanguage.Spanish;

// Arabic — just works
ocr.Language = OcrLanguage.Arabic;

// Russian — just works
ocr.Language = OcrLanguage.Russian;

var result = ocr.Read("document.jpg");

Imports IronOcr

Dim ocr As New IronTesseract()

' English
ocr.Language = OcrLanguage.English

' Chinese Simplified
ocr.Language = OcrLanguage.ChineseSimplified

' Spanish — no model download needed
ocr.Language = OcrLanguage.Spanish

' Arabic — just works
ocr.Language = OcrLanguage.Arabic

' Russian — just works
ocr.Language = OcrLanguage.Russian

Dim result = ocr.Read("document.jpg")

Karma dil belgeleri AddSecondaryLanguage kullanır:

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.ChineseSimplified;
ocr.AddSecondaryLanguage(OcrLanguage.English);
var result = ocr.Read("mixed-document.jpg");

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.ChineseSimplified;
ocr.AddSecondaryLanguage(OcrLanguage.English);
var result = ocr.Read("mixed-document.jpg");

Imports IronOcr

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.ChineseSimplified
ocr.AddSecondaryLanguage(OcrLanguage.English)
Dim result = ocr.Read("mixed-document.jpg")

çok dilli nasıl yapılır ve uluslararası diller örneği dil paketi yüklemesini ve ikincil dil yapılandırmasını ayrıntılı olarak kapsar.

RapidOCR.NET Yaklaşımı

RapidOCR.NET görüntüleri işler. PDF'ler görüntü değildir. Kütüphanede PDF işleme yeteneği, PDF yazma yeteneği ve aranabilir PDF çıktısı oluşturma mekanizması yoktur. RapidOCR.NET ile taranmış bir PDF'den metin çıkarmak en az üç ayrı bileşen gerektirir:

// RapidOcrNet: PDF processing requires external library + manual assembly
public async Task<string> ExtractTextFromPdf(string pdfPath)
{
    // Step 1: Requires PdfPig, Docotic, or similar external library
    var pageImages = await RenderPdfToImages(pdfPath);

    // Step 2: Initialize RapidOcr with 4 model files (must already be downloaded)
    using var engine = new RapidOcrEngine(new RapidOcrOptions
    {
        DetModelPath = "models/det.onnx",
        ClsModelPath = "models/cls.onnx",
        RecModelPath = "models/rec_en.onnx",
        KeysPath     = "models/en_keys.txt"
    });

    // Step 3: OCR each image individually
    var results = new List<string>();
    foreach (var pageImage in pageImages)
    {
        var result = engine.Run(pageImage);
        results.Add(string.Join("\n", result.TextBlocks.Select(b => b.Text)));
    }

    // Step 4: Combine manually — page structure not preserved
    return string.Join("\n\n", results);
}

// RapidOcrNet: PDF processing requires external library + manual assembly
public async Task<string> ExtractTextFromPdf(string pdfPath)
{
    // Step 1: Requires PdfPig, Docotic, or similar external library
    var pageImages = await RenderPdfToImages(pdfPath);

    // Step 2: Initialize RapidOcr with 4 model files (must already be downloaded)
    using var engine = new RapidOcrEngine(new RapidOcrOptions
    {
        DetModelPath = "models/det.onnx",
        ClsModelPath = "models/cls.onnx",
        RecModelPath = "models/rec_en.onnx",
        KeysPath     = "models/en_keys.txt"
    });

    // Step 3: OCR each image individually
    var results = new List<string>();
    foreach (var pageImage in pageImages)
    {
        var result = engine.Run(pageImage);
        results.Add(string.Join("\n", result.TextBlocks.Select(b => b.Text)));
    }

    // Step 4: Combine manually — page structure not preserved
    return string.Join("\n\n", results);
}

Imports System.Threading.Tasks
Imports System.Collections.Generic
Imports System.Linq

Public Class PdfTextExtractor
    ' RapidOcrNet: PDF processing requires external library + manual assembly
    Public Async Function ExtractTextFromPdf(pdfPath As String) As Task(Of String)
        ' Step 1: Requires PdfPig, Docotic, or similar external library
        Dim pageImages = Await RenderPdfToImages(pdfPath)

        ' Step 2: Initialize RapidOcr with 4 model files (must already be downloaded)
        Using engine As New RapidOcrEngine(New RapidOcrOptions With {
            .DetModelPath = "models/det.onnx",
            .ClsModelPath = "models/cls.onnx",
            .RecModelPath = "models/rec_en.onnx",
            .KeysPath = "models/en_keys.txt"
        })

            ' Step 3: OCR each image individually
            Dim results As New List(Of String)()
            For Each pageImage In pageImages
                Dim result = engine.Run(pageImage)
                results.Add(String.Join(vbLf, result.TextBlocks.Select(Function(b) b.Text)))
            Next

            ' Step 4: Combine manually — page structure not preserved
            Return String.Join(vbLf & vbLf, results)
        End Using
    End Function

    ' Placeholder for the RenderPdfToImages method
    Private Async Function RenderPdfToImages(pdfPath As String) As Task(Of List(Of Object))
        ' Implementation goes here
        Return New List(Of Object)()
    End Function
End Class

Bu, başka bir NuGet bağımlılığı, başka bir API yüzey alanını öğrenmeyi ve büyük belgeler için sayfa işlenmiş bitmapleri bellekte tutmanın getirdiği bellek baskısını ekler. Aranabilir PDF çıktısı — tanınan metni orijinal taramanın üzerine gizli bir OCR katmanı olarak yazmak — bu hattın herhangi bir noktasında elde edilemez.

IronOCR Yaklaşımı

IronOCR, PDF'leri yerel olarak okur. Aynı IronTesseract.Read() yöntemi hem görüntü yollarını hem de PDF yollarını kabul eder:

// IronOCR: direct PDF OCR — no conversion, no external library
var text = new IronTesseract().Read("scanned-document.pdf").Text;

//Şifre korumalı PDF— one parameter
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);

// Aranabilir PDF— one method call on the result
var result = new IronTesseract().Read("scanned.pdf");
result.SaveAsSearchablePdf("searchable-output.pdf");

// IronOCR: direct PDF OCR — no conversion, no external library
var text = new IronTesseract().Read("scanned-document.pdf").Text;

//Şifre korumalı PDF— one parameter
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);

// Aranabilir PDF— one method call on the result
var result = new IronTesseract().Read("scanned.pdf");
result.SaveAsSearchablePdf("searchable-output.pdf");

Imports IronOcr

' IronOCR: direct PDF OCR — no conversion, no external library
Dim text As String = New IronTesseract().Read("scanned-document.pdf").Text

' Şifre korumalı PDF— one parameter
Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password:="secret")
    Dim result = New IronTesseract().Read(input)
End Using

' Aranabilir PDF— one method call on the result
Dim result2 = New IronTesseract().Read("scanned.pdf")
result2.SaveAsSearchablePdf("searchable-output.pdf")

PDF girişi nasıl yapılır rehberi sayfa seçimi, parola yönetimi ve çok sayfalı işlemeyi kapsar. aranabilir PDF nasıl yapılır rehberi, orijinal tarama ile görsel olarak özdeş kalan, ancak tam metin arama katmanı ekleyen uyumlu derece çıktıyı oluşturmayı gösterir. Belge arşivleme hatları oluşturan ekipler için, bu çıktı formatı nihai hedeftir — ve IronOCR paketinin ötesinde başka hiçbir ek bağımlılık gerektirmez.

RapidOCR.NET Yaklaşımı

RapidOCR.NET daha yeni bir projedir. GitHub deposu, yerleşik .NET OCR kütüphaneleri ile karşılaştırıldığında sınırlı yıldız ve katkı aktivitesine sahiptir. Stack Overflow'da minimal kapsama sahiptir. Üretimde kenar vakalar ortaya çıktığında — alışılmadık görüntü yönlendirmeleri, belirli karakter setleri, ONNX Runtime sürüm çatışmaları, GPU mod yapılandırması — birincil kaynak GitHub sorunlar takipçisidir. Ticari bir destek katmanı yok, bakım SLA'sı yok ve garanti edilen bir yanıt zaman çizelgesi yok.

Bağımlılık zinciri ilave risk tanıtıyor. RapidOCR.NET, RapidOCR projesinin model sürümlerine bağlıdır. RapidOCR projesi, PaddleOCR'ın model mimarisine bağlıdır. Bu zincirin herhangi bir katmanındaki bir kırılma değişikliği, kullanıcıların güncellenmeden önce .NET sarmalayıcı sürdürücüsünün yanıt vermesini gerektirir — ve sarmalayıcı, tek bir topluluk geliştiricisi tarafından örgütsel bir arka plan olmadan sürdürülmektedir.

Dağıtım da ONNX Runtime sürümleme sorunlarını ortaya çıkarır. Microsoft.ML.OnnxRuntime paketi, küçük versiyonlar arasında yıkıcı değişikliklere sahipti ve onunla birlikte gönderilen yerel ikili dosyalar platforma özgüdür. linux/amd64 üzerine inşa edilmiş bir konteyner görüntüsü, linux/arm64 üzerine inşa edilmiş olanla aynı ONNX Runtime ikili dosyalarını kullanamaz. Her dağıtım hedefi doğrulama gerektirir.

IronOCR Yaklaşımı

IronOCR daha fazla bir on yıldır aktif ticari geliştirme altındadır. Kütüphane, belgelenmiş kırılma değişiklikleri, .NET SDK sürümleriyle uyumlu düzenli sürümleri olan sürümlenen bir API altında gönderilir ve her ticari lisansla birlikte e-posta desteği dahil edilir. Üretim hatları oluşturan ekipler, GitHub sorunlar kuyruğu yerine, birinin boş zamanında izlenen bir destek yolu alır.

Tek paket tasarımı, dağıtım doğrulama döngüsünü tamamen ortadan kaldırır. NuGet geri yükleme adımı belirleyicidir: Aynı paket sürümü, Windows, Linux ve macOS'ta aynı çalışan kurulumu üretir, platforma özgü yerel ikili yönetimi olmaksızın. AWS Lambda ve Azure dağıtımları için, fonksiyon paketi yalnızca yayınlanan uygulamayı içerir — model dosyası yedek parçaları, hacim montajları yok, başlangıç doğrulama mantığı yok.

düşük kaliteli tarama örneği ve görüntü kalitesi düzeltme nasıl yapılır rehberi, genellikle ONNX tabanlı hatlarda özel kod gerektiren ön işleme senaryolarını — eğik taramalar, gürültülü arka planlar, düşük kontrastlı belgeler — seçilen uygun filtre yöntemleri dışında herhangi bir kod gerektirmeden kapsar.

Model Dosya Yönetimi Dağıtımda Tıkanıklık Olduğunda

Prototip için RapidOCR.NET ile başlayan ekipler, üretim aşamasına geçmeye çalıştıklarında genellikle model dosyası yönetimi duvarına çarparlar. Dört model dosyasının sürümlendirilmesi, izlenmesi, oluşturulurken kopyalanması, CI (Sürekli Entegrasyon) eserlerine dahil edilmesi, sahne ortamına ve üretim ortamına dağıtılması gerekir — NuGet bağımlılık grafiğinden ayrı olarak. Küçük bir ekipte, bu operasyonel yük bir kez üstlenilir ve unutulur. Birden fazla hizmet, birden fazla ortam ve birden fazla CI boru hattını sürdüren bir ekipte, model dosyası dağıtımı etrafındaki özel betik yazımı, anlamlı bir bakım maliyetine dönüşür. Bir ekip arkadaşı "neden bu models/ klasörünü depoda bulunduruyoruz ve silersem ne olur?" diye sorduğunda ve cevap beş dakikalık bir açıklama gerektirdiğinde, genellikle değerlendirme o zaman başlar. IronOCR, model yönetim yüzeyinin tamamını ortadan kaldırır: ayrı olarak indirilecek hiçbir şey, CI'ye kopyalanacak hiçbir şey, başlangıçta doğrulanacak hiçbir şey yok.

Desteklenmeyen Dilde Bir Belge Geldiğinde

Dil kapsamı eksikliği bir durma noktasıdır, yapılandırma sorunu değildir. Bir kuruluş Almanca sözleşmeler, Fransızca faturalar, Rusça satın alma siparişleri veya Arapça yazışmalar alırsa, RapidOCR.NET bu belgeler için hiçbir yol sunmaz — "sınırlı doğruluk" değil, model yok, sonuç yok. CJK odaklı bir kullanım durumu için başlangıçta RapidOCR.NET'i seçen ekipler, bu kümenin dışındaki bir belgeyi işlemeleri gerektiğinde ilk kez bu sınırı keşfeder. IronOCR'nin dil özellikleri, NuGet üzerinden kurulabilen 125'ten fazla dili kapsar, böylece OCR hattının işleyebileceği kapsam uygulama koduna dokunmadan genişletilir - sadece dil paketini ekleyin ve bir enum özelliğini değiştirin.

Uygulama PDF Giriş veya Çıkışı Gerektirdiğinde

Belgelerin OCR işlemlerinde önemli bir kategori PDF'leri içerir: taranmış sözleşmeler, arşivlenmiş faturalar, çok işlevli yazıcılar tarafından PDF'ye dönüştürülmüş faks formları. RapidOCR.NET, ayrı bir PDF işleme kütüphanesi, özel dönüşüm kodu ve sayfa boyutundaki bit eşlemeler için bellek yönetimi olmadan hiçbirini okuyamaz. Belge alım hatları inşa eden ekipler, RapidOCR.NET yığınının hızlı bir şekilde en az iki kütüphane gerektirdiğini keşfeder — biri PDF oluşturma, diğeri OCR için — her biri kendi güncelleme döngüleri ve uyumluluk yüzeyleri ile. IronOCR, her ikisini tek bir pakette işler. RapidOCR.NET için kapsam dışında kalan taranmış bir arşivi arama yapılabilir bir dizine dönüştürerek arama yapılabilir PDF'ler üretme yeteneği,IronOCR ile tek bir yöntem çağrısıdır. Uyumluluk gereksinimlerine sahip belge yönetimi uygulamaları geliştiren ekipler, genellikle arama yapılabilir PDF çıktısı özelliğini belirleyici yetenek olarak belirtir.

Destek Yolu Olmadan Üretim Sorunları Ortaya Çıktığında

Topluluk projeleri, katkıda bulunanların müsaitliğine bağlı olarak yürütülür. Bir RapidOCR.NET üretim dağıtımı yeni bir edge vakası ile karşılaştığında — belirli bir ONNX Runtime sürüm uyuşmazlığı, alışılmadık bir resim formatında model çıkarım hatası, sürekli yük altında bir bellek sızıntısı — destek yolu bir GitHub sorunu açmak ve beklemektir. SLA yükümlülükleri veya iş açısından kritik belge işleme boru hatlarına sahip ekipler için, bu geçerli bir olay müdahale modeli değildir. IronOCR'nin ticari lisansı, ekiplerin bir Pazartesi günü son teslim tarihinden önce Cuma gecesi bir şey bozulduğunda gerçek bir iletişim noktası sağlayan doğrudan e-posta desteğini içerir.

Proje Prototip Varsayımlarının Ötesine Geçtiğinde

RapidOCR.NET, deneysel bir kavram kanıtı için makul bir seçimdir: ücretsiz, üzerinde pazarlık yapılacak bir lisans yoktur, model ayarının ötesinde hızlı kurulum yapılabilir. Bu kavram kanıtı bir üretim özelliği haline geldiğinde, laboratuvar ortamında kabul edilebilir olan kısıtlamalar — PDF desteği olmaması, dar dil kapsamı, manuel model yönetimi, ticari destek eksikliği — engel haline gelir. RapidOCR.NET'ten IronOCR'a geçiş yolu mekaniktir: paketleri kaldırın, modeller dizinini silin, MSBuild kopya kurallarını kaldırın, motor başlangıç bloğunu sıfır argümanlı bir OCR motoru yapıcısı ile değiştirin ve aynı anda PDF girişini, 125 dil kapsamını, otomatik ön işlemeyi ve aranabilir çıktıyı açın.

Motor Başlatma İşlemini Değiştirme

En doğrudan kod değişikliği, RapidOcrEngine başlangıç bloğunu bir IronTesseract örneklemesiyle değiştirmektir. Dört yol konfigürasyon nesnesi tamamen kaybolur:

// Before: RapidOcrNet — engine needs all 4 paths populated
var engine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = "models/det.onnx",
    ClsModelPath = "models/cls.onnx",
    RecModelPath = "models/rec_en.onnx",
    KeysPath     = "models/en_keys.txt"
});
var result = engine.Run(imagePath);
var text = string.Join("\n", result.TextBlocks
    .OrderBy(b => b.BoundingBox.Top)
    .Select(b => b.Text));

// After:IronOCR— no configuration required
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read(imagePath).Text;

// Before: RapidOcrNet — engine needs all 4 paths populated
var engine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = "models/det.onnx",
    ClsModelPath = "models/cls.onnx",
    RecModelPath = "models/rec_en.onnx",
    KeysPath     = "models/en_keys.txt"
});
var result = engine.Run(imagePath);
var text = string.Join("\n", result.TextBlocks
    .OrderBy(b => b.BoundingBox.Top)
    .Select(b => b.Text));

// After:IronOCR— no configuration required
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read(imagePath).Text;

Imports System.Linq

' Before: RapidOcrNet — engine needs all 4 paths populated
Dim engine = New RapidOcrEngine(New RapidOcrOptions With {
    .DetModelPath = "models/det.onnx",
    .ClsModelPath = "models/cls.onnx",
    .RecModelPath = "models/rec_en.onnx",
    .KeysPath = "models/en_keys.txt"
})
Dim result = engine.Run(imagePath)
Dim text = String.Join(vbCrLf, result.TextBlocks _
    .OrderBy(Function(b) b.BoundingBox.Top) _
    .Select(Function(b) b.Text))

' After: IronOCR— no configuration required
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim text = New IronTesseract().Read(imagePath).Text

Manuel OrderBy ve Select zincirine sahip result.TextBlocks koleksiyonu result.Text'ya çöker. TextBlocks tarafından sağlanan sınır kutusu verilerine ihtiyaç duyan uygulamalar için, result.Words sonuçları okuma nasıl yapılır içinde belgelenmiş yapılandırılmış bir API aracılığıyla aynı kelime başına koordinatları ve güven değerlerini açıklar.

Model Dosyası Altyapısını Kaldırma

Kodu değiştirdikten sonra, models/ dizinini silin, model dosyalarını derlemede kopyalayan MSBuild <Content> girişlerini kaldırın ve eksik dosyalar için kontrol edilen herhangi bir başlangıç doğrulama mantığını kaldırın. Bunlara gerek yoktur —IronOCR verilerini dahili olarak gönderir. CI/CD hatlarında, model dosyalarını getiren veya önbelleğe alan adımları kaldırın. Görüntü girdi yönergesi, mevcut RapidOCR.NET kodunun muhtemelen kullandığı yaygın dosya yolu, akış ve bayt dizisi senaryoları için girdi işleme modellerini kapsar.

Düşük Kaliteli Görüntülerin İşlenmesi

RapidOCR.NET'in ONNX modelleri, çıkarım sırasında dahili ön işleme uygular, ancak kütüphane çağrıcıya bir ön işleme API'si sunmaz. Mevcut kod, engine.Run()'ye iletmeden önce görüntü manipülasyonunu uyguluyorsa, bu kod ayrı bir görüntü kütüphanesine karşı yazılmıştır. IronOCR, doğrudan OcrInput üzerinde bir ön işleme API'si açıklar:

using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");
input.Deskew();           // Correct skewed scans
input.DeNoise();          // Remove scanner noise
input.Contrast();         // Enhance contrast
input.Binarize();         // Convert to black/white
input.EnhanceResolution(300);

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

using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");
input.Deskew();           // Correct skewed scans
input.DeNoise();          // Remove scanner noise
input.Contrast();         // Enhance contrast
input.Binarize();         // Convert to black/white
input.EnhanceResolution(300);

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

Imports IronOcr

Using input As New OcrInput()
    input.LoadImage("low-quality-scan.jpg")
    input.Deskew()           ' Correct skewed scans
    input.DeNoise()          ' Remove scanner noise
    input.Contrast()         ' Enhance contrast
    input.Binarize()         ' Convert to black/white
    input.EnhanceResolution(300)

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

Görsel yönlendirme düzeltme rehberi ve DPI ayarları rehberi, taranmış belgelerde en yaygın olarak doğruluğu etkileyen iki ön işleme konusunu ele alır. Güven skoru result.Confidence ve her kelime için result.Words[i].Confidence aracılığıyla mevcuttur.

PDF Desteği Ekleme

engine.Run() çağrılmadan önce PDF-to-image dönüşümü yapan kodlar tamamen silinebilir. IronTesseract.Read() doğrudan bir PDF yolunu kabul eder. PDF render kütüphanesi bağımlılığını ve dönüştürme ek kodunu kaldırın — bu, bağımlılıkların eklenmesi değil, toplamda azaltılması anlamına gelir.