Porównanie pomiędzy IronOCR a Aspose.OCR

Problem cyklu życia silnika

Każde wywołanieAsprise OCRwymaga wyraźnego zarządzania silnikiem. Schemat składa się z czterech obowiązkowych kroków: statycznej konfiguracji globalnej, utworzenia instancji, uruchomienia silnika z ciągiem językowym oraz zatrzymania silnika po zakończeniu. Silnik pomija wycieki zasobów natywnych, ponieważ moduł czyszczący pamięci nie może zwolnić pamięci niezarządzanej:

// 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

Ten wzorzec cicho zawodzi w trzech typowych sytuacjach: nieobłyszony wyjątek przed wywołaniem StopEngine(), zrefaktoryzowana ścieżka kodu pomijająca sprzątanie oraz równoczesne użycie w LITE/STANDARD, gdzie licencja zabrania wątkowania, które pozwalałoby na równoległość. Blok finally ogranicza pierwszy problem, ale ograniczenie licencji czyni wzorzec bezużytecznym dla obciążeń serwerowych w każdym razie.

Szczegółowe porównanie funkcji

Podejście Asprise

Asprise komunikuje się między zarządzanym kodem.NET/a swoim niezarządzanym silnikiem OCR za pośrednictwem marshalingu P/Invoke. Źródło asprise-vs-ironocr-examples.cs pokazuje podstawowy mechanizm:

// 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

Na wyższym poziomie API programiści wywołują ten sam most poprzez klasę opakowującą, ale wymagania dotyczące wdrożenia nie ulegają zmianie: każda maszyna docelowa wymaga odpowiedniego pliku binarnego, umieszczonego w odpowiedniej ścieżce i dopasowanego do właściwej architektury procesowej. Wdrożenie 64-bitowe, które dostarcza z aocr.dll zamiast aocr_x64.dll, powoduje wyrzucenie BadImageFormatException podczas uruchamiania. KontenerDockerLinux bez libaocr.so w LD_LIBRARY_PATH wyrzuca DllNotFoundException. Żaden z tych błędów nie jest wykrywany w czasie kompilacji.

Podejście IronOCR

IronOCR instaluje się jako pojedyncze odwołanie NuGet. Pakiet obsługuje wszystkie natywne zależności wewnętrznie poprzez mechanizm wyboru pakietów specyficzny dla platformy NuGet:

// 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

Instrukcja using na OcrInput zastępuje ręczne wywołania cyklu życia silnika. Nie ma StartEngine() do wywołania i nie ma StopEngine(), które można by było zapomnieć. Kolektor śmieci i wzorzec IDisposable poprawnie zajmują się sprzątaniem w scenariuszach wyjątkowych, nie wymagając rusztowania try/finally wokół każdego wywołania OCR.

Szczegółowe wskazówki dotyczące konfiguracji można znaleźć w przewodniku konfiguracji IronTesseract.

Podejście Asprise

Licencje Lite i STANDARD wyraźnie zabraniają wykonywania wielowątkowego i wieloprocesowego. Każdy kod, który wywołuje Asprise z więcej niż jednego wątku jednocześnie, narusza Umowę licencyjną na tych poziomach..NETCore domyślnie przetwarza żądania w puli wątków. To sprawia, że każdy standardowy kontroler Web API, który wywołuje Asprise, stanowi naruszenie licencji w wersjach Lite/STANDARD:

// 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

Przetwarzanie wsadowe w wersjach Lite/STANDARD jest wymuszone sekwencyjnie, niezależnie od dostępnych rdzeni procesora:

// 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 usuwa ograniczenia wątkowe, ale ENTERPRISE wymaga kontaktu z działem sprzedaży Asprise, bez opublikowanej ceny.

Podejście IronOCR

IronTesseract jest bezpieczny wątkowo i nie ma żadnych ograniczeń dotyczących wątków na żadnym poziomie licencji. Równoległe przetwarzanie wsadowe na licencji $999 Lite jest w pełni obsługiwane:

//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()

Kontrolery ASP.NET Core działają bez żadnej specjalnej konfiguracji:

//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

Zobacz przykład wielowątkowości, aby zapoznać się z wzorcami przepustowości równoległej w obciążeniach wsadowych.

Podejście Asprise

Przetwarzanie wstępne wymaga zewnętrznej biblioteki obrazów. Programista pracujący z Asprise dodaje zależność, taką jak ImageMagick, SkiaSharp lub System.Drawing, ręcznie wykonuje operacje przetwarzania wstępnego, zapisuje przetworzony obraz w pliku tymczasowym, a następnie przekazuje ten plik do Asprise:

