Zum Hauptinhalt springen
Diese Methode ist für Linux und macOS nicht implementiert.
Diese Methode erstellt eine Kopie der angegebenen Bitmap-Daten im internen Bildformat von FineReader Engine 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 geöffnet werden.

​
Syntax

​
C++

HRESULT PrepareBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  __int64              RawDataPtr,
  BSTR                 DestinationFolderName,
  IPrepareImageMode*   PrepareMode
);

​
C#

void PrepareBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  Int64                RawDataPtr,
  string               DestinationFolderName,
  IPrepareImageMode     PrepareMode
);

​
Visual Basic .NET

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] _
)

​
Parameter

Format [in] Dieser Parameter vom Typ 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 übergeben. Einzelheiten zum Datenformat finden Sie in der Beschreibung der Konstanten von 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, 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 geladen wurde, werden stattdessen die in diesem Profil festgelegten Parameter verwendet.

​
Rückgabewerte

Windows: Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die Standardrückgabewerte von ABBYY FineReader Engine-Funktionen zurück. Linux und macOS: Diese Methode gibt E_NOTIMPL zurück.

​
Hinweise

  • 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-Objekts erstellt wird.

​
Siehe auch

Engine OpenBitmapBits LoadImageDoc BitmapBitsFormatEnum Arbeiten mit Profilen