IronOCR ile Aspose.OCR Arasında Bir Karşılaştırma

Motor Yaşam Döngüsü Problemi

HerAsprise OCRçağrısı açık motor yönetimi gerektirir. Desen dört zorunlu adımdan oluşur: statik küresel kurulum, örnek oluşturma, dil dizgisi ile motor başlatma ve tamamlandıktan sonra motor durdurma. Motor durdurmak atlanırsa, çöp toplayıcı yönetilmeyen belleği serbest bırakamadığı için yerel kaynakları sızdırır:

// Asprise: four required steps before reading a single image
Ocr.SetUp();                              // Static global init
Ocr ocr = new Ocr();
try
{
    ocr.StartEngine("eng", Ocr.SPEED_FAST);   // Allocates native engine
    string text = ocr.Recognize(
        imagePath,
        Ocr.RECOGNIZE_TYPE_TEXT,
        Ocr.OUTPUT_FORMAT_PLAINTEXT);
    return text;
}
finally
{
    ocr.StopEngine();                         // Must call — no IDisposable fallback
}

// Asprise: four required steps before reading a single image
Ocr.SetUp();                              // Static global init
Ocr ocr = new Ocr();
try
{
    ocr.StartEngine("eng", Ocr.SPEED_FAST);   // Allocates native engine
    string text = ocr.Recognize(
        imagePath,
        Ocr.RECOGNIZE_TYPE_TEXT,
        Ocr.OUTPUT_FORMAT_PLAINTEXT);
    return text;
}
finally
{
    ocr.StopEngine();                         // Must call — no IDisposable fallback
}

' Asprise: four required steps before reading a single image
Ocr.SetUp()                              ' Static global init
Dim ocr As New Ocr()
Try
    ocr.StartEngine("eng", Ocr.SPEED_FAST)   ' Allocates native engine
    Dim text As String = ocr.Recognize( _
        imagePath, _
        Ocr.RECOGNIZE_TYPE_TEXT, _
        Ocr.OUTPUT_FORMAT_PLAINTEXT)
    Return text
Finally
    ocr.StopEngine()                         ' Must call — no IDisposable fallback
End Try

Bu düzen, üç yaygın durumda sessizce başarısız olur: StopEngine() çağrılmadan önce ele alınamayan bir istisna, temizliği atlayan yeniden düzenlenmiş bir kod yolu ve eşzamanlı kullanım, LITE/STANDARD'da lisansın paralel çalışmasına izin verecek iş parçacığı oluşturmayı yasakladığı durumlar. finally bloğu ilk sorunu azaltır, ancak lisans kısıtlaması sunucu iş yükleri için bu düzeni zaten geçersiz kılar.

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

Asprise Yaklaşımı

Asprise, yönetilen.NET/kodu ile yönetilmeyen OCR motoru arasında P/Invoke marshalling aracılığıyla iletişim kurar. asprise-vs-ironocr-examples.cs kaynağı, alttaki mekanizmayı gösterir:

// Asprise interop layer — bridging managed C# to native OCR engine
[DllImport("aocr.dll")]
private static extern IntPtr OCR(string imagePath, int type);

public string ExtractText(string imagePath)
{
    // P/Invoke call into unmanaged DLL
    IntPtr result = OCR(imagePath, 0);
    return Marshal.PtrToStringAnsi(result);  // Manual string marshal
}

// Asprise interop layer — bridging managed C# to native OCR engine
[DllImport("aocr.dll")]
private static extern IntPtr OCR(string imagePath, int type);

public string ExtractText(string imagePath)
{
    // P/Invoke call into unmanaged DLL
    IntPtr result = OCR(imagePath, 0);
    return Marshal.PtrToStringAnsi(result);  // Manual string marshal
}

Imports System.Runtime.InteropServices

' Asprise interop layer — bridging managed VB.NET to native OCR engine
Private Class OCRInterop
    <DllImport("aocr.dll")>
    Private Shared Function OCR(imagePath As String, type As Integer) As IntPtr
    End Function

    Public Function ExtractText(imagePath As String) As String
        ' P/Invoke call into unmanaged DLL
        Dim result As IntPtr = OCR(imagePath, 0)
        Return Marshal.PtrToStringAnsi(result)  ' Manual string marshal
    End Function
End Class

