> ## 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 PrepareBitmap de l'objet Engine

> Méthode PrepareBitmap de l'objet Engine dans l'API ABBYY FineReader Engine — Cette méthode crée une copie du bitmap spécifié (HBITMAP) au 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 de l'image bitmap spécifiée (HBITMAP) dans le [format d'image interne de FineReader Engine](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format).

L'image 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 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">
  ## Paramètres
</div>

BitmapHandle

\[in] Spécifie le handle de l’objet GDI (HBITMAP). Ce handle doit être accessible au processus qui exécute ABBYY FineReader Engine. Le handle est transmis sous la forme d’un [\_\_int64](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties).

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] Fait référence à 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 égal à 0 ; dans ce cas, les paramètres par défaut du mode de préparation de l’image sont utilisés. 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 n’a pas de valeur de retour 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, implémentez 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’Engine est chargé en tant que serveur hors processus sous Linux ou si l’objet est créé à l’aide de l’objet [OutprocLoader](/fr/fine-reader/engine/api-reference/engine-loaders/outprocloader) sous Windows.

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

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

[OpenBitmap](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/openbitmap-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)