> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Método RecognizeImageFile del objeto Engine

> Método RecognizeImageFile del objeto Engine en la API de ABBYY FineReader Engine: este método abre un archivo de imagen, realiza el preprocesamiento, el análisis de diseño, el reconocimiento, la síntesis de páginas y documentos, y exporta el resultado en el formato de salida seleccionado.

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.

<div id="syntax">
  ## Sintaxis
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT RecognizeImageFile(
  BSTR                         ImageFileName,
  IPrepareImageMode            PrepareMode,
  IDocumentProcessingParams*   DocumentProcessingParams,
  FileExportFormatEnum         ExportFormat,
  IUnknown*                    ExportParams,
  IImagePasswordCallback*      PasswordCallback,
  BSTR                         OutputFileName
);
```

### C\#

```csharp theme={null}
void RecognizeImageFile(
  string                   ImageFileName,
  IPrepareImageMode         PrepareMode,
  IDocumentProcessingParams DocumentProcessingParams,
  FileExportFormatEnum     ExportFormat,
  object                   ExportParams,
  IImagePasswordCallback   PasswordCallback,
  string                   OutputFileName
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub RecognizeImageFile( _
  ImageFileName As String, _
  PrepareMode As IPrepareImageMode, _
  DocumentProcessingParams As IDocumentProcessingParams, _
  ExportFormat As IFileExportFormatEnum, _
  ExportParams As Object, _
  PasswordCallback As IImagePasswordCallback, _
  OutputFileName As String _
)
```

<div id="parameters">
  ## Parámetros
</div>

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](/es/fine-reader/engine/api-reference/image-related-objects/prepareimagemode) o, si se ha cargado un [perfil](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles), se usan los parámetros definidos en ese perfil.

PrepareMode

\[in] Esta variable hace referencia al objeto [PrepareImageMode](/es/fine-reader/engine/api-reference/image-related-objects/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](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles), se usan los parámetros definidos en ese perfil.

DocumentProcessingParams

\[in] Hace referencia al objeto [DocumentProcessingParams](/es/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/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](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles), se usan los parámetros definidos en ese perfil.

ExportFormat

\[in] Esta variable, de tipo [FileExportFormatEnum](/es/fine-reader/engine/api-reference/enumerations/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](/es/fine-reader/engine/api-reference/parameter-objects/export-parameters/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](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles), se usan los parámetros definidos en ese perfil.

<Warning>
  En Linux, si está trabajando con ABBYY FineReader Engine cargado fuera del proceso, debe pasar NULL para este parámetro.
</Warning>

PasswordCallback

\[in] Hace referencia a la interfaz del objeto implementado por el usuario de tipo [ImagePasswordCallback](/es/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback), 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.

<div id="return-values">
  ## Valores devueltos
</div>

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](/es/fine-reader/engine/api-reference/return-codes).

<div id="remarks">
  ## Notas
</div>

En Linux y Windows: según el valor de la propiedad [IEngine::MultiProcessingParams](/es/fine-reader/engine/api-reference/parameter-objects/multiprocessingparams), ABBYY FineReader Engine puede distribuir el procesamiento de documentos de varias páginas entre los núcleos del CPU.

<div id="see-also">
  ## Consulte también
</div>

[Engine](/es/fine-reader/engine/api-reference/engine-object-iengine-interface)

[IImagePasswordCallback](/es/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback)

[Trabajar con perfiles](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)