Üst düzey API'de, geliştiriciler bir sınıf sarmalayıcı aracılığıyla aynı köprüye çağrı yaparlar, ancak dağıtım gereksinimi değişmez: her hedef makine, doğru yerel ikili dosyayı, doğru yola, doğru işlem mimarisiyle eşleşecek şekilde gerektirir. 64-bit bir dağıtım, aocr_x64.dll yerine aocr.dll ile gönderildiğinde, çalışma zamanında BadImageFormatException atar. libaocr.so içinde LD_LIBRARY_PATH olmadan çalışan bir LinuxDockerkonteynerı DllNotFoundException atar. Her iki hata da derleme sırasında yakalanmaz.

IronOCR Yaklaşımı

IronOCR tek bir NuGet referansı olarak yüklenir. Paket, tüm yerel bağımlılıkları NuGet'in platforma özel paket seçimi mekanizması aracılığıyla dahili olarak yönetir:

// Installation — one command, all platforms
// dotnet add package IronOcr

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

// Basic OCR — no native binary setup, no tessdata, no config files
var text = new IronTesseract().Read("document.jpg").Text;

// Installation — one command, all platforms
// dotnet add package IronOcr

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

// Basic OCR — no native binary setup, no tessdata, no config files
var text = new IronTesseract().Read("document.jpg").Text;

Imports IronOcr

' Installation — one command, all platforms
' dotnet add package IronOcr

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

' Basic OCR — no native binary setup, no tessdata, no config files
Dim text As String = New IronTesseract().Read("document.jpg").Text

using deyimi OcrInput üzerinde manuel motor yaşam döngüsü çağrılarını değiştirir. Çağrılacak StartEngine() yok ve unutulacak StopEngine() da yok. Çöp toplayıcı ve IDisposable düzeni, her OCR çağrısının etrafına try/finally iskele kurmayı gerektirmeden istisna senaryolarında temizliği doğru şekilde halleder.

Ayrıntılı kurulum kılavuzu için IronTesseract kurulum kılavuzuna bakın.

Asprise Yaklaşımı

LITE ve STANDARD lisanslar, açıkça çok iş parçacıklı ve çok işlemli yürütmeyi yasaklar. Asprise'yi aynı anda birden fazla iş parçacığından çağıran herhangi bir kod, o seviyelerdeki lisans sözleşmesini ihlal eder. ASP.NET Core, varsayılan olarak bir iş parçacığı havuzunda istekleri işler. Bu, Asprise'yi çağıran her standart Web API denetleyicisinin, LITE/STANDARD üzerinde bir lisans ihlali olmasına neden olur:

// ASPRISE LITE/STANDARD — violates license in ASP.NET Core context
// Web server thread pool = multiple concurrent threads = prohibited
[ApiController]
public class OcrController : ControllerBase
{
    [HttpPost("extract")]
    public IActionResult ExtractText(IFormFile file)
    {
        // Two concurrent requests = two threads = license violation
        var ocr = new Ocr();
        ocr.StartEngine("eng", Ocr.SPEED_FAST);
        var text = ocr.Recognize(tempPath, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT);
        ocr.StopEngine();
        return Ok(text);
    }
}

// ASPRISE LITE/STANDARD — violates license in ASP.NET Core context
// Web server thread pool = multiple concurrent threads = prohibited
[ApiController]
public class OcrController : ControllerBase
{
    [HttpPost("extract")]
    public IActionResult ExtractText(IFormFile file)
    {
        // Two concurrent requests = two threads = license violation
        var ocr = new Ocr();
        ocr.StartEngine("eng", Ocr.SPEED_FAST);
        var text = ocr.Recognize(tempPath, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT);
        ocr.StopEngine();
        return Ok(text);
    }
}

Imports Microsoft.AspNetCore.Mvc

' ASPRISE LITE/STANDARD — violates license in ASP.NET Core context
' Web server thread pool = multiple concurrent threads = prohibited
<ApiController>
Public Class OcrController
    Inherits ControllerBase

    <HttpPost("extract")>
    Public Function ExtractText(file As IFormFile) As IActionResult
        ' Two concurrent requests = two threads = license violation
        Dim ocr As New Ocr()
        ocr.StartEngine("eng", Ocr.SPEED_FAST)
        Dim text As String = ocr.Recognize(tempPath, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT)
        ocr.StopEngine()
        Return Ok(text)
    End Function
