Aspose.OCR FOSS for .NET — Perguntas Frequentes
Licenciamento & Código Aberto
Qual é o modelo de licenciamento?
Aspose.OCR FOSS para .NET é lançado sob a MIT License. Você pode usar, modificar e redistribuir — inclusive em produtos comerciais — sem taxas de licenciamento adicionais.
Posso usá-lo em produtos comerciais?
Sim. A MIT License permite uso comercial, modificação e redistribuição, desde que o aviso de direitos autorais original e o texto da licença sejam mantidos.
Instalação & Requisitos
Como instalo Aspose.OCR FOSS para .NET?
dotnet add package Aspose.OCR.FOSSEle tem como alvo o .NET Standard 2.0, .NET Framework 4.8 e .NET 8.0 ou posterior.
Existem dependências nativas ou externas?
Depende de Aspose.PDF.FOSS (para renderizar páginas PDF), Microsoft.ML.OnnxRuntime (para executar os modelos de reconhecimento incorporados) e System.Drawing.Common (para decodificação de imagens — apenas Windows para processamento de imagens). Nenhum serviço OCR externo é necessário; todos os três modelos ONNX estão incorporados na assembly.
Escopo de Reconhecimento
Quais idiomas ele reconhece?
Texto em alfabeto latino. Não há parâmetro de seleção de idioma, e scripts não latinos não são cobertos pelo modelo de reconhecimento incorporado.
Quais tipos de entrada são suportados?
Apenas InputType.SingleImage e InputType.PDF. Construir um OcrInput com qualquer outro tipo de entrada faz com que AsposeOcr.Recognize() lance NotSupportedException.
Ele retorna algo além do texto reconhecido?
Sim. Cada RecognitionResult também retorna RecognitionLinesResult — uma lista de RecognitionResult.LinesResult, cada uma com o texto da linha (TextInLine) e sua caixa delimitadora em coordenadas de pixel (Line, um System.Drawing.Rectangle).
API Usage
Qual é o padrão típico de reconhecimento?
Construa um AsposeOcr, crie um OcrInput com o InputType apropriado, adicione um ou mais arquivos com OcrInput.Add() e chame AsposeOcr.Recognize(). O OcrOutput retornado contém um RecognitionResult por imagem ou página PDF.
using Aspose.OCR;
var api = new AsposeOcr();
using var input = new OcrInput(InputType.SingleImage);
input.Add("scan.png");
RecognitionResult result = api.Recognize(input)[0];
Console.WriteLine(result.RecognitionText);Posso reconhecer vários arquivos em uma única chamada?
Sim. Adicione vários arquivos ao mesmo OcrInput antes de chamar Recognize(). OcrOutput preserva a ordem em que os arquivos foram adicionados.
Limitações Conhecidas
O Recognize() valida sua entrada?
Sim. Ele lança ArgumentNullException para uma entrada null, NotSupportedException para um InputType não suportado, e FileNotFoundException se um caminho enfileirado não existir — antes que qualquer inferência de modelo seja executada.
