> ## 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éthode PrepareDib de l’objet Engine

> Méthode PrepareDib de l’objet Engine dans l’API ABBYY FineReader Engine — Cette méthode crée une copie du bitmap indépendant du périphérique (DIB) spécifié dans le format d’image interne de FineReader Engine (Windows uniquement).

<Warning>
  Cette méthode n’est pas implémentée sous Linux ni macOS
</Warning>

Cette méthode crée une copie du bitmap indépendant du périphérique spécifié dans le [format d’image interne de FineReader Engine](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format). Le DIB doit être créé à l’aide de l’API Windows.

L’image de sortie obtenue avec cette méthode peut ensuite être ouverte à l’aide de la méthode [IEngine::LoadImageDoc](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/loadimagedoc-method).

<div id="syntax">
  ## Syntaxe
</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">
  ## Paramètres
</div>

DibHglobal

\[in] Spécifie le handle du bloc mémoire (HGLOBAL) dans lequel le bitmap est stocké. Le handle est transmis sous la forme [\_\_int64](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties). Ce handle doit être accessible au processus qui utilise ABBYY FineReader Engine.

DestinationFolderName

\[in] Spécifie le chemin complet du dossier dans lequel l’image au format interne doit être enregistrée. Ce dossier doit exister ; sinon, un code d’erreur est renvoyé.

XResolution

\[in] Spécifie la résolution horizontale du bitmap.

YResolution

\[in] Spécifie la résolution verticale du bitmap.

PrepareMode

\[in] Désigne l’objet [PrepareImageMode](/fr/fine-reader/engine/api-reference/image-related-objects/prepareimagemode), qui stocke les paramètres de conversion du bitmap au format interne. Ce paramètre peut être 0 ; dans ce cas, les paramètres par défaut du mode de préparation d’image sont utilisés ou, si un [profil](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) a été chargé, les paramètres définis par ce profil sont utilisés.

<div id="return-values">
  ## Valeurs de retour
</div>

Windows : cette méthode ne renvoie aucune valeur spécifique. Elle renvoie les [valeurs de retour standard des fonctions d’ABBYY FineReader Engine](/fr/fine-reader/engine/api-reference/return-codes).

Linux et macOS : cette méthode renvoie E\_NOTIMPL.

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

* Si vous devez supprimer les fichiers contenant les images préparées lorsqu’ils ne sont plus nécessaires, prévoyez cette procédure dans votre application. Ces fichiers ne seront pas automatiquement supprimés du disque par ABBYY FineReader Engine.
* Cette méthode ne fonctionne pas si l’objet Engine est chargé comme serveur hors processus.

<div id="see-also">
  ## Voir aussi
</div>

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

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

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

[Utilisation des profils](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)