End Class

LITE/STANDARD üzerinde toplu işlem, mevcut CPU çekirdeklerinden bağımsız olarak sırayla yapılır:

// ASPRISE LITE/STANDARD — sequential only (100 docs at 2 sec each = 3+ minutes)
Ocr.SetUp();
Ocr ocr = new Ocr();
try
{
    ocr.StartEngine("eng", Ocr.SPEED_FAST);
    foreach (var path in imagePaths)  // Cannot use Parallel.ForEach — license violation
    {
        string text = ocr.Recognize(path, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT);
        results.Add(text);
    }
}
finally
{
    ocr.StopEngine();
}

// ASPRISE LITE/STANDARD — sequential only (100 docs at 2 sec each = 3+ minutes)
Ocr.SetUp();
Ocr ocr = new Ocr();
try
{
    ocr.StartEngine("eng", Ocr.SPEED_FAST);
    foreach (var path in imagePaths)  // Cannot use Parallel.ForEach — license violation
    {
        string text = ocr.Recognize(path, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT);
        results.Add(text);
    }
}
finally
{
    ocr.StopEngine();
}

' ASPRISE LITE/STANDARD — sequential only (100 docs at 2 sec each = 3+ minutes)
Ocr.SetUp()
Dim ocr As New Ocr()
Try
    ocr.StartEngine("eng", Ocr.SPEED_FAST)
    For Each path In imagePaths ' Cannot use Parallel.ForEach — license violation
        Dim text As String = ocr.Recognize(path, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT)
        results.Add(text)
    Next
Finally
    ocr.StopEngine()
End Try

ENTERPRISE, iş parçacığı kısıtlamasını kaldırır, ancak ENTERPRISE, yayınlanmamış bir fiyat ile Asprise satışlarıyla iletişim kurmayı gerektirir.

IronOCR Yaklaşımı

IronTesseract, herhangi bir lisans katmanında iplik güvenlidir ve iş parçacığı oluşturma kısıtlaması taşımaz. Bir $999 Lite lisansı üzerinde paralel toplu işlem tam olarak desteklenir:

//IronOCR— parallel batch on any license tier
// 100 docs at 2 sec each, 8 cores = ~25 seconds vs 200 seconds sequential
var results = imagePaths
    .AsParallel()
    .Select(path => new IronTesseract().Read(path).Text)
    .ToList();

//IronOCR— parallel batch on any license tier
// 100 docs at 2 sec each, 8 cores = ~25 seconds vs 200 seconds sequential
var results = imagePaths
    .AsParallel()
    .Select(path => new IronTesseract().Read(path).Text)
    .ToList();

Imports System.Linq

'IronOCR— parallel batch on any license tier
' 100 docs at 2 sec each, 8 cores = ~25 seconds vs 200 seconds sequential
Dim results = imagePaths _
    .AsParallel() _
    .Select(Function(path) New IronTesseract().Read(path).Text) _
    .ToList()

ASP.NET Core denetleyicileri herhangi bir özel yapılandırma gerektirmeden çalışır:

//IronOCR— concurrent requests on any license tier
[ApiController]
public class OcrController : ControllerBase
{
    [HttpPost("extract")]
    public IActionResult ExtractText(IFormFile file)
    {
        // Thread-safe on Lite, Plus, Professional, Unlimited — all tiers
        var text = new IronTesseract().Read(tempPath).Text;
        return Ok(text);
    }
}

//IronOCR— concurrent requests on any license tier
[ApiController]
public class OcrController : ControllerBase
{
    [HttpPost("extract")]
    public IActionResult ExtractText(IFormFile file)
    {
        // Thread-safe on Lite, Plus, Professional, Unlimited — all tiers
        var text = new IronTesseract().Read(tempPath).Text;
        return Ok(text);
    }
}

Imports Microsoft.AspNetCore.Mvc

<ApiController>
Public Class OcrController
    Inherits ControllerBase

    <HttpPost("extract")>
    Public Function ExtractText(file As IFormFile) As IActionResult
        ' Thread-safe on Lite, Plus, Professional, Unlimited — all tiers
        Dim text = New IronTesseract().Read(tempPath).Text
        Return Ok(text)
    End Function
End Class

Toplu iş yüklerinde paralel geçiş kalıpları için çok iş parçacığı örneğine bakın.

