OCR no Azure vs. IronOCR: Qual solução de reconhecimento óptico de caracteres é a mais adequada para projetos .NET?

A pilha assíncrona WinRT

Toda operação básica de OCR com Windows.Media.Ocr exige navegar por várias camadas da API WinRT antes que o reconhecimento possa começar:

// Windows.Media.Ocr: 6+ async steps before receiving any text
// Requires net8.0-windows10.0.19041.0 TFM — will not compile cross-platform

public async Task<string> ExtractTextAsync(string imagePath)
{
    // Step 1: WinRT file system access
    var file = await StorageFile.GetFileFromPathAsync(imagePath);

    // Step 2: Open WinRT stream
    using var stream = await file.OpenAsync(FileAccessMode.Read);

    // Step 3: Create bitmap decoder
    var decoder = await BitmapDecoder.CreateAsync(stream);

    // Step 4: Decode to SoftwareBitmap
    var bitmap = await decoder.GetSoftwareBitmapAsync();

    // Step 5: Check language availability — null if not installed on this machine
    var engine = OcrEngine.TryCreateFromLanguage(
        new Windows.Globalization.Language("en-US"));
    if (engine == null)
        throw new Exception("OCR engine not available for this language");

    // Step 6: Recognize
    var result = await engine.RecognizeAsync(bitmap);
    return result.Text;
}

// Windows.Media.Ocr: 6+ async steps before receiving any text
// Requires net8.0-windows10.0.19041.0 TFM — will not compile cross-platform

public async Task<string> ExtractTextAsync(string imagePath)
{
    // Step 1: WinRT file system access
    var file = await StorageFile.GetFileFromPathAsync(imagePath);

    // Step 2: Open WinRT stream
    using var stream = await file.OpenAsync(FileAccessMode.Read);

    // Step 3: Create bitmap decoder
    var decoder = await BitmapDecoder.CreateAsync(stream);

    // Step 4: Decode to SoftwareBitmap
    var bitmap = await decoder.GetSoftwareBitmapAsync();

    // Step 5: Check language availability — null if not installed on this machine
    var engine = OcrEngine.TryCreateFromLanguage(
        new Windows.Globalization.Language("en-US"));
    if (engine == null)
        throw new Exception("OCR engine not available for this language");

    // Step 6: Recognize
    var result = await engine.RecognizeAsync(bitmap);
    return result.Text;
}

Imports System.Threading.Tasks
Imports Windows.Media.Ocr
Imports Windows.Storage
Imports Windows.Graphics.Imaging
Imports Windows.Storage.Streams
Imports Windows.Globalization

Public Async Function ExtractTextAsync(imagePath As String) As Task(Of String)
    ' Step 1: WinRT file system access
    Dim file As StorageFile = Await StorageFile.GetFileFromPathAsync(imagePath)

    ' Step 2: Open WinRT stream
    Using stream As IRandomAccessStream = Await file.OpenAsync(FileAccessMode.Read)

        ' Step 3: Create bitmap decoder
        Dim decoder As BitmapDecoder = Await BitmapDecoder.CreateAsync(stream)

        ' Step 4: Decode to SoftwareBitmap
        Dim bitmap As SoftwareBitmap = Await decoder.GetSoftwareBitmapAsync()

        ' Step 5: Check language availability — Nothing if not installed on this machine
        Dim engine As OcrEngine = OcrEngine.TryCreateFromLanguage(New Language("en-US"))
        If engine Is Nothing Then
            Throw New Exception("OCR engine not available for this language")
        End If

        ' Step 6: Recognize
        Dim result As OcrResult = Await engine.RecognizeAsync(bitmap)
        Return result.Text
    End Using
End Function

A verificação de nulidade em engine não é opcional. Se o pacote de idioma alvo não estiver instalado na máquina que executa o código, TryCreateFromLanguage retorna nulo e o reconhecimento é impossível. Não há plano B; O aplicativo deve exibir um erro para o usuário ou falhar silenciosamente.

Comparação Detalhada de Recursos

Abordagem Windows.Media.Ocr

A dependência do WinRT se manifesta no arquivo de projeto antes mesmo da execução de uma única linha de código. O TargetFramework deve especificar uma versão da plataforma Windows:

<PropertyGroup>
  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
</PropertyGroup>

<PropertyGroup>
  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
</PropertyGroup>

