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

> Método PrepareBitmapBits del objeto Engine en la API de ABBYY FineReader Engine: este método crea una copia de los datos de mapa de bits especificados en el formato de imagen interno de FineReader Engine (solo para Windows).

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

Este método crea una copia de los [datos de mapa de bits](/es/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum) especificados en el [formato de imagen interno de FineReader Engine](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format) y admite los siguientes formatos de imagen:

* Monocromo de 1 bit (cada píxel se representa con 1 bit).
* Escala de grises de 8 bits (cada píxel se representa con 8 bits).
* Color de 24 bits (cada grupo de 24 bits usa 8 bits para cada componente R, G y B).

La imagen de salida obtenida con este método puede abrirse después 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 PrepareBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  __int64              RawDataPtr,
  BSTR                 DestinationFolderName,
  IPrepareImageMode*   PrepareMode
);
```

### C\#

```csharp theme={null}
void PrepareBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  Int64                RawDataPtr,
  string               DestinationFolderName,
  IPrepareImageMode     PrepareMode
);
```

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

```vb theme={null}
Sub PrepareBitmapBits( _
  Format As BitmapBitsFormatEnum, _
  Width As Integer, _
  Height As Integer, _
  ByteWidth As Integer_
  XResolution As Integer, _
  YResolution As Integer, _
  RawDataPtr As Int64, _
  DestinationFolderName As String, _
  [PrepareMode As IPrepareImageMode = Nothing] _
)
```

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

Format

\[in] Este parámetro, de tipo [BitmapBitsFormatEnum](/es/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum), especifica el formato de los datos del mapa de bits que se va a preparar.

Width

\[in] Especifica el ancho del mapa de bits en píxeles. Este parámetro no debe ser 0.

Height

\[in] Especifica la altura del mapa de bits en píxeles. Este parámetro no debe ser 0.

ByteWidth

\[in] Especifica el ancho en bytes de la línea del mapa de bits. Debe tener en cuenta la alineación. Este parámetro no debe ser 0.

XResolution

\[in] Especifica la resolución horizontal del mapa de bits en puntos por pulgada.

YResolution

\[in] Especifica la resolución vertical del mapa de bits en puntos por pulgada.

RawDataPtr

\[in] Este parámetro se trata como un identificador de un búfer de memoria que contiene datos del mapa de bits. El identificador se pasa como [\_\_int64](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties). Consulte la descripción de las constantes de [BitmapBitsFormatEnum](/es/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum) para obtener más información sobre el formato de los datos.

DestinationFolderName

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

PrepareMode

\[in] Hace referencia al objeto [PrepareImageMode](/es/fine-reader/engine/api-reference/image-related-objects/prepareimagemode), que define el modo de preparación de la imagen. Puede ser 0; en ese caso, se usarán los valores predeterminados de las Propiedades de PrepareImageMode o, si se ha cargado un [perfil](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles), se usarán 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 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 de 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)

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

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

[BitmapBitsFormatEnum](/es/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum)

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