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

# PrepareDib-Methode des Engine-Objekts

> PrepareDib-Methode des Engine-Objekts in der ABBYY FineReader Engine API — Diese Methode erstellt eine Kopie der angegebenen geräteunabhängigen Bitmap (DIB) 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 der angegebenen geräteunabhängigen Bitmap im [internen Bildformat von FineReader Engine](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format). Die DIB muss mit der Windows-API erstellt werden.

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 PrepareDib(
  __int64            DibHglobal,
  BSTR               DestinationFolderName,
  int                XResolution,
  int                YResolution,
  IPrepareImageMode* PrepareMode
);
```

### C\#

```csharp theme={null}
void PrepareDib(
  Int64            DibHglobal,
  string           DestinationFolderName,
  int              XResolution,
  int              YResolution,
  IPrepareImageMode PrepareMode
);
```

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

```vb theme={null}
Sub PrepareDib( _
  DibHglobal As Int64, _
  DestinationFolderName As String, _
  XResolution As Integer, _
  YResolution As Integer, _
  [PrepareMode As IPrepareImageMode = Nothing] _
)
```

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

DibHglobal

\[in] Gibt das Handle des Speicherblocks (HGLOBAL) an, in dem die Bitmap gespeichert ist. Das Handle wird als [\_\_int64](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties) übergeben. Dieses Handle muss für den Prozess verfügbar sein, der ABBYY FineReader Engine verwendet.

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 von Bitmaps in das interne Format speichert. Dieser Parameter kann 0 sein; in diesem Fall werden die Standardparameter des Bildvorbereitungsmodus verwendet. Wurde ein [Profil](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) geladen, werden stattdessen die in diesem Profil festgelegten Parameter verwendet.

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

Windows: Für diese Methode sind keine spezifischen Rückgabewerte definiert. Sie gibt die [Standard-Rü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 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 das Engine-Objekt als Out-of-Process-Server geladen ist.

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

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

[OpenDib](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/opendib-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)