Com esse TFM, o projeto não pode ser usado a partir de um contêiner Linux. Uma imagemDockerbaseada em mcr.microsoft.com/dotnet/aspnet:8.0 — a imagem base padrão doLinuxpara implantações ASP.NET — não possui runtime WinRT. Tentar referenciar tipos Windows.Media.Ocr em um projeto que visa net8.0 (sem sufixo Windows) produz erros de compilação, não erros de tempo de execução. O bloqueio é imposto no momento da compilação.

Quando surgem requisitos de OCR em uma arquitetura de microsserviços onde o worker de OCR roda em Linux, ou em um pipeline de CI/CD que produz imagensDockermultiplataforma, o Windows.Media.Ocr não é uma opção a ser avaliada — ele é eliminado antes mesmo do primeiro teste.

Abordagem IronOCR

IronOCR direciona net6.0, net7.0, net8.0, e net9.0 sem TFMs específicos da plataforma. O mesmo pacote NuGet e o mesmo binário de aplicação funcionam no Windows,Linuxe macOS. Implantar IronOCR no Docker requer uma linha apt-get para libgdiplus na imagem base do Linux, nada mais:

FROM mcr.microsoft.com/dotnet/aspnet:8.0
#Linuxdependency for System.Drawing
RUN apt-get update && apt-get install -y libgdiplus

COPY --from=build /app/publish /app
WORKDIR /app
ENTRYPOINT ["dotnet", "YourApp.dll"]

O código da aplicação em si permanece inalterado entre as implementações para Windows e Linux:

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
// Não platform TFM, no WinRT, no conditional compilation
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
// Não platform TFM, no WinRT, no conditional compilation
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

Imports IronOcr

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim text As String = New IronTesseract().Read("document.jpg").Text

O IronOCR funciona diretamente em servidores AWS Lambda , Azure Functions no Linux e em servidoresLinuxsem necessidade de modificação de código. O objetivo da implantação é uma questão de configuração, não uma restrição arquitetônica.

Abordagem Windows.Media.Ocr

OcrEngine.TryCreateFromLanguage retorna nulo quando o idioma solicitado não está instalado. TryCreateFromUserProfileLanguages retorna nulo quando não existe nenhum pacote de linguagem com capacidade OCR. Ambos os caminhos exigem tratamento de valores nulos e nenhum deles oferece uma forma adequada de recuperação — não há como instalar uma linguagem a partir do código ou incluí-la no aplicativo:

// Windows.Media.Ocr: language availability is a runtime unknown
// Returns null if the language pack is not installed on this machine

var engine = OcrEngine.TryCreateFromLanguage(
    new Windows.Globalization.Language("fr-FR"));

if (engine == null)
{
    // French OCR is simply unavailable — no recovery path
    // User must go to Windows Settings > Language to install French
    throw new InvalidOperationException(
        "French OCR unavailable. Install the French language pack in Windows Settings.");
}

var result = await engine.RecognizeAsync(bitmap);

// Windows.Media.Ocr: language availability is a runtime unknown
// Returns null if the language pack is not installed on this machine

var engine = OcrEngine.TryCreateFromLanguage(
    new Windows.Globalization.Language("fr-FR"));

if (engine == null)
{
    // French OCR is simply unavailable — no recovery path
    // User must go to Windows Settings > Language to install French
    throw new InvalidOperationException(
        "French OCR unavailable. Install the French language pack in Windows Settings.");
}

var result = await engine.RecognizeAsync(bitmap);

Imports Windows.Globalization
Imports Windows.Media.Ocr

' Windows.Media.Ocr: language availability is a runtime unknown
' Returns Nothing if the language pack is not installed on this machine

Dim engine = OcrEngine.TryCreateFromLanguage(New Language("fr-FR"))

If engine Is Nothing Then
    ' French OCR is simply unavailable — no recovery path
    ' User must go to Windows Settings > Language to install French
    Throw New InvalidOperationException("French OCR unavailable. Install the French language pack in Windows Settings.")
End If

Dim result = Await engine.RecognizeAsync(bitmap)

A implantação de um aplicativo de processamento de documentos multilíngue com Windows.Media.Ocr exige a coordenação da instalação do pacote de idiomas do Windows em todas as máquinas no ambiente de destino da implantação. Em um servidor compartilhado ou em uma máquina de usuário gerenciada por Política de Grupo, isso não está sob o controle do desenvolvedor.

Abordagem IronOCR

