Uma comparação entre IronOCR e Aspose.OCR

O problema do ciclo de vida do motor

Cada chamada de OCR da Asprise requer gerenciamento explícito do mecanismo. O padrão consiste em quatro etapas obrigatórias: configuração global estática, criação de instância, inicialização do mecanismo com uma string de idioma e parada do mecanismo após a conclusão. Ignorar a parada do mecanismo causa vazamento de recursos nativos porque o coletor de lixo não consegue liberar memória não gerenciada:

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

Esse padrão falha silenciosamente em três situações comuns: uma exceção não tratada antes de StopEngine() ser chamada, um caminho de código refatorado que pula a limpeza, e uso concorrente no LITE/STANDARD onde a licença proíbe a multi-threading que permitiria paralelismo. O bloco finally mitiga o primeiro problema, mas a restrição de licença torna o padrão irrelevante para cargas de trabalho em servidores de qualquer forma.

Comparação Detalhada de Recursos

Abordagem Asprise

O Asprise realiza a comunicação entre o código .NET gerenciado e seu mecanismo OCR não gerenciado por meio do marshaling P/Invoke. O código-fonte asprise-vs-ironocr-examples.cs mostra o mecanismo subjacente:

// 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 API de nível superior, os desenvolvedores acessam a mesma ponte por meio de um wrapper de classe, mas o requisito de implantação não muda: cada máquina de destino precisa do binário nativo correto, no caminho correto e correspondendo à arquitetura de processo correta. Um deployment 64 bits que fornece aocr.dll em vez de aocr_x64.dll lança um BadImageFormatException em tempo de execução. Um contêinerDockerLinux sem libaocr.so em LD_LIBRARY_PATH lança DllNotFoundException. Nenhum dos erros é detectado durante a compilação.

Abordagem IronOCR

O IronOCR é instalado como uma única referência NuGet . O pacote gerencia todas as dependências nativas internamente por meio do mecanismo de seleção de pacotes específico da plataforma do 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

A instrução using em OcrInput substitui chamadas manuais do ciclo de vida do motor. Não há StartEngine() para chamar e nenhum StopEngine() para esquecer. O coletor de lixo e o padrão IDisposable lidam corretamente com a limpeza em cenários de exceção sem exigir infraestrutura try/finally ao redor de cada chamada OCR.

Para obter instruções detalhadas de configuração, consulte o guia de configuração do IronTesseract .

Abordagem Asprise

As licenças Lite e STANDARD proíbem explicitamente a execução multithread e multiprocesso. Qualquer código que chame o Asprise de mais de uma thread simultaneamente viola o contrato de licença nesses níveis. Por padrão, o ASP.NET Core processa as solicitações em um pool de threads. Isso faz com que cada controlador de API Web padrão que chama Asprise viole a licença nas 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

O processamento em lote nas versões Lite/STANDARD é forçado a ser sequencial, independentemente dos núcleos de CPU disponíveis:

// 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 remove a restrição de thread, mas ENTERPRISE requer contato com as vendas da Asprise sem preço publicado.

Abordagem IronOCR

IronTesseract é seguro para threads e não possui restrições de threading em nenhum nível de licença. O processamento em lote paralelo em uma licença $999 Lite é totalmente suportado:

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

Os controladores ASP.NET Core funcionam sem qualquer configuração especial:

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

Veja o exemplo de multithreading para padrões de throughput paralelo em cargas de trabalho em lote.

Abordagem Asprise

O pré-processamento requer uma biblioteca de imagens externa. Um desenvolvedor que trabalha com Asprise adiciona uma dependência como ImageMagick, SkiaSharp ou System.Drawing, executa as operações de pré-processamento manualmente, salva a imagem processada em um arquivo temporário e, em seguida, passa esse arquivo para o 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()

Isso adiciona uma dependência de compilação, aumenta a sobrecarga de tempo de execução devido à biblioteca extra e exige que o desenvolvedor entenda o processamento de imagens suficientemente bem para implementar correções eficazes.

Abordagem IronOCR

O pré-processamento está integrado em OcrInput. O mesmo pipeline que antes exigia de 50 a 100 linhas de código com uma biblioteca externa e ajustes cuidadosos de parâmetros, passa a exigir apenas cinco chamadas de método:

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

Para digitalizações em que a rotação é imprevisível, a correção automática de inclinação lida com ângulos arbitrários sem exigir que o desenvolvedor detecte ou especifique valores de rotação. O guia de correção da qualidade da imagem abrange o conjunto completo de filtros e quando aplicar cada um deles.

Abordagem 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

Esta abordagem adiciona uma dependência de renderização de PDF (tipicamente iText, PDFSharp ou um renderer comercial), requer gerenciamento de arquivos temporários e perde metadados e estrutura do PDF que um leitor nativo de PDF preservaria. Os PDFs protegidos por senha exigem um terceiro componente.

Abordagem IronOCR

O IronOCR lê PDFs diretamente. O método OcrInput.LoadPdf() lida com a renderização internamente, incluindo documentos de várias páginas e arquivos protegidos por senha:

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

O guia de OCR para PDF aborda a seleção de intervalo de páginas, o tratamento de tipos mistos de PDF e a saída de PDF pesquisável para fluxos de trabalho de arquivamento.

O Bloqueador de Preparação para a Produção

