Saltar al contenido principal
Este método abre el archivo de imagen especificado, realiza su preprocesamiento, el análisis de diseño, el reconocimiento, la síntesis de páginas y documentos, y exporta el texto reconocido al formato de salida seleccionado. El método RecognizeImageFile puede procesar imágenes de varias páginas y exportar los resultados del reconocimiento a un único archivo.

​
Sintaxis

​
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] Contiene la ruta completa a un archivo de imagen que se va a reconocer. Si este archivo no está en el formato interno de ABBYY FineReader Engine, se prepara con los valores predeterminados de las propiedades de PrepareImageMode o, si se ha cargado un perfil, se usan los parámetros definidos en ese perfil. PrepareMode [in] Esta variable hace referencia al objeto PrepareImageMode, que almacena los parámetros para convertir imágenes al formato interno. Este parámetro puede ser 0, en cuyo caso se usan los parámetros predeterminados del modo de preparación de imágenes o, si se ha cargado un perfil, se usan los parámetros definidos en ese perfil. DocumentProcessingParams [in] Hace referencia al objeto DocumentProcessingParams, que almacena todos los parámetros de procesamiento. Este parámetro puede ser 0. En ese caso, el documento se procesa con los parámetros predeterminados (todos los parámetros de procesamiento se establecen en sus valores predeterminados y el idioma de reconocimiento es inglés) o, si se ha cargado un perfil, se usan los parámetros definidos en ese perfil. ExportFormat [in] Esta variable, de tipo FileExportFormatEnum, especifica el formato del archivo de salida al que se exporta el texto reconocido. ExportParams [in] Pase mediante este parámetro de entrada el objeto de parámetros de exportación del tipo correspondiente al formato de archivo. Por ejemplo, si va a crear un archivo RTF, cree el objeto RTFExportParams, configure en él los parámetros necesarios y páselo a este método como parámetro de entrada exporterParams. Este parámetro es opcional y puede ser 0, en cuyo caso los parámetros de exportación toman sus valores predeterminados o, si se ha cargado un perfil, se usan los parámetros definidos en ese perfil.
En Linux, si está trabajando con ABBYY FineReader Engine cargado fuera del proceso, debe pasar NULL para este parámetro.
PasswordCallback [in] Hace referencia a la interfaz del objeto implementado por el usuario de tipo ImagePasswordCallback, que se usa para gestionar posibles solicitudes de contraseña al acceder a imágenes en formato PDF. Este parámetro es opcional y puede ser 0, en cuyo caso no se podrán procesar archivos protegidos con contraseña. OutputFileName [in] Contiene la ruta completa del archivo de salida al que debe exportarse el texto reconocido. Si ya existe un archivo en esa ubicación, se sobrescribirá sin aviso o se añadirá el texto reconocido al final, según el modo de exportación.

​
Valores devueltos

Si el reconocimiento es interrumpido por el usuario, este método devuelve E_ABORT. Si el entrenamiento de patrones es interrumpido por el usuario, este método devuelve FREN_E_PATTERN_TRAINING_ABORTED. También devuelve los códigos de retorno estándar de las funciones de ABBYY FineReader Engine.

​
Notas

En Linux y Windows: según el valor de la propiedad IEngine::MultiProcessingParams, ABBYY FineReader Engine puede distribuir el procesamiento de documentos de varias páginas entre los núcleos del CPU.

​
Consulte también

Engine IImagePasswordCallback Trabajar con perfiles