Núcleo API

API de núcleo

Esta página cobre o ciclo de vida dos objetos e o comportamento de exceções dos quatro tipos principais: AsposeOcr, OcrInput, OcrOutput e RecognitionResult.

Ciclo de vida do OcrInput

OcrInput implementa IDisposable e deve ser criado em uma declaração using. Seu construtor recebe um InputType (InputType.SingleImage ou InputType.PDF), e OcrInput.Add(string) enfileira um caminho de arquivo por vez — a mesma instância OcrInput pode conter vários arquivos desse mesmo tipo de entrada.

using Aspose.OCR;

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

Reconhecendo e lendo OcrOutput

AsposeOcr.Recognize(OcrInput) retorna um OcrOutput, que é um List<RecognitionResult> — indexável como qualquer lista, com um RecognitionResult por imagem (para InputType.SingleImage, um por arquivo adicionado) ou por página PDF (para InputType.PDF).

var api = new AsposeOcr();
OcrOutput output = api.Recognize(input);
RecognitionResult first = output[0];

RecognitionResult e o Tipo LinesResult Aninhado

RecognitionResult.LinesResult é uma classe aninhada — referencie-a como RecognitionResult.LinesResult, não como um tipo independente. Cada RecognitionResult expõe:

• RecognitionText — o texto reconhecido completo para essa imagem ou página, com linhas unidas por quebras de linha.
• RecognitionLinesResult — um List<RecognitionResult.LinesResult>, uma entrada por linha de texto detectada, cada uma com TextInLine (o texto da linha) e Line (um System.Drawing.Rectangle que fornece as coordenadas de pixel dessa linha na imagem de origem).

RecognitionResult result = output[0];
Console.WriteLine(result.RecognitionText);

foreach (RecognitionResult.LinesResult line in result.RecognitionLinesResult)
{
    System.Drawing.Rectangle bounds = line.Line;
    Console.WriteLine($"x={bounds.X}, y={bounds.Y}: {line.TextInLine}");
}

Exceções

AsposeOcr.Recognize(OcrInput) valida sua entrada antes de executar o reconhecimento:

Essas verificações são executadas antes de qualquer inferência de modelo, portanto uma entrada inválida falha imediatamente em vez de após uma passagem parcial de reconhecimento.

Dicas e Melhores Práticas

• OcrOutput está vazio (Count == 0) se OcrInput não tem arquivos adicionados — verifique Count antes da indexação.
• RecognitionResult.LinesResult está aninhado dentro de RecognitionResult; o nome do tipo de nível superior LinesResult sozinho não é um tipo resolvível fora desse aninhamento.

Problemas Comuns

FAQ

É RecognitionResult.LinesResult uma classe de nível superior própria?

Não — está aninhado dentro de RecognitionResult. Referencie-o como RecognitionResult.LinesResult.

O OcrOutput garante a ordem das páginas para PDFs?

Sim — para InputType.PDF, OcrOutput devolve um RecognitionResult por página na ordem original.

O que acontece se eu chamar Recognize() com um OcrInput vazio?

Ele retorna um OcrOutput com Count == 0 ao invés de lançar.

API Reference Resumo

Ver também

• Aspose.OCR — Enterprise Documentation