A restrição de threads surge como um grande obstáculo para a maioria das cargas de trabalho .NET em produção. Durante o desenvolvimento, uma equipe cria um recurso de OCR usando o Asprise Lite — os testes de thread única são aprovados e tudo funciona corretamente. Em seguida, o recurso é enviado para um ambiente de teste por trás de uma API ASP.NET Core , chegam solicitações de teste simultâneas e o aplicativo gera erros ou opera em um estado tecnicamente não compatível. A solução é atualizar para a Enterprise (com os custos e o envolvimento da equipe de vendas associados) ou substituir a biblioteca. As equipes que chegam a esse ponto durante a fase de testes, em vez de durante a produção, têm sorte; Aqueles que o descobrirem após o lançamento enfrentarão uma migração mais urgente.IronOCR remove toda essa classe de problema — a licença $999 Lite suporta processamento de solicitações concorrentes, paralelismo em lote, Serviços Windows e funções em nuvem sem restrição.

O Imposto da Complexidade de Implantação

As equipes que operam em ambientes de implantação modernos — contêineres Docker, VMs Linux, pods Kubernetes — pagam um custo contínuo de manutenção com o Asprise que não existe com pacotes NuGet puros. Cada imagem de contêiner criada deve incluir o binário nativo correto para a arquitetura de destino. Todo pipeline de CI/CD que tenha como alvo múltiplas plataformas deve lidar com a inclusão de arquivos específicos da plataforma. A ausência de uma biblioteca nativa em um contêinerLinuxde produção é um problema detectado em tempo de execução, não um erro de compilação. Equipes que já passaram horas depurando uma DLL de 32 bits carregada em um processo de 64 bits entendem o custo disso concretamente. A implantação do IronOCR exclusivamente via NuGet elimina toda essa categoria de falhas de implantação.

O problema da documentação do Java

As equipes que desenvolvem aplicativos .NET precisam de exemplos em C#, não em Java. A documentação principal da Asprise, as referências da API e os recursos da comunidade são voltados para desenvolvedores Java. Um desenvolvedor .NET que lê a documentação da Asprise traduz a sintaxe Java, as convenções de pacotesJavae os padrões específicos doJavaem equivalentes em C# — e, às vezes, a tradução não é direta porque o wrapper .NET não expõe todos os recursos do lado do Java. A documentação, os tutoriais e os exemplos de código do IronOCR são escritos para desenvolvedores C#. O tutorial sobre leitura de texto em imagens e a central de tutoriais completa oferecem exemplos práticos em C# para cada recurso, sem sobrecarga de tradução.

A lacuna no pipeline de PDF

As equipes que processam documentos digitalizados, faturas, contratos ou formulários em formato PDF não podem usar o Asprise sem adicionar uma biblioteca de renderização de PDF ao seu grafo de dependências. Essa biblioteca de renderização introduz suas próprias considerações de licenciamento, custos de manutenção e potenciais incompatibilidades. Para equipes que precisam de OCR + PDF em uma única solução, o IronOCR oferece suporte nativo a ambos. A capacidade de criar PDFs pesquisáveis ​​a partir de dados digitalizados — um requisito comum para fluxos de trabalho de arquivamento e conformidade — não tem equivalente no Asprise em nenhum nível de licença.

A lacuna na cobertura linguística

O Asprise oferece suporte a mais de 20 idiomas de OCR. O IronOCR suporta mais de 125 softwares, cada um instalável como um pacote NuGet independente. As equipes que processam documentos em árabe, hindi, tailandês ou qualquer um dos outros idiomas suportados pelo IronOCR, mas não pelo Asprise, não têm acesso ao suporte multilíngue por meio do Asprise. O guia de múltiplos idiomas aborda a instalação e a combinação de pacotes de idiomas, incluindo o reconhecimento simultâneo em vários alfabetos.

Substituição do código do ciclo de vida do motor

A maior mudança mecânica na migração é remover o padrão de ciclo de vida do motor Asprise e substituí-lo por instância direta IronTesseract. Toda ocorrência da sequência SetUp() / StartEngine() / Recognize() / StopEngine() se torna uma única chamada 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

Para códigos sensíveis ao desempenho que processam muitos documentos sequencialmente, reutilize a instância IronTesseract em vez de criar uma nova por chamada — a inicialização do motor acarreta sobrecarga, e uma única instância usada sequencialmente é mais eficiente do que criar e descartar uma por documento.

Substituindo códigos de linguagem baseados em strings

Asprise utiliza parâmetros de string para seleção de idioma ("eng", "fra", "eng+fra").IronOCR usa um enum OcrLanguage fortemente tipado com uma API de idioma secundário. O guia de múltiplos idiomas abrange os identificadores de idioma disponíveis e os pacotes NuGet necessários para cada um:

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

Substituindo verificações de string de erro

O Asprise retorna nulo ou uma string com o prefixo "erro" quando o reconhecimento falha. O IronOCR gera exceções do .NET . Substitua verificações nulas e de prefixo de string por blocos try/catch padrão. Isso alinha o tratamento de erros de OCR com o restante do modelo de tratamento de exceções do .NET e dá acesso a rastreamentos de pilha completos e hierarquias de tipos de exceção, em vez de strings de erro analisadas.

Habilitando o processamento paralelo

Após a migração, loops em lote foreach existentes podem ser convertidos para Parallel.ForEach ou PLINQ sem qualquer preocupação de licenciamento. Para lotes de documentos que antes eram processados ​​sequencialmente em Lite/STANDARD, o paralelismo funciona como um multiplicador direto de produtividade. O guia de OCR assíncrono aborda padrões assíncronos para contextos de aplicativos web onde o OCR não bloqueante é preferível à saturação do pool de threads.