Asprise Yaklaşımı

Ön işleme, harici bir görüntü kütüphanesi gerektirir. Asprise ile çalışan bir geliştirici, ImageMagick, SkiaSharp veya System.Drawing gibi bir bağımlılık ekler, ön işleme işlemlerini elle çalıştırır, işlenmiş görüntüyü geçici bir dosyaya kaydeder ve ardından o dosyayı Asprise'ye aktarır:

// Asprise preprocessing: external dependency required
// 1. Load with external library
// 2. Apply corrections (deskew, denoise, contrast) with external library
// 3. Save to temp file
// 4. Pass temp file to Asprise

var ocr = new Ocr();
ocr.StartEngine("eng", Ocr.SPEED_FAST);
// preprocessedImagePath comes from your external preprocessing pipeline
string text = ocr.Recognize(preprocessedImagePath, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT);
ocr.StopEngine();

// Asprise preprocessing: external dependency required
// 1. Load with external library
// 2. Apply corrections (deskew, denoise, contrast) with external library
// 3. Save to temp file
// 4. Pass temp file to Asprise

var ocr = new Ocr();
ocr.StartEngine("eng", Ocr.SPEED_FAST);
// preprocessedImagePath comes from your external preprocessing pipeline
string text = ocr.Recognize(preprocessedImagePath, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT);
ocr.StopEngine();

' Asprise preprocessing: external dependency required
' 1. Load with external library
' 2. Apply corrections (deskew, denoise, contrast) with external library
' 3. Save to temp file
' 4. Pass temp file to Asprise

Dim ocr As New Ocr()
ocr.StartEngine("eng", Ocr.SPEED_FAST)
' preprocessedImagePath comes from your external preprocessing pipeline
Dim text As String = ocr.Recognize(preprocessedImagePath, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT)
ocr.StopEngine()

Bu, yapıya bir bağımlılık ekler, ek kütüphaneden gelen çalışma zamanı yükü ekler, geliştiricinin etkili düzeltmeler uygulayabilecek kadar görüntü işlemesini anlamasını gerektirir.

IronOCR Yaklaşımı

Ön işleme OcrInput içine yerleştirilmiştir. Harici bir kütüphane ile ve dikkatli parametre ayarı gerektiren 50-100 satır alan aynı işlem hattı, beş yöntem çağrısına dönüşür:

//IronOCR— preprocessing built in, no external dependencies
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");
input.Deskew();               // Correct page rotation
input.DeNoise();              // Remove scanner artifacts
input.Contrast();             // Improve text/background separation
input.Binarize();             // Convert to black/white for cleaner engine input
input.EnhanceResolution(300); // Scale to optimal DPI

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

//IronOCR— preprocessing built in, no external dependencies
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");
input.Deskew();               // Correct page rotation
input.DeNoise();              // Remove scanner artifacts
input.Contrast();             // Improve text/background separation
input.Binarize();             // Convert to black/white for cleaner engine input
input.EnhanceResolution(300); // Scale to optimal DPI

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

Imports IronOcr

' IronOCR— preprocessing built in, no external dependencies
Using input As New OcrInput()
    input.LoadImage("low-quality-scan.jpg")
    input.Deskew()               ' Correct page rotation
    input.DeNoise()              ' Remove scanner artifacts
    input.Contrast()             ' Improve text/background separation
    input.Binarize()             ' Convert to black/white for cleaner engine input
    input.EnhanceResolution(300) ' Scale to optimal DPI

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

Dönüşün öngörülemez olduğu taramalar için, otomatik düzeltme, geliştiriciye dönüş değerlerini tespit etme veya belirtme gerektirmeden keyfi açılarda çalışır. Görüntü kalitesi düzeltme kılavuzu, tüm filtre setini ve her birinin ne zaman uygulanacağını kapsar.

Asprise Yaklaşımı

// Asprise PDF workaround — external library required to render PDF pages
var images = ExternalPdfLibrary.RenderPages("invoice.pdf");

Ocr.SetUp();
Ocr ocr = new Ocr();
try
{
    ocr.StartEngine("eng", Ocr.SPEED_FAST);
    var allText = new System.Text.StringBuilder();
    foreach (var imagePath in images)
    {
        string pageText = ocr.Recognize(imagePath, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT);
        allText.Append(pageText);
    }
    return allText.ToString();
}
finally
{
    ocr.StopEngine();
}
// Also: clean up temp image files

