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

# PrepareBitmap-Methode des Engine-Objekts

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

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

Diese Methode erstellt eine Kopie des angegebenen Bitmapbilds (HBITMAP) im [internen Bildformat von FineReader Engine](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format).

Das von 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 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">
  ## Parameter
</div>

BitmapHandle

\[in] Gibt das Handle des GDI-Objekts (HBITMAP) an. Dieses Handle muss für den Prozess verfügbar sein, der ABBYY FineReader Engine ausführt. Das Handle wird als [\_\_int64](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties) übergeben.

DestinationFolderName

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

XResolution

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

YResolution

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

PrepareMode

\[in] Verweist auf das Objekt [PrepareImageMode](/de/fine-reader/engine/api-reference/image-related-objects/prepareimagemode), das Parameter für die Konvertierung der Bitmap in das interne Format speichert. Dieser Parameter kann 0 sein; in diesem Fall werden die Standardparameter des Bildvorbereitungsmodus verwendet. Wenn ein [Profil](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) geladen wurde, werden die durch dieses Profil festgelegten Parameter verwendet.

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

Windows: Diese Methode hat keine spezifischen Rückgabewerte. Stattdessen gibt sie die [Standard-Rückgabewerte der Funktionen von ABBYY FineReader Engine](/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 vorbereiteten Bildern löschen möchten, sobald sie nicht mehr benötigt werden, müssen Sie die entsprechende Vorgehensweise in Ihrer Anwendung implementieren. Diese Dateien werden von ABBYY FineReader Engine nicht automatisch von der Festplatte gelöscht.

* Diese Methode funktioniert nicht, wenn die Engine unter Linux als Out-of-Process-Server geladen wird oder wenn das Objekt unter Windows mithilfe des Objekts [OutprocLoader](/de/fine-reader/engine/api-reference/engine-loaders/outprocloader) erstellt wird.

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

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

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

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

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