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

# PrepareBitmapBits-Methode des Engine-Objekts

> PrepareBitmapBits-Methode des Engine-Objekts in der ABBYY FineReader Engine API — Diese Methode erstellt eine Kopie der angegebenen Bitmap-Daten im internen Bildformat von FineReader Engine (nur für Windows).

<Warning>
  Diese Methode ist für Linux und macOS nicht implementiert.
</Warning>

Diese Methode erstellt eine Kopie der angegebenen [Bitmap-Daten](/de/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum) im [internen Bildformat von FineReader Engine](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format) und unterstützt die folgenden Bildformate:

* 1-Bit-Monochrom (jedes Pixel wird durch 1 Bit dargestellt).
* 8-Bit-Graustufen (jedes Pixel wird durch 8 Bit dargestellt).
* 24-Bit-Farbe (je Pixel 24 Bit, davon jeweils 8 Bit für die R-, G- und B-Komponente).

Das mit dieser Methode erzeugte Ausgabebild kann anschließend mit der Methode [IEngine::LoadImageDoc](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/loadimagedoc-method) geöffnet werden.

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

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

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

### C\#

```csharp theme={null}
void PrepareBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  Int64                RawDataPtr,
  string               DestinationFolderName,
  IPrepareImageMode     PrepareMode
);
```

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

```vb theme={null}
Sub PrepareBitmapBits( _
  Format As BitmapBitsFormatEnum, _
  Width As Integer, _
  Height As Integer, _
  ByteWidth As Integer_
  XResolution As Integer, _
  YResolution As Integer, _
  RawDataPtr As Int64, _
  DestinationFolderName As String, _
  [PrepareMode As IPrepareImageMode = Nothing] _
)
```

<div id="parameters">
  ## Parameter
</div>

Format

\[in] Dieser Parameter vom Typ [BitmapBitsFormatEnum](/de/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum) gibt das Format der vorzubereitenden Bitmap-Daten an.

Width

\[in] Gibt die Breite der Bitmap in Pixeln an. Dieser Parameter darf nicht 0 sein.

Height

\[in] Gibt die Höhe der Bitmap in Pixeln an. Dieser Parameter darf nicht 0 sein.

ByteWidth

\[in] Gibt die Breite einer Bitmap-Zeile in Byte an. Dabei sollte die Ausrichtung berücksichtigt werden. Dieser Parameter darf nicht 0 sein.

XResolution

\[in] Gibt die horizontale Auflösung der Bitmap in dpi an.

YResolution

\[in] Gibt die vertikale Auflösung der Bitmap in dpi an.

RawDataPtr

\[in] Dieser Parameter wird als Handle auf einen Speicherpuffer mit Bitmap-Daten behandelt. Das Handle wird als [\_\_int64](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties) übergeben. Einzelheiten zum Datenformat finden Sie in der Beschreibung der Konstanten von [BitmapBitsFormatEnum](/de/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum).

DestinationFolderName

\[in] Gibt den vollständigen Pfad zu dem Ordner an, in dem das Bild im internen Format gespeichert werden soll. Dieser Ordner muss vorhanden sein, andernfalls wird ein Fehlercode zurückgegeben.

PrepareMode

\[in] Verweist auf das Objekt [PrepareImageMode](/de/fine-reader/engine/api-reference/image-related-objects/prepareimagemode), das den Modus der Bildvorbereitung definiert. Es kann 0 sein; in diesem Fall werden die Standardwerte für die Eigenschaften von PrepareImageMode verwendet. Wenn ein [Profil](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) geladen wurde, werden stattdessen die in diesem Profil festgelegten Parameter verwendet.

<div id="return-values">
  ## Rückgabewerte
</div>

Windows: Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die [Standardrückgabewerte von ABBYY FineReader Engine-Funktionen](/de/fine-reader/engine/api-reference/return-codes) zurück.

Linux und macOS: Diese Methode gibt E\_NOTIMPL zurück.

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

* Wenn Sie die Dateien mit den vorbereiteten Bildern löschen möchten, sobald sie nicht mehr benötigt werden, müssen Sie dies in Ihrer Anwendung selbst implementieren. Diese Dateien werden von ABBYY FineReader Engine nicht automatisch von der Festplatte entfernt.
* Diese Methode funktioniert nicht, wenn die Engine unter Linux als Out-of-Process-Server geladen wird oder wenn das Objekt unter Windows mithilfe des [OutprocLoader](/de/fine-reader/engine/api-reference/engine-loaders/outprocloader)-Objekts erstellt wird.

<div id="see-also">
  ## Siehe auch
</div>

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

[OpenBitmapBits](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/openbitmapbits-method)

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

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

[Arbeiten mit Profilen](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)