// Asprise PDF workaround — external library required to render PDF pages
var images = ExternalPdfLibrary.RenderPages("invoice.pdf");

Ocr.SetUp();
Ocr ocr = new Ocr();
try
{
    ocr.StartEngine("eng", Ocr.SPEED_FAST);
    var allText = new System.Text.StringBuilder();
    foreach (var imagePath in images)
    {
        string pageText = ocr.Recognize(imagePath, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT);
        allText.Append(pageText);
    }
    return allText.ToString();
}
finally
{
    ocr.StopEngine();
}
// Also: clean up temp image files

Imports System.Text

' Asprise PDF workaround — external library required to render PDF pages
Dim images = ExternalPdfLibrary.RenderPages("invoice.pdf")

Ocr.SetUp()
Dim ocr As New Ocr()
Try
    ocr.StartEngine("eng", Ocr.SPEED_FAST)
    Dim allText As New StringBuilder()
    For Each imagePath In images
        Dim pageText As String = ocr.Recognize(imagePath, Ocr.RECOGNIZE_TYPE_TEXT, Ocr.OUTPUT_FORMAT_PLAINTEXT)
        allText.Append(pageText)
    Next
    Return allText.ToString()
Finally
    ocr.StopEngine()
End Try
' Also: clean up temp image files

Bu yaklaşım bir PDF render bağımlılığı ekler (genellikle iText, PDFSharp veya ticari bir render), geçici dosyaları yönetmeyi gerektirir ve yerel bir PDF okuyucusunun koruyacağı PDF meta verilerini ve yapısını kaybeder. Şifre korumalı PDF'ler üçüncü bir bileşen gerektirir.

IronOCR Yaklaşımı

IronOCR, PDF'leri doğrudan okur. OcrInput.LoadPdf() yöntemi, çok sayfalı belgeler ve şifre korumalı dosyalar da dahil olmak üzere içsel olarak işleme sahiptir:

//IronOCR— native PDF input, no external rendering library
using var input = new OcrInput();
input.LoadPdf("invoice.pdf");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// Password-protected PDFs — same API, one parameter
using var secureInput = new OcrInput();
secureInput.LoadPdf("confidential.pdf", Password: "secret");
var secureResult = new IronTesseract().Read(secureInput);

// Generate searchable PDF from a scanned document
var scanResult = new IronTesseract().Read("scanned-contract.pdf");
scanResult.SaveAsSearchablePdf("searchable-contract.pdf");

//IronOCR— native PDF input, no external rendering library
using var input = new OcrInput();
input.LoadPdf("invoice.pdf");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// Password-protected PDFs — same API, one parameter
using var secureInput = new OcrInput();
secureInput.LoadPdf("confidential.pdf", Password: "secret");
var secureResult = new IronTesseract().Read(secureInput);

// Generate searchable PDF from a scanned document
var scanResult = new IronTesseract().Read("scanned-contract.pdf");
scanResult.SaveAsSearchablePdf("searchable-contract.pdf");

Imports IronOcr

' IronOCR— native PDF input, no external rendering library
Using input As New OcrInput()
    input.LoadPdf("invoice.pdf")
    Dim result = New IronTesseract().Read(input)
    Console.WriteLine(result.Text)
End Using

' Password-protected PDFs — same API, one parameter
Using secureInput As New OcrInput()
    secureInput.LoadPdf("confidential.pdf", Password:="secret")
    Dim secureResult = New IronTesseract().Read(secureInput)
End Using

' Generate searchable PDF from a scanned document
Dim scanResult = New IronTesseract().Read("scanned-contract.pdf")
scanResult.SaveAsSearchablePdf("searchable-contract.pdf")

PDF OCR kılavuzu, sayfa aralığı seçimi, karışık PDF türleri ile başa çıkma ve aramalı PDF çıktısı ele alma işlemlerini kapsar.

Üretim Hazırlığı Engelleyicisi