// 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()

Powoduje to dodanie zależności kompilacji, zwiększa obciążenie środowiska uruchomieniowego z powodu dodatkowej biblioteki oraz wymaga od programisty wystarczającej znajomości przetwarzania obrazów, aby wprowadzić skuteczne poprawki.

Podejście IronOCR

Przetwarzanie wstępne jest wbudowane w OcrInput. Ten sam proces, który przy użyciu biblioteki zewnętrznej i starannego dostrajania parametrów zajmował 50–100 wierszy kodu, sprowadza się teraz do pięciu wywołań metod:

//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

W przypadku skanów, w których obrót jest nieprzewidywalny, funkcja automatycznego prostowania radzi sobie z dowolnymi kątami bez konieczności wykrywania lub określania wartości obrotu przez programistę. Przewodnik po korekcji jakości obrazu obejmuje pełny zestaw filtrów oraz informacje o tym, kiedy należy stosować każdy z nich.

Podejście Asprise

// 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

To podejście dodaje zależność od renderowania PDF (zwykle iText, PDFSharp lub komercyjny renderer), wymaga zarządzania plikami tymczasowymi i traci metadane PDF oraz strukturę, które natywny czytnik PDF by zachował. Pliki PDF chronione hasłem wymagają trzeciego komponentu.

Podejście IronOCR

IronOCR odczytuje pliki PDF bezpośrednio. Metoda OcrInput.LoadPdf() zajmuje się renderingiem wewnętrznie, w tym dokumentami wielostronicowymi i plikami chronionymi hasłem:

//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")

Przewodnik dotyczący OCR plików PDF obejmuje wybór zakresu stron, obsługę mieszanych typów plików PDF oraz tworzenie plików PDF z możliwością wyszukiwania na potrzeby procesów archiwizacji.

Przeszkoda w gotowości produkcyjnej

Ograniczenie dotyczące wątków stanowi poważną przeszkodę dla większości produkcyjnych obciążeń .NET. Zespół tworzy funkcję OCR przy użyciu Asprise Lite podczas rozwoju — testy jednowątkowe przebiegają pomyślnie, wszystko działa. Następnie funkcja trafia do środowiska stagingowego za interfejsem API.NET/Core, pojawiają się równoczesne żądania testowe, a aplikacja albo generuje błędy, albo działa w stanie niezgodnym z wymaganiami technicznymi. Rozwiązaniem jest albo przejście na wersję Enterprise (z związanymi z tym kosztami i zaangażowaniem działu sprzedaży), albo wymiana biblioteki. Zespoły, które osiągają ten etap podczas testów, a nie w środowisku produkcyjnym, mają szczęście; osoby, które odkryją to po uruchomieniu, staną przed koniecznością pilniejszej migracji.IronOCR usuwa całą tę klasę problemów — licencja $999 Lite wspiera przetwarzanie żądań jednoczesnych, równoległość wsadową, Usługi Windows i funkcje chmurowe bez ograniczeń.

Koszt złożoności wdrożenia

Zespoły działające w nowoczesnych środowiskach wdrożeniowych — kontenerach Docker, maszynach wirtualnych Linux, podach Kubernetes — ponoszą w ramach Asprise stałe koszty utrzymania, które nie występują w przypadku samych pakietów NuGet. Każda kompilacja obrazu kontenera musi zawierać poprawny plik binarny dla architektury docelowej. Każdy potok CI/CD przeznaczony dla wielu platform musi obsługiwać dołączanie plików specyficznych dla danej platformy. Brak biblioteki natywnej w produkcyjnym kontenerzeLinuxjest wykrywany w czasie wykonywania, a nie jest błędem kompilacji. Zespoły, które spędziły wiele godzin na debugowaniu 32-bitowej biblioteki DLL załadowanej do procesu 64-bitowego, doskonale rozumieją, ile to kosztuje. Wdrożenie IronOCR wyłącznie za pośrednictwem NuGet eliminuje całą tę kategorię niepowodzeń wdrożeniowych.

Problem z dokumentacją Java

