Visão geral dos recursos

Visão geral dos recursos

Esta página apresenta o API de reconhecimento da biblioteca e as capacidades abordadas em detalhes em outra parte deste guia. AsposeOcr é o ponto de entrada para toda a biblioteca. Seu método Recognize() aceita um OcrInput e retorna um OcrOutput — uma lista de RecognitionResult, um por imagem ou página de PDF.

Reconhecimento de imagem única e PDF

OcrInput é construído com um InputType — InputType.SingleImage para uma imagem raster, ou InputType.PDF para um documento PDF. Os arquivos são enfileirados com OcrInput.Add(). Descartar OcrInput apenas limpa os caminhos de arquivos enfileirados que ele contém.

using Aspose.OCR;

var api = new AsposeOcr();
using var input = new OcrInput(InputType.PDF);
input.Add("document.pdf");
OcrOutput output = api.Recognize(input);

Resultados do reconhecimento

Cada RecognitionResult expõe RecognitionText (o texto completo da página reconhecida) e RecognitionLinesResult (uma lista de RecognitionResult.LinesResult, cada um com TextInLine e uma caixa delimitadora System.Drawing.Rectangle em Line).

foreach (RecognitionResult page in output)
{
    Console.WriteLine(page.RecognitionText);
    foreach (RecognitionResult.LinesResult line in page.RecognitionLinesResult)
    {
        Console.WriteLine($"{line.Line}: {line.TextInLine}");
    }
}

Processamento em lote

OcrInput aceita mais de um arquivo do mesmo tipo de entrada. OcrOutput preserva a ordem em que os arquivos foram adicionados, com um RecognitionResult por arquivo (ou por página de PDF).

using var input = new OcrInput(InputType.SingleImage);
input.Add("page-1.jpg");
input.Add("page-2.png");
OcrOutput output = api.Recognize(input);

Dicas e Melhores Práticas

• Libere OcrInput (ou envolva-o em uma instrução using) assim que o reconhecimento for concluído para liberar os recursos subjacentes.
• Somente InputType.SingleImage e InputType.PDF são suportados — qualquer outro tipo de entrada gera NotSupportedException.
• O reconhecimento aceita apenas scripts latinos; não há parâmetro de seleção de idioma.
• As páginas PDF são renderizadas internamente antes do reconhecimento, portanto não é necessária uma etapa separada de conversão PDF-para-imagem.

Problemas Comuns

FAQ

Quais idiomas o Aspose.OCR FOSS para .NET reconhece?

Texto em alfabeto latino. O modelo de reconhecimento incorporado não cobre scripts não latinos.

Ele requer conexão à internet?

Não. Todos os três modelos ONNX (detecção, refinamento, reconhecimento) estão incorporados na assembly e são executados localmente através do Microsoft.ML.OnnxRuntime.

Posso reconhecer vários arquivos em uma única chamada?

Sim — adicione vários arquivos ao mesmo OcrInput antes de chamar AsposeOcr.Recognize(). O OcrOutput retornado preserva a ordem deles.

Em quais plataformas isso funciona?

Ele tem como alvo .NET Standard 2.0, .NET Framework 4.8 e .NET 8.0+. O processamento de imagens requer Windows, porque depende do System.Drawing.Common.

API Reference Resumo

Ver também

• Aspose.OCR — Enterprise Documentation