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

> Método PrepareDib del objeto Engine en la API de ABBYY FineReader Engine: este método crea una copia del mapa de bits independiente del dispositivo (DIB) especificado 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 del mapa de bits independiente del dispositivo especificado en el [formato de imagen interno de FineReader Engine](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format). El DIB debe crearse mediante la API de Windows.

La imagen de salida obtenida con este método puede abrirse luego 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 PrepareDib(
  __int64            DibHglobal,
  BSTR               DestinationFolderName,
  int                XResolution,
  int                YResolution,
  IPrepareImageMode* PrepareMode
);
```

### C\#

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

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

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

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

DibHglobal

\[in] Especifica el identificador del bloque de memoria (HGLOBAL) donde se almacena el mapa de bits. El identificador se pasa como [\_\_int64](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties). Este identificador debe estar disponible para el proceso que utiliza ABBYY FineReader Engine.

DestinationFolderName

\[in] Especifica la ruta completa de la carpeta donde debe guardarse 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 convertir el 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 imagen o, si se ha cargado un [perfil](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles), se usan los parámetros definidos 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 una vez que 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 objeto Engine se carga como un servidor fuera del proceso.

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

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

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

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

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