Zespoły tworzące aplikacje.NET/potrzebują przykładów w języku C#, a nie w Javie. Podstawowa dokumentacja Asprise, Dokumentacja API i zasoby społeczności są skierowane do programistów Java. Programista.NET/czytający dokumentację Asprise przekłada składnię Javy, konwencje pakietówJavaoraz wzorce specyficzne dla Javy na odpowiedniki w języku C# — czasami tłumaczenie nie jest bezpośrednie, ponieważ opakowanie.NET/nie udostępnia wszystkich funkcji po stronie Javy. Dokumentacja, samouczki i przykłady kodu IronOCRsą przeznaczone dla programistów C#. Samouczek dotyczący odczytywania tekstu z obrazów oraz pełne centrum samouczków zawierają działające przykłady w języku C# dla każdej funkcji, bez dodatkowych kosztów związanych z tłumaczeniem.

Luka w procesie przetwarzania plików PDF

Zespoły przetwarzające zeskanowane dokumenty, faktury, umowy lub formularze w formacie PDF nie mogą korzystać z Asprise bez dodania biblioteki renderującej pliki PDF do swojego wykresu zależności. Ta biblioteka renderująca wiąże się z własnymi kwestiami licencyjnymi, obciążeniem związanym z utrzymaniem oraz potencjalnymi niezgodnościami. Dla zespołów, które potrzebują OCR + PDF w jednym pakiecie,IronOCR obsługuje obie funkcje natywnie. Możliwość tworzenia plików PDF z funkcją wyszukiwania na podstawie zeskanowanych danych — powszechny wymóg w procesach archiwizacji i zapewniania zgodności — nie ma odpowiednika w żadnym poziomie licencji Asprise.

Luka w pokryciu językowym

Asprise obsługuje ponad 20 języków OCR.IronOCR obsługuje ponad 125 narzędzi, z których każde można zainstalować jako niezależny pakiet NuGet. Zespoły przetwarzające dokumenty w języku arabskim, hindi, tajskim lub w jednym z kilkudziesięciu innych języków obsługiwanych przez IronOCR, ale nie przez Asprise, nie mają dostępu do obsługi wielojęzycznej za pośrednictwem Asprise. Przewodnik dotyczący wielu języków obejmuje instalację i łączenie pakietów językowych, w tym rozpoznawanie jednoczesne w wielu alfabetach.

Zastępowanie kodu cyklu życia silnika

Największą mechaniczną zmianą podczas migracji jest usunięcie wzorca cyklu życia silnika Asprise i zastąpienie go bezpośrednią inicjalizacją IronTesseract. Każde wystąpienie sekwencji SetUp() / StartEngine() / Recognize() / StopEngine() staje się jednym wywołaniem Read():

// 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

Dla kodu wrażliwego na wydajność, który przetwarza wiele dokumentów sekwencyjnie, ponownie użyj instancji IronTesseract zamiast tworzyć nową dla każdego wywołania — inicjalizacja silnika niesie ze sobą narzut, a pojedyncza instancja używana w sposób sekwencyjny jest bardziej efektywna niż tworzenie i usuwanie jednej dla każdego dokumentu.

Zastępowanie kodów językowych opartych na ciągach znaków

Asprise używa parametrów ciągów znaków do wyboru języka ("eng", "fra", "eng+fra").IronOCR używa mocno typizowanego enumeratora OcrLanguage z API języka drugorzędnego. Przewodnik po wielu językach zawiera dostępne identyfikatory języków oraz pakiety NuGet wymagane dla każdego z nich:

// 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)

Zastępowanie sprawdzania ciągów błędów

W przypadku niepowodzenia rozpoznawania Asprise zwraca wartość null lub ciąg znaków poprzedzony prefiksem błędu.IronOCR generuje wyjątki .NET. Zastąp kontrolę null i prefiksów ciągów znaków standardowymi blokami try/catch. Dzięki temu obsługa błędów OCR jest spójna z pozostałą częścią modelu obsługi wyjątków.NET/i zapewnia dostęp do pełnych śladów stosu oraz hierarchii typów wyjątków, a nie tylko do przeanalizowanych ciągów błędów.

Włączanie przetwarzania równoległego

Po migracji, istniejące pętle wsadowe foreach mogą być przekonwertowane na Parallel.ForEach lub PLINQ bez żadnych obaw licencyjnych. W przypadku partii dokumentów, które wcześniej były przetwarzane sekwencyjnie w trybie Lite/STANDARD, równoległość stanowi bezpośredni mnożnik przepustowości. Przewodnik po asynchronicznym OCR obejmuje wzorce asynchroniczne dla kontekstów aplikacji internetowych, w których nieblokujące OCR jest preferowane w stosunku do nasycenia puli wątków.