O IronOCR fornece modelos de linguagem como pacotes NuGet dedicados que são implantados juntamente com o binário do aplicativo. Os dados de idioma são acompanhados pelo artefato de compilação, não pela configuração do sistema operacional. Suportar mais de 125 idiomas é uma operação dotnet add package:

dotnet add package IronOcr.Languages.French, IronOcr.Languages.German, IronOcr.Languages.Arabic, IronOcr.Languages.ChineseSimplified

// IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);

// Works on any machine, any OS, zero OS configuration required
var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

// IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);

// Works on any machine, any OS, zero OS configuration required
var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

Imports IronOcr

' IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.French
ocr.AddSecondaryLanguage(OcrLanguage.German)

' Works on any machine, any OS, zero OS configuration required
Dim result = ocr.Read("multilingual-document.jpg")
Console.WriteLine(result.Text)

O catálogo completo de idiomas abrange latim, CJK, árabe, hebraico, devanágari, cirílico e conjuntos especializados, incluindo notação matemática. Cada pacote de idiomas é vinculado à versão do pacote IronOCR, de modo que o modelo de linguagem em produção corresponda ao testado localmente.

Abordagem Windows.Media.Ocr

A API aceita um SoftwareBitmap e retorna o texto. O que acontece com a qualidade da imagem entre esses dois pontos não é configurável. Os desenvolvedores que precisam melhorar a precisão em entradas não ideais devem implementar o pré-processamento manualmente usando as APIs do Windows Imaging Component antes de construir o SoftwareBitmap. Trata-se de uma base de código separada, com sua própria carga de manutenção, e permanece específica para Windows pelo mesmo motivo que a própria API de OCR:

// Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
// Skewed, noisy, or low-resolution images degrade accuracy with no remedy
// Manual preprocessing via separate Windows Imaging APIs is the only option

var bitmap = await decoder.GetSoftwareBitmapAsync();
// bitmap goes directly to recognition with no quality improvement
var result = await engine.RecognizeAsync(bitmap);

// Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
// Skewed, noisy, or low-resolution images degrade accuracy with no remedy
// Manual preprocessing via separate Windows Imaging APIs is the only option

var bitmap = await decoder.GetSoftwareBitmapAsync();
// bitmap goes directly to recognition with no quality improvement
var result = await engine.RecognizeAsync(bitmap);

Imports System.Threading.Tasks

' Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
' Skewed, noisy, or low-resolution images degrade accuracy with no remedy
' Manual preprocessing via separate Windows Imaging APIs is the only option

Dim bitmap = Await decoder.GetSoftwareBitmapAsync()
' bitmap goes directly to recognition with no quality improvement
Dim result = Await engine.RecognizeAsync(bitmap)

Para digitalizações de documentos padrão e de boa qualidade (ambiente de digitalização controlado, iluminação consistente, resolução mínima de 300 DPI e orientação correta), essa limitação é administrável. Para fluxos de trabalho de processamento de documentos que recebem imagens de câmeras de celulares, scanners de mesa com desalinhamento automático de alimentação, documentos enviados por fax ou materiais fotocopiados, isso significa ou construir uma camada de pré-processamento do zero ou aceitar a degradação da precisão.

Abordagem IronOCR

A classe OcrInput do IronOCR fornece um pipeline de pré-processamento com métodos de filtro individuais que se aplicam em sequência. Os filtros de correção da qualidade da imagem abordam os principais fatores que comprometem a precisão no processamento de documentos de produção:

// IronOCR: explicit preprocessing pipeline
// Each filter targets a specific quality defect
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();              // Correct page rotation up to ~40 degrees
input.DeNoise();             // Remove scanner speckle and compression artifacts
input.Contrast();            // Boost contrast on faded or washed-out text
input.Binarize();            // Convert to black/white with optimal threshold
input.EnhanceResolution(300); // Scale image to 300 DPI for recognition

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

// IronOCR: explicit preprocessing pipeline
// Each filter targets a specific quality defect
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();              // Correct page rotation up to ~40 degrees
input.DeNoise();             // Remove scanner speckle and compression artifacts
input.Contrast();            // Boost contrast on faded or washed-out text
input.Binarize();            // Convert to black/white with optimal threshold
input.EnhanceResolution(300); // Scale image to 300 DPI for recognition

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

Imports IronOcr

