Aspose.OCR FOSS for .NET — Solução de Problemas
Esta página lista os erros e limitações mais prováveis de aparecer ao integrar Aspose.OCR FOSS para .NET, com a causa real por trás de cada um.
Exceções lançadas por Recognize()
AsposeOcr.Recognize() valida sua entrada antes que qualquer modelo seja executado. Cada verificação abaixo falha nesta ordem:
| Exception | Causa | Correção |
|---|---|---|
ArgumentNullException | O OcrInput passado para Recognize() é null | Sempre construa um OcrInput antes de chamar Recognize() |
NotSupportedException | Foi construído com um InputType diferente de SingleImage ou PDF | Apenas InputType.SingleImage e InputType.PDF são válidos |
FileNotFoundException | Um caminho adicionado via OcrInput.Add() não existe no disco | Valide cada caminho antes de chamar Add() — um arquivo ausente falha toda a chamada, não apenas esse arquivo |
Reconhecimento Não Retorna Texto
Se RecognitionResult.RecognitionText estiver vazio e RecognitionLinesResult não tiver entradas, o detector não encontrou nenhuma região de linha de texto na imagem. Isso é esperado — não é um bug — para:
- Imagens sem texto legível, ou texto que é muito pequeno, girado ou de baixo contraste para que o detector o registre como uma região
- Scripts não latinos: o modelo de reconhecimento incorporado cobre apenas texto em alfabeto latino e seus caracteres diacríticos
- Imagens nas quais as regiões detectadas foram filtradas durante o pós-processamento (pontuações de probabilidade de texto muito baixas)
Não há pontuação de confiança exposta para distinguir “nothing detected” de “detected but uncertain” — veja Escopo e Limitações.
Execução de Reconhecimento, Mas os Resultados Parecem Errados
- Texto rotacionado ou inclinado. Não há correção automática de inclinação ou rotação. Pré-rotacione a imagem de origem antes de chamar
Recognize(). - Os layouts de tabelas ou formulários parecem confusos. O detector devolve apenas retângulos de linha alinhados aos eixos — não tem conceito de colunas, tabelas ou ordem de leitura além da posição da linha. Reconstruir o layout é responsabilidade do chamador.
- A posição do texto no PDF parece deslocada. As páginas PDF são sempre renderizadas internamente a 150 DPI; as coordenadas dos retângulos em
RecognitionResult.LinesResult.Lineestão no espaço de pixels dessa imagem renderizada, não no espaço de pontos do PDF.
Problemas de Plataforma e Compilação
PlatformNotSupportedExceptionou similar em tempo de execução no Linux/macOS. O processamento de imagem depende deSystem.Drawing.Common, que é exclusivo para Windows em .NET 6 e posteriores. O caminho de processamento de imagem desta biblioteca só é executado no Windows.- A compilação falha ao direcionar
net9.0/net10.0. Construir esses alvos requer o SDK .NET 10 — veja Como compilar a partir do código-fonte. - Mixing
InputType.SingleImageandInputType.PDFem umOcrInput. Não suportado — veja Como processar em lote várias imagens.
