> ## 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 GetBitmap de l'objet Image

> Méthode GetBitmap de l'objet Image dans l'API ABBYY FineReader Engine — renvoie une partie de l'image sous la forme d'un DIB (Device-Independent Bitmap) orienté de haut en bas via un objet Handle qui gère la libération de la mémoire (Windows uniquement).

<Warning>
  Cette méthode est implémentée dans FRE pour Windows
</Warning>

Cette méthode renvoie une partie de l'image sous la forme d'un DIB (Device-Independent Bitmap) de haut en bas. La palette, dans laquelle 0 correspond à la couleur noire, est utilisée pour les images en niveaux de gris et en noir et blanc.

La méthode renvoie le DIB sous la forme de l'objet [Handle](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle). Cet objet gère l'allocation de la mémoire et libère les ressources lorsqu'elles ne sont plus utilisées.

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

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

```cpp theme={null}
HRESULT GetBitmap(
  IImageModification* Modification,
  IHandle**           Result
);
```

### C\#

```csharp theme={null}
IHandle GetBitmap( IImageModification Modification );
```

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

```vb theme={null}
Function GetBitmap(Modification As IImageModification) As IHandle
```

<div id="parameters">
  ## Paramètres
</div>

Modification

\[in] Ce paramètre de type [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification) définit les modifications appliquées à l’image. Il peut inclure des rectangles de découpe, auquel cas seules les parties spécifiées de l’image sont transmises, un facteur d’étirement, des rectangles de remplissage pour colorer certaines parties de l’image, etc. Ce paramètre peut valoir 0 ; dans ce cas, aucune modification n’est appliquée à la page d’image, qui est transmise « telle quelle ».

Result

\[out, retval] Pointeur vers une variable pointeur IHandle\* qui reçoit le pointeur d’interface de l’objet [Handle](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle) résultant, représentant le handle du bitmap associé.

<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 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>

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="samples">
  ## Exemples
</div>

<Accordion title="Code C#">
  ```csharp theme={null}
  FREngine.IEngine engine;
  FREngine.IFRDocument frdoc;
  // Nous supposons que le document a été créé et que des images y ont été ajoutées
  // Obtenir le handle de bitmap d'un plan d'image couleur d'une page du document
  FREngine.IFRPage page = frDoc.Pages[0];
  FREngine.IImageDocument imageDoc = page.ImageDocument;
  FREngine.IImage image = imageDoc.ColorImage;
  FREngine.IHandle hBitmap = image.GetBitmap( null );
  // Utiliser le bitmap
  System.Drawing.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
  ...
  Gdi32.DeleteObject( hBitmap );
  ```
</Accordion>

La méthode est utilisée dans les outils de démonstration Windows suivants : [Engine Predefined Processing Profiles](/fr/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles).

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

[ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification)

[IImage::EstimateBitmapSize](/fr/fine-reader/engine/api-reference/image-related-objects/image/estimatebitmapsize-method)