' IronOCR: explicit preprocessing pipeline
' Each filter targets a specific quality defect
Using input As New OcrInput()
    input.LoadImage("low-quality-scan.jpg")

    input.Deskew()              ' Correct page rotation up to ~40 degrees
    input.DeNoise()             ' Remove scanner speckle and compression artifacts
    input.Contrast()            ' Boost contrast on faded or washed-out text
    input.Binarize()            ' Convert to black/white with optimal threshold
    input.EnhanceResolution(300) ' Scale image to 300 DPI for recognition

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

Para o caso comum, o IronOCR aplica pré-processamento automático ao chamar Read diretamente em um caminho de arquivo — o mecanismo detecta problemas de qualidade e os corrige sem configuração explícita de filtro. O tutorial de filtros de imagem cobre o conjunto completo de filtros, incluindo Sharpen, Dilate, Erode, Invert, e ToGrayScale para cenários especializados. Os filtros de correção de cor e a correção de orientação ampliam ainda mais o fluxo de trabalho para documentos com perfis de cores não padronizados ou rotação em vários ângulos.

Abordagem Windows.Media.Ocr

Não existe um caminho para PDF na API. Para fazer OCR em um PDF digitalizado com Windows.Media.Ocr, o desenvolvedor deve: renderizar cada página em um SoftwareBitmap usando uma biblioteca separada de renderização de PDF (nenhuma das quais está integrada ao Windows), iterar páginas, chamar RecognizeAsync por página e concatenar os resultados manualmente. Essa biblioteca de renderização em si acarreta considerações adicionais de licenciamento e implantação. O código Windows.Media.Ocr representa a menor parte da implementação total:

// Windows.Media.Ocr: no PDF support
// Requires external PDF renderer to rasterize pages before OCR
// Conceptual pattern — a PDF rendering library is not provided by Windows APIs

// Step 1: Use external PDF library to render page to bitmap (not shown)
// Step 2: Pass rendered bitmap to Windows OCR
// var bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex); // external library required

var engine = OcrEngine.TryCreateFromUserProfileLanguages();
if (engine == null)
    throw new Exception("No OCR language available");

// Step 3: Recognize the rasterized page
// var result = await engine.RecognizeAsync(bitmap);
// Step 4: Collect and concatenate results across all pages manually

// Windows.Media.Ocr: no PDF support
// Requires external PDF renderer to rasterize pages before OCR
// Conceptual pattern — a PDF rendering library is not provided by Windows APIs

// Step 1: Use external PDF library to render page to bitmap (not shown)
// Step 2: Pass rendered bitmap to Windows OCR
// var bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex); // external library required

var engine = OcrEngine.TryCreateFromUserProfileLanguages();
if (engine == null)
    throw new Exception("No OCR language available");

// Step 3: Recognize the rasterized page
// var result = await engine.RecognizeAsync(bitmap);
// Step 4: Collect and concatenate results across all pages manually

' Windows.Media.Ocr: no PDF support
' Requires external PDF renderer to rasterize pages before OCR
' Conceptual pattern — a PDF rendering library is not provided by Windows APIs

' Step 1: Use external PDF library to render page to bitmap (not shown)
' Step 2: Pass rendered bitmap to Windows OCR
' Dim bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex) ' external library required

Dim engine = OcrEngine.TryCreateFromUserProfileLanguages()
If engine Is Nothing Then
    Throw New Exception("No OCR language available")
End If

' Step 3: Recognize the rasterized page
' Dim result = Await engine.RecognizeAsync(bitmap)
' Step 4: Collect and concatenate results across all pages manually

A etapa de renderização externa de PDF por si só adiciona uma dependência, uma curva de aprendizado separada e uma superfície de falha adicional ao que começou como uma solução "gratuita e integrada".

Abordagem IronOCR

O IronOCR lê PDFs nativamente. Sem renderizador externo, sem etapa de rasterização, sem montagem manual de páginas. O mesmo método IronTesseract.Read que aceita caminhos de imagem aceita caminhos de PDF. O OCR de PDF em .NET é feito em uma única linha:

// IronOCR: native PDF support — no external renderer needed
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// Password-protected PDFs
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// PDF pesquisável output: make a scanned PDF text-searchable
var ocrResult = new IronTesseract().Read("scanned-archive.pdf");
ocrResult.SaveAsSearchablePdf("searchable-output.pdf");

// IronOCR: native PDF support — no external renderer needed
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// Password-protected PDFs
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// PDF pesquisável output: make a scanned PDF text-searchable
var ocrResult = new IronTesseract().Read("scanned-archive.pdf");
ocrResult.SaveAsSearchablePdf("searchable-output.pdf");

