Pular para o conteúdo principal
Este método abre o arquivo de imagem especificado, realiza seu pré-processamento, a análise de layout, o reconhecimento, a síntese da página e do documento, e exporta o texto reconhecido para o formato de saída selecionado. O método RecognizeImageFile pode processar imagens com várias páginas e exportar os resultados do reconhecimento para um único arquivo.

​
Sintaxe

​
C++

HRESULT RecognizeImageFile(
  BSTR                         ImageFileName,
  IPrepareImageMode            PrepareMode,
  IDocumentProcessingParams*   DocumentProcessingParams,
  FileExportFormatEnum         ExportFormat,
  IUnknown*                    ExportParams,
  IImagePasswordCallback*      PasswordCallback,
  BSTR                         OutputFileName
);

​
C#

void RecognizeImageFile(
  string                   ImageFileName,
  IPrepareImageMode         PrepareMode,
  IDocumentProcessingParams DocumentProcessingParams,
  FileExportFormatEnum     ExportFormat,
  object                   ExportParams,
  IImagePasswordCallback   PasswordCallback,
  string                   OutputFileName
);

​
Visual Basic .NET

Sub RecognizeImageFile( _
  ImageFileName As String, _
  PrepareMode As IPrepareImageMode, _
  DocumentProcessingParams As IDocumentProcessingParams, _
  ExportFormat As IFileExportFormatEnum, _
  ExportParams As Object, _
  PasswordCallback As IImagePasswordCallback, _
  OutputFileName As String _
)

​
Parâmetros

ImageFileName [in] Contém o caminho completo para um arquivo de imagem a ser reconhecido. Se esse arquivo não estiver no formato interno do ABBYY FineReader Engine, ele será preparado usando os valores padrão das propriedades de PrepareImageMode ou, se um profile tiver sido carregado, serão usados os parâmetros definidos por esse profile. PrepareMode [in] Essa variável se refere ao objeto PrepareImageMode, que armazena os parâmetros para conversão da imagem para o formato interno. Esse parâmetro pode ser 0; nesse caso, são usados os parâmetros padrão do modo de preparação da imagem ou, se um profile tiver sido carregado, serão usados os parâmetros definidos por esse profile. DocumentProcessingParams [in] Refere-se ao objeto DocumentProcessingParams, que armazena todos os parâmetros de processamento. Esse parâmetro pode ser 0. Nesse caso, o documento é processado usando os parâmetros padrão (todos os parâmetros de processamento são definidos com os valores padrão, e o idioma de reconhecimento é inglês) ou, se um profile tiver sido carregado, serão usados os parâmetros definidos por esse profile. ExportFormat [in] Essa variável do tipo FileExportFormatEnum especifica o formato do arquivo de saída para o qual o texto reconhecido é exportado. ExportParams [in] Passe, por meio desse parâmetro de entrada, o objeto de parâmetros de exportação do tipo correspondente ao formato do seu arquivo. Por exemplo, se você estiver criando um arquivo RTF, crie o objeto RTFExportParams, defina nele os parâmetros necessários e passe-o para este método como o parâmetro de entrada exporterParams. Esse parâmetro é opcional e pode ser 0; nesse caso, os parâmetros de exportação terão valores padrão ou, se um profile tiver sido carregado, serão usados os parâmetros definidos por esse profile.
No Linux, se você estiver trabalhando com o ABBYY FineReader Engine carregado fora do processo, deverá passar NULL para esse parâmetro.
PasswordCallback [in] Refere-se à interface do objeto implementado pelo usuário, do tipo ImagePasswordCallback, que é usada para tratar possíveis solicitações de senha para acessar imagens em formato PDF. Esse parâmetro é opcional e pode ser 0; nesse caso, arquivos protegidos por senha não podem ser processados. OutputFileName [in] Contém o caminho completo para o arquivo de saída no qual o texto reconhecido deve ser exportado. Se já existir um arquivo nesse local, ele será sobrescrito sem aviso, ou o texto reconhecido será anexado ao final dele, dependendo do modo de exportação.

​
Valores de retorno

Se o reconhecimento for interrompido pelo usuário, este método retornará E_ABORT. Se o treinamento de padrões for interrompido pelo usuário, este método retornará FREN_E_PATTERN_TRAINING_ABORTED. Este método também retorna os códigos de retorno padrão das funções do ABBYY FineReader Engine.

​
Observações

Para Linux e Windows: dependendo do valor da propriedade IEngine::MultiProcessingParams, o ABBYY FineReader Engine pode distribuir o processamento de documentos com várias páginas pelos núcleos da CPU.

​
Veja também

Engine IImagePasswordCallback Como trabalhar com perfis