İş parçacığı kısıtlaması, çoğu üretim.NET/iş yükü için sert bir engelleyici olarak yüzeye çıkar. Bir ekip, geliştirme sırasında Asprise LITE kullanarak bir OCR özelliği oluşturur - tek iş parçacıklı testler geçer, her şey çalışır. Ardından özellik ASP.NET Core API'nin arkasında bir sahne ortamına gönderilir, eş zamanlı test istekleri gelir ve uygulama ya hatalar fırlatır ya da teknik olarak uyumsuz bir durumda çalışır. Çözüm, ENTERPRISE'a geçmek (ilgili maliyetlerle ve satış etkileşimiyle) veya kütüphaneyi değiştirmektir. Sahne ortamında değil de canlıya geçişte bu noktaya ulaşan ekipler şanslıdır; bunu lansman sonrası keşfedenler, daha acil bir geçişle karşı karşıyadırlar. IronOCR, bu türdeki tüm sorun grubunu ortadan kaldırır — $999 Lite lisansı, eşzamanlı istek işleme, toplu paralel çalışma, Windows Hizmetleri ve bulut işlevlerini sınırsız destekler.

Dağıtım Karmaşıklığı Vergisi

Asprise ile modern dağıtım ortamlarında -Dockerkonteynerleri,LinuxVM'ler, Kubernetes podları - çalışan ekipler, sırf NuGet paketleri ile var olmayan sürekli bakım maliyetiyle karşılaşır. Her bir konteyner görüntü derlemesi, hedef mimari için doğru yerel ikili dosyayı dahil etmelidir. Birden fazla platformu hedefleyen her CI/CD hattı, platforma özgü dosya eklemeyi yönetmelidir. Üretim linux konteynerinde eksik bir yerel kütüphane, bir çalışma zamanı keşfi, değil bir derleme zamanı hatasıdır. Bir 32-bit DLL'yi 64-bit bir işleme yükleme konusunda saatler harcayan ekipler, maliyeti somut bir şekilde anlarlar. IronOCR'nun yalnızca NuGet dağıtımı, bu tür dağıtım hatalarını tamamen ortadan kaldırır.

Java Belgeleri Sorunu

.NET uygulamaları geliştiren ekipler,Javaörnekleri değil, C# örnekleri ihtiyaç duyuyor. Asprise'nin birincil belgeleri, API referansları ve topluluk kaynaklarıJavageliştiricilerine yönelik olarak düzenlenmiştir..NETgeliştiricileri Asprise belgelerini okuyarakJavasözdizimini,Javapaket geleneklerini ve Java'ya özgü kalıpları C# eşdeğerlerine çevirir - ve bazen çeviri doğrudan değildir çünkü.NETsarmalayıcısı herJavatarafından sunulan özelliği açığa çıkarmayabilir. IronOCR'nun belgeleri, eğiticileri ve kod örnekleri C# geliştiricilerine yazılmıştır. Görüntülerden metin okuma eğitimi ve tam eğitim merkezi, tercüme maliyeti olmadan her özellik için çalışan C# örnekleri sağlar.

PDF Hat Boşluğu

Taranmış belgeleri, faturaları, sözleşmeler veya PDF formatındaki formları işleyen ekipler, Asprise'yi PDF render kütüphanesini bağımlılık grafiğine eklemeden kullanamaz. O render kütüphanesi, kendi lisanslama hususlarını, bakım yükünü ve olası uyumsuzlukları getirir. OCR + PDF'ye tek bir yığında ihtiyacı olan ekipler için,IronOCR her ikisini de yerel olarak yönetir. Arşivleme ve uyumluluk iş akışları için yaygın bir gereklilik olan taranmış girişlerden aranalabilir PDF'ler oluşturma yeteneği, Asprise'de herhangi bir lisans katmanında eşdeğeri yoktur.

Dil Kapsama Boşluğu

Asprise 20'den fazla OCR dili destekler.IronOCR 125+ destekler, her biri bağımsız bir NuGet paketi olarak yüklenebilir. Arapça, Hintçe, Tayca veya Asprise tarafından desteklenmeyen onlarca diğer dilde belgeleri işleyen ekipler, Asprise aracılığıyla çok dilli desteğe bir yol bulamaz. çok dilli kılavuzu, dil paketlerinin kurulumu ve birçok dil arasında eşzamanlı tanıma dahil ol olmak üzere kapsamaktadır.

Motor Yaşam Döngüsü Kodunu Değiştirme