Imports IronOcr

' IronOCR: native PDF support — no external renderer needed
Dim text = New IronTesseract().Read("scanned-document.pdf").Text

' Password-protected PDFs
Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password:="secret")
    Dim result = New IronTesseract().Read(input)
    Console.WriteLine(result.Text)
End Using

' PDF pesquisável output: make a scanned PDF text-searchable
Dim ocrResult = New IronTesseract().Read("scanned-archive.pdf")
ocrResult.SaveAsSearchablePdf("searchable-output.pdf")

O recurso de PDF pesquisável incorpora uma camada de texto sobre a imagem digitalizada original, produzindo um PDF que preserva a fidelidade visual e permite a pesquisa de texto completo e o copiar e colar. Este é um requisito comum para sistemas de gestão documental e arquivos de conformidade. O Windows.Media.Ocr não consegue produzir essa saída em nenhuma camada de sua API.

O aplicativo ultrapassa os limites da área de trabalho do Windows.

O fator desencadeante mais comum é uma alteração nos requisitos que introduz um ambiente de implantação que não seja o Windows. Um utilitário de desktop que começa como uma ferramenta interna do Windows é promovido a um serviço web, um microsserviço baseado emDockerou uma função em nuvem. Não momento em que isso acontece, o Windows.Media.Ocr se torna um bloqueador. O componente OCR requer uma reescrita completa porque a API não existe na plataforma de destino — não há porta, nem shim de compatibilidade, nem flag de compilação condicional que corrija o problema. As equipes que se planejaram com antecedência usando o IronOCR não precisarão refazer essa reescrita.

Os requisitos de idioma excedem os pacotes instalados.

Os fluxos de processamento de documentos frequentemente expandem seu escopo. Um sistema desenvolvido para processar faturas em inglês recebe a exigência de também lidar com documentos em francês, alemão, árabe ou japonês. Com o Windows.Media.Ocr, o suporte a esses idiomas exige a coordenação da instalação do pacote de idiomas do sistema operacional em todos os destinos de implantação — máquinas de desenvolvimento, VMs de teste, servidores de produção e quaisquer contêineres envolvidos. Em ambientes gerenciados por Política de Grupo ou em VMs na nuvem com infraestrutura de sistema operacional mínima, essa coordenação é impraticável. Os pacotes de idiomas do IronOCR baseados em NuGet são instalados juntamente com o aplicativo e não exigem nenhuma configuração do sistema operacional.

O processamento de PDF foi adicionado ao escopo.

Quando o requisito original era "OCR de imagens de um scanner de mesa", o Windows.Media.Ocr funciona. Quando a exigência se expande para "processar também o acúmulo de PDFs digitalizados em nosso arquivo", uma segunda biblioteca entra em cena. Essa biblioteca representa uma dependência adicional, uma consideração adicional em relação ao licenciamento e uma superfície de falha adicional. Equipes que precisam de OCR tanto para imagens quanto para PDFs em uma API unificada descobrem que o IronOCR elimina a arquitetura de duas bibliotecas desde o início.

A precisão se degrada com dados do mundo real.

Ambientes de digitalização controlados produzem imagens nítidas. Dados do mundo real — fotos tiradas com celulares, digitalizações de mesa levemente distorcidas, documentos antigos recebidos por fax, materiais fotocopiados — produzem uma degradação da precisão que não pode ser corrigida no Windows.Media.Ocr. Quando começam a chegar reclamações de clientes sobre mensagens de texto não enviadas, as equipes descobrem que a etapa de pré-processamento que haviam ignorado se tornou necessária. A adaptação do pré-processamento usando as APIs de Imagem do Windows exige um esforço de desenvolvimento considerável, o que mantém a solução exclusiva para Windows. O pipeline de pré-processamento do IronOCR já está pronto.

Surge a questão da implantação do servidor.

A documentação do Windows.Media.Ocr posiciona explicitamente a API para aplicativos cliente. Executar isso em um contexto de servidor — um aplicativo ASP.NET processando documentos enviados pelo usuário, um serviço do Windows consumindo uma fila de documentos — requer um ambiente Servidor Windows com a Experiência Desktop instalada, que é um perfil de máquina virtual mais pesado e caro do que um contêiner Linux. Quando a equipe de infraestrutura pergunta se o processo de OCR pode ser executado em uma instânciaLinuxpara reduzir os custos de hospedagem, a resposta com o Windows.Media.Ocr é não.

