Tutorial do CodeProject sobre OCR em C#: Extrair texto de imagens com IronOCR

Como Você Instala o IronOCR em um Projeto .NET?

A maneira mais rápida de adicionar OCR a um projeto .NET 10 é através do Gerenciador de Pacotes NuGet. Abra um terminal no diretório do seu projeto e execute o comando CLI do dotnet, ou use o Console do Gerenciador de Pacotes dentro do Visual Studio:

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

Após a instalação, o gerenciador de pacotes NuGet baixa todas as assemblies necessárias e configura as referências automaticamente. IronOCR tem como alvo .NET Framework 4.6.2+, .NET Core 3.1+ e .NET 5 até .NET 10, de modo que funciona em aplicativos de console, serviços ASP.NET Core, aplicações WPF e Funções do Azure.

Você não precisa registrar uma chave de licença para testar localmente -- uma marca d'água de teste aparecerá na saída até que uma licença seja aplicada. Adicione a diretiva using e, quando estiver pronto para produção, passe sua chave uma vez na inicialização:

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

Veja a página de licenciamento do IronOCR para detalhes de preços e ativação.

Como Extrair Texto de um Arquivo de Imagem?

O fluxo de trabalho principal do OCR envolve três objetos: IronTesseract (o motor), OcrInput (o contêiner de entrada) e OcrResult (a saída). O exemplo abaixo lê um PNG e imprime o texto reconhecido no console.

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

Como Processar Documentos Escaneados e Arquivos TIFF?

Arquivos TIFF de múltiplas páginas são comuns em fluxos de trabalho de digitalização de documentos. O IronOCR os trata com LoadImageFrames, que permite escolher exatamente quais frames (páginas) processar -- útil quando você só precisa de um subconjunto de um grande arquivo.

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}:");
    Console.WriteLine(page.Text);
}

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}:");
    Console.WriteLine(page.Text);
}

Como Configurar o Suporte a Idiomas para OCR?

Por padrão, IronOCR lê texto em inglês. Para processar documentos em outros idiomas, instale o pacote de idioma NuGet correspondente e defina a propriedade Language na instância de IronTesseract.

dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.Japanese

dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.Japanese

Depois configure o motor e, para documentos bilíngues, adicione um idioma secundário:

using IronOcr;
using IronOcr.Languages;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.German;

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronOcr.Languages;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.German;

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

IronOCR suporta mais de 125 idiomas, cada um distribuído como um pacote NuGet leve separado. Isso mantém seu binário de produção pequeno -- somente os dados de idioma que sua aplicação realmente precisa estão incluídos. O motor mistura modelos de linguagem primária e secundária durante o reconhecimento quando você chama AddSecondaryLanguage.

Como Lidar com Erros de OCR e Melhorar Resultados de Reconhecimento?

Aplicações de produção precisam de tratamento de erros em torno do pipeline OCR. Problemas de qualidade de imagem, arquivos ausentes ou formatos não suportados podem causar exceções. Envolver a chamada em um bloco try/catch fornece um caminho limpo para recuperação.

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

Algumas configurações adicionais que ajudam quando a precisão é menor que a esperada:

• ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto -- permite que o Tesseract escolha automaticamente entre layouts de coluna única, múltiplas colunas e palavra única
• ocr.Configuration.ReadBarCodes = false -- desativa a detecção de código de barras se você estiver processando documentos apenas de texto e desejar um processamento mais rápido
• ocr.Configuration.TesseractVersion = TesseractVersion.Tesseract5 -- garante que você use o motor mais rápido disponível

Para formulários estruturados onde os campos aparecem em posições previsíveis, use OCR baseado em região para ler apenas as áreas que importam:

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

Limitar o reconhecimento a um retângulo de corte reduz o tempo de processamento em até 90% em imagens grandes. Esta técnica é bem adequada para extração de números de faturas, leitura de campos de formulários e digitalização de documentos de identidade. Mais detalhes estão disponíveis no guia de como fazer OCR de região.

