> ## 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 PrepareBitmap del objeto Engine

> Método PrepareBitmap del objeto Engine en la API de ABBYY FineReader Engine — Este método crea una copia de la imagen de mapa de bits (HBITMAP) especificada en el formato de imagen interno de FineReader Engine (solo para Windows).

<Warning>
  Este método no está implementado para Linux ni macOS.
</Warning>

Este método crea una copia de la imagen de mapa de bits (HBITMAP) especificada en el [formato de imagen interno de FineReader Engine](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format).

La imagen de salida obtenida con este método puede abrirse posteriormente con el método [IEngine::LoadImageDoc](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/loadimagedoc-method).

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

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

```cpp theme={null}
HRESULT PrepareBitmap(
  __int64            BitmapHandle,
  BSTR               DestinationFolderName,
  int                XResolution,
  int                YResolution,
  IPrepareImageMode* PrepareMode
);
```

### C\#

```csharp theme={null}
void PrepareBitmap(
  Int64            BitmapHandle,
  string           DestinationFolderName,
  int              XResolution,
  int              YResolution,
  IPrepareImageMode PrepareMode
);
```

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

```vb theme={null}
Sub PrepareBitmap( _
  BitmapHandle As Int64, _
  DestinationFolderName As String, _
  XResolution As Integer, _
  YResolution As Integer, _
  [PrepareMode As IPrepareImageMode = Nothing] _
)
```

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

BitmapHandle

\[in] Especifica el identificador del objeto GDI (HBITMAP). Este identificador debe estar disponible para el proceso en el que se ejecuta ABBYY FineReader Engine. El identificador se pasa como [\_\_int64](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties).

DestinationFolderName

\[in] Especifica la ruta completa de la carpeta donde se debe guardar la imagen en formato interno. Esta carpeta debe existir; de lo contrario, se devuelve un código de error.

XResolution

\[in] Especifica la resolución horizontal del mapa de bits.

YResolution

\[in] Especifica la resolución vertical del mapa de bits.

PrepareMode

\[in] Hace referencia al objeto [PrepareImageMode](/es/fine-reader/engine/api-reference/image-related-objects/prepareimagemode), que almacena los parámetros para la conversión del mapa de bits a 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 [profile](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles), se usan los parámetros establecidos por ese perfil.

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

Windows: Este método no tiene valores de retorno específicos. Devuelve los [valores de retorno estándar de las funciones de ABBYY FineReader Engine](/es/fine-reader/engine/api-reference/return-codes).

Linux y macOS: Este método devuelve E\_NOTIMPL.

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

* Si necesita eliminar los archivos con las imágenes preparadas cuando dejen de ser necesarios, implemente este procedimiento en su aplicación. ABBYY FineReader Engine no eliminará automáticamente estos archivos del disco.

* Este método no funciona si el Engine se carga como un servidor fuera del proceso en Linux o si el objeto se crea mediante el objeto [OutprocLoader](/es/fine-reader/engine/api-reference/engine-loaders/outprocloader) en Windows.

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

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

[OpenBitmap](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/openbitmap-method)

[LoadImageDoc](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/loadimagedoc-method)

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