Geçişteki en büyük mekanik değişiklik, Asprise motorunun yaşam döngüsü düzenini kaldırmak ve bunun yerine doğrudan IronTesseract örneklemesini kullanmaktır. SetUp() / StartEngine() / Recognize() / StopEngine() dizisinin her meydana gelmesi tek bir Read() çağrısı olur:

// Before: Asprise lifecycle (15 lines, manual cleanup)
Ocr.SetUp();
Ocr ocr = new Ocr();
try
{
    ocr.StartEngine("eng", Ocr.SPEED_FAST);
    string text = ocr.Recognize(
        imagePath,
        Ocr.RECOGNIZE_TYPE_TEXT,
        Ocr.OUTPUT_FORMAT_PLAINTEXT);
    return text;
}
finally
{
    ocr.StopEngine();
}

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

// Before: Asprise lifecycle (15 lines, manual cleanup)
Ocr.SetUp();
Ocr ocr = new Ocr();
try
{
    ocr.StartEngine("eng", Ocr.SPEED_FAST);
    string text = ocr.Recognize(
        imagePath,
        Ocr.RECOGNIZE_TYPE_TEXT,
        Ocr.OUTPUT_FORMAT_PLAINTEXT);
    return text;
}
finally
{
    ocr.StopEngine();
}

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

' Before: Asprise lifecycle (15 lines, manual cleanup)
Ocr.SetUp()
Dim ocr As New Ocr()
Try
    ocr.StartEngine("eng", Ocr.SPEED_FAST)
    Dim text As String = ocr.Recognize( _
        imagePath, _
        Ocr.RECOGNIZE_TYPE_TEXT, _
        Ocr.OUTPUT_FORMAT_PLAINTEXT)
    Return text
Finally
    ocr.StopEngine()
End Try

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

Birçok belgeyi ardışık olarak işleyen performansa duyarlı kod için, her çağrıda yeni bir tane oluşturmak yerine IronTesseract örneğini yeniden kullanın - motor başlatma maliyet gerektirir ve art arda kullanılan tek bir örnek, belge başına bir tane oluşturup yok etmekten daha verimlidir.

Dize Tabanlı Dil Kodlarını Değiştirme

Asprise, dil seçimi için dize parametreleri kullanır ("eng", "fra", "eng+fra"). IronOCR, ikincil bir dil API'si ile güçlü bir şekilde yazılmış bir OcrLanguage numaralandırma kullanır. çok dilli kılavuz, mevcut dil tanıtıcılarını ve her biri için gereken NuGet paketlerini kapsar:

// Before: Asprise string-based language
ocr.StartEngine("eng+fra", Ocr.SPEED_FAST);

// After:IronOCR strongly-typed language enum
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;
ocr.AddSecondaryLanguage(OcrLanguage.French);
var result = ocr.Read(imagePath);

// Before: Asprise string-based language
ocr.StartEngine("eng+fra", Ocr.SPEED_FAST);

// After:IronOCR strongly-typed language enum
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;
ocr.AddSecondaryLanguage(OcrLanguage.French);
var result = ocr.Read(imagePath);

Imports IronOcr

' Before: Asprise string-based language
ocr.StartEngine("eng+fra", Ocr.SPEED_FAST)

' After: IronOCR strongly-typed language enum
Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.English
ocr.AddSecondaryLanguage(OcrLanguage.French)
Dim result = ocr.Read(imagePath)

Hata-Dizesi Kontrollerini Değiştirme

Asprise tanıma başarısız olduğunda null veya bir hata ile önceden eklenmiş bir dize döndürür. IronOCR,.NETistisnaları fırlatır. Null ve dize-önek kontrollerini standart try/catch blokları ile değiştirin. Bu, OCR hata işlemesini diğer.NET/istisna işleme modeliyle hizalar ve ayrıştırılmış hata dizeleri yerine tam yığın izlerine ve istisna türü hiyerarşilerine erişim sağlar.

Paralel İşleme Özelliğini Açma

Geçişten sonra, mevcut foreach toplu döngüleri, lisans kaygısı olmadan Parallel.ForEach veya PLINQ'ya dönüştürülebilir. Önceden LITE/STANDARD üzerinde sırayla işlenen belge toplulukları için, paralellik doğrudan bir throughput çarpanıdır. async OCR kılavuzu, engellemeyen OCR'nin iş parçacığı havuzu doygunluğuna tercih edildiği web uygulama bağlamları için async kalıpları kapsar.