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

> Méthode OpenBitmapBits de l'objet Engine dans l'API ABBYY FineReader Engine — Cette méthode ouvre les données bitmap spécifiées et prend en charge les images monochromes 1 bit, en niveaux de gris 8 bits et en couleur 24 bits (Windows uniquement).

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

Cette méthode ouvre les [données bitmap](/fr/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum) spécifiées et prend en charge les formats d'image suivants :

* monochrome sur 1 bit (chaque pixel est représenté par 1 bit).
* niveaux de gris sur 8 bits (chaque pixel est représenté par 8 bits).
* couleur sur 24 bits (chaque groupe de 24 bits utilise 8 bits pour chacun des composants R, G et B).

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

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

```cpp theme={null}
HRESULT OpenBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  __int64              RawDataPtr,
  IPrepareImageMode*   PrepareMode,
  IImageDocument**     Result
);
```

### C\#

```csharp theme={null}
IImageDocument OpenBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  Int64                RawDataPtr,
  IPrepareImageMode    PrepareMode
);
```

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

```vb theme={null}
Function OpenBitmapBits( _
  Format As BitmapBitsFormatEnum, _
  Width As Integer, _
  Height As Integer, _
  ByteWidth As Integer, _
  XResolution As Integer, _
  YResolution As Integer, _
  RawDataPtr As Int64, _
  [PrepareMode As IPrepareImageMode = Nothing] _
) As IImageDocument
```

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

Format

\[in] Ce paramètre, de type [BitmapBitsFormatEnum](/fr/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum), décrit le format des données bitmap à ouvrir.

Width

\[in] Spécifie la largeur du bitmap en pixels. Ce paramètre ne doit pas être 0.

Height

\[in] Spécifie la hauteur du bitmap en pixels. Ce paramètre ne doit pas être 0.

ByteWidth

\[in] Spécifie la largeur, en octets, de la ligne du bitmap (padding inclus). Ce paramètre ne doit pas être 0.

XResolution

\[in] Spécifie la résolution horizontale du bitmap en points par pouce.

YResolution

\[in] Spécifie la résolution verticale du bitmap en points par pouce.

RawDataPtr

\[in] Ce paramètre est considéré comme un handle vers un tampon mémoire contenant les données bitmap. Le handle est transmis sous la forme [\_\_int64](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties). Voir la description des constantes [BitmapBitsFormatEnum](/fr/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum) pour plus de détails sur le format des données.

PrepareMode

\[in] Fait référence à l’objet [PrepareImageMode](/fr/fine-reader/engine/api-reference/image-related-objects/prepareimagemode), qui définit le mode de préparation de l’image. Il peut être égal à 0 ; dans ce cas, les valeurs par défaut des propriétés de PrepareImageMode sont utilisées. Sinon, 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.

Result

\[out, retval] Pointeur vers une variable pointeur IImageDocument\* qui reçoit le pointeur d’interface de l’objet [ImageDocument](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument) obtenu.

<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 le Engine est chargé comme 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)

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

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