Alteração do arquivo de projeto TFM

Windows.Media.Ocr requer um TFM específico para Windows no arquivo de projeto (net8.0-windows10.0.19041.0 ou similar). Remover essa dependência para dar suporte a plataformas cruzadas significa remover o sufixo TFM.IronOCR direciona net6.0, net8.0, e net9.0 sem sufixos específicos para Windows. Ao migrar, confirme se nenhuma outra dependência da API WinRT no projeto requer o TFM do Windows — outros recursos da plataforma Windows (integração com o shell, notificações do Windows, etc.) podem precisar ser abstraídos por meio de verificações de plataforma.

Migração de assíncrono para síncrono

Windows.Media.Ocr é totalmente assíncrono — RecognizeAsync retorna IAsyncOperation<OcrResult> que mapeia para Task<OcrResult> via interop WinRT.IronOCR fornece caminhos síncronos e assíncronos. O ocr.Read("file.jpg") síncrono substitui diretamente a cadeia de espera multistep. Para aplicações de servidor onde a chamada OCR reside dentro de um serviço em segundo plano ou um pipeline baseado em tarefas, o caminho assíncrono também está disponível. De qualquer forma, a transição de 6 ou mais etapas assíncronas para 1 chamada é simples:

// Before: Windows.Media.Ocr — 6+ await operations
var file = await StorageFile.GetFileFromPathAsync(imagePath);
using var stream = await file.OpenAsync(FileAccessMode.Read);
var decoder = await BitmapDecoder.CreateAsync(stream);
var bitmap = await decoder.GetSoftwareBitmapAsync();
var engine = OcrEngine.TryCreateFromUserProfileLanguages();
var winResult = await engine.RecognizeAsync(bitmap);
string text = winResult.Text;

// After:IronOCR— 1 call, same result, any platform
string text = new IronTesseract().Read(imagePath).Text;

// Before: Windows.Media.Ocr — 6+ await operations
var file = await StorageFile.GetFileFromPathAsync(imagePath);
using var stream = await file.OpenAsync(FileAccessMode.Read);
var decoder = await BitmapDecoder.CreateAsync(stream);
var bitmap = await decoder.GetSoftwareBitmapAsync();
var engine = OcrEngine.TryCreateFromUserProfileLanguages();
var winResult = await engine.RecognizeAsync(bitmap);
string text = winResult.Text;

// After:IronOCR— 1 call, same result, any platform
string text = new IronTesseract().Read(imagePath).Text;

Imports Windows.Storage
Imports Windows.Graphics.Imaging
Imports Windows.Media.Ocr

' Before: Windows.Media.Ocr — 6+ await operations
Dim file As StorageFile = Await StorageFile.GetFileFromPathAsync(imagePath)
Using stream = Await file.OpenAsync(FileAccessMode.Read)
    Dim decoder As BitmapDecoder = Await BitmapDecoder.CreateAsync(stream)
    Dim bitmap = Await decoder.GetSoftwareBitmapAsync()
    Dim engine = OcrEngine.TryCreateFromUserProfileLanguages()
    Dim winResult = Await engine.RecognizeAsync(bitmap)
    Dim text As String = winResult.Text
End Using

' After: IronOCR— 1 call, same result, any platform
Dim text As String = New IronTesseract().Read(imagePath).Text

Substituição do pacote de idiomas

Para cada idioma anteriormente resolvido por OcrEngine.TryCreateFromLanguage(new Windows.Globalization.Language("fr-FR")), instale o pacote de idioma correspondente do IronOCR e configure ocr.Language = OcrLanguage.French. O catálogo de idiomas do IronOCR lista todos os mais de 125 pacotes disponíveis. Os códigos de idioma mapeiam de forma simples de tags BCP-47 para o enumerador OcrLanguage.

Remoção do manuseio nulo do motor

O Windows.Media.Ocr exige a verificação de valores nulos em todas as chamadas de criação do mecanismo. O IronOCR lança exceções estruturadas em vez de retornar nulo em caso de falhas de configuração ou inicialização. Remova as cláusulas de verificação de nulo e substitua-as pelo tratamento de exceções padrão, quando necessário. O resultado é um site de chamadas mais limpo, sem o modo de falha de "idioma indisponível silenciosamente".