Como criar um PDF pesquisável a partir de texto reconhecido?

Converter arquivos de imagem digitalizada em PDFs pesquisáveis é um dos casos de uso de maior valor do OCR. O arquivo resultante preserva a aparência visual original enquanto incorpora uma camada de texto invisível que visualizadores de PDF, motores de busca e leitores de tela podem indexar.

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

Como ler códigos de barras junto com texto?

IronOCR pode ler códigos de barras e QR incorporados na mesma imagem que o texto impresso, eliminando a necessidade de executar uma biblioteca de código de barras separada. Habilite o recurso com uma propriedade de configuração:

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

Console.WriteLine("Barcodes:");
foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"  {barcode.Format}: {barcode.Value}");
}

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

Console.WriteLine("Barcodes:");
foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"  {barcode.Format}: {barcode.Value}");
}

Os formatos de código de barras suportados incluem Code 128, Code 39, EAN-13, EAN-8, UPC-A, UPC-E, PDF417, Data Matrix e QR Code. Detalhes completos estão no guia de leitura de códigos de barras do IronOCR.

Esta capacidade é particularmente útil em aplicações de logística, saúde e varejo, onde etiquetas de envio, pulseiras de pacientes e etiquetas de produtos contêm tanto texto legível por humanos quanto códigos de barras legíveis por máquinas.

Como você compara IronOCR com outras opções de OCR for .NET?

Desenvolvedores avaliando bibliotecas de OCR for .NET tipicamente consideram IronOCR, Tesseract.NET e serviços em nuvem como Google Cloud Vision ou Azure Computer Vision. A tabela abaixo resume as principais diferenças:

Tesseract, mantido pelo Google como um projeto de código aberto, alimenta tanto o IronOCR quanto o Tesseract.NET por trás. IronOCR adiciona empacotamento idiossincrático for .NET, gerenciamento automático de modelos e os recursos de saída de produção (PDF pesquisável, exportação hOCR) que as ligações Tesseract puras não possuem. Azure Computer Vision oferece precisão de nuvem de última geração, mas introduz latência de rede e custos por chamada que são inadequados para fluxos de trabalho de alto volume ou offline.

Para cenários onde regulamentos de privacidade de dados proíbem o envio de documentos para serviços externos -- registros de saúde, documentos legais, extratos financeiros -- uma biblioteca no local como IronOCR é a escolha apropriada.

Quais são os seus próximos passos?

Agora você tem os blocos de construção para adicionar OCR a qualquer aplicação .NET 10: instalação via NuGet, extração básica de imagem para texto, processamento de TIFF de várias páginas, configuração de idiomas, tratamento de erros, leitura baseada em região, detecção de código de barras e geração de PDFs pesquisáveis.

Para se aprofundar, explore esses recursos do IronOCR:

• Documentação do IronOCR -- referência completa da API e guias de recursos
• Tutorial de filtro de imagem -- guia detalhado de todos os filtros de pré-processamento
• Guia de leitura de códigos de barras -- Códigos QR e códigos de barras lineares junto com texto
• Como fazer OCR de uma região -- reconhecimento baseado em corte para formulários e IDs
• Referência de idiomas -- lista completa de mais de 125 idiomas suportados
• Referência da API -- todas as classes, métodos e propriedades

Para perguntas sobre licenciamento ou implantar o IronOCR em um ambiente de produção, visite a página de licenciamento do IronOCR. Uma licença de teste gratuita remove marcas d'água de saída durante o seu período de avaliação, e a equipe de suporte da Iron Software está disponível para perguntas técnicas em qualquer nível.

!{--010011000100100101000010010100100100000101010010010110010101111101000111010001010101010100010111110101001101010100010000010101001001010100010001010100010001011111010101110100100 101010100010010000101111101010000010100100111101000100010101010100001101010100010111110101010001010010010010010010010100000101001100010111110100001001001100010011110100001101001011--}