BitmapBitsFormatEnum

BitmapBitsFormatEnum in der ABBYY FineReader Engine API — Von PrepareBitmapBits und OpenBitmapBits akzeptierte Bitmap-Datenformate für das Engine-Objekt.

Die Enumerationskonstanten von BitmapBitsFormatEnum beschreiben die Formate von Bitmap-Daten, mit denen ABBYY FineReader Engine arbeiten kann.

Bitmap-Daten werden von den Methoden PrepareBitmapBits und OpenBitmapBits des Objekts Engine verarbeitet. Diese Methoden erhalten den Typ des Eingabebildformats (den Wert der Enumeration BitmapBitsFormatEnum), die Bildabmessungen (width, height und byteWidth) sowie einen Zeiger auf den Puffer mit den Bilddaten.

Das Bild wird im Puffer fortlaufend Zeile für Zeile von oben nach unten gespeichert. Jede Zeile belegt byteWidth Byte. Das gesamte Bild belegt (height * byteWidth) Byte. Wie die Bilddaten interpretiert werden, hängt vom Bildformat ab.

typedef enum {
 BBF_BlackAndWhite,
 BBF_Gray,
 BBF_Color
} BitmapBitsFormatEnum;

​

Elemente

Name	Beschreibung
BBF_BlackAndWhite	Schwarz-Weiß-Bitmap-Daten (jedes Pixel wird durch 1 Bit dargestellt). Eine Zeile einer Schwarz-Weiß-Bitmap wird als Folge von mindestens N = ceil( width / 8 ) Bytes gespeichert. Jedes Byte codiert die Farben von 8 benachbarten Pixeln, wobei das höchstwertige Bit des ersten Bytes dem ganz linken Pixel der Zeile entspricht. Ein Bitwert von 0 steht für ein schwarzes Pixel, ein Bitwert von 1 für ein weißes Pixel. Ist width kein Vielfaches von 8, werden die niederwertigsten Bits des N-ten Bytes ignoriert. Ist byteWidth größer als N, werden nachfolgende zusätzliche Bytes ignoriert (dadurch können Zeilen an Wort- oder Doppelwortgrenzen ausgerichtet werden).
BBF_Color	Farb-Bitmap-Daten (je 24 Bits verwenden 8 Bits für jede der Komponenten R, G und B). Eine Zeile einer Farb-Bitmap wird als Folge von mindestens N = 3 * width Bytes gespeichert, die als Folge von Byte-Tripeln behandelt werden. Jedes Tripel codiert ein Pixel; das erste Tripel entspricht dem ganz linken Pixel der Zeile. Das erste Byte des Tripels enthält die Intensität der blauen Farbkomponente, das zweite Byte die Intensität der grünen Komponente, das dritte Byte die Intensität der roten Komponente. Ein schwarzes Pixel wird als Tripel (0, 0, 0) dargestellt, ein weißes Pixel als Tripel (255, 255, 255), ein Pixel in reinem Rot als Tripel (0, 0, 255) usw. Ist byteWidth größer als N, werden nachfolgende zusätzliche Bytes ignoriert.
BBF_Gray	Graustufen-Bitmap-Daten (jedes Pixel wird durch 8 Bits dargestellt). Eine Zeile einer Graustufen-Bitmap wird als Folge von mindestens N = width Bytes gespeichert. Jedes Byte codiert die Grauintensität eines Pixels: 0 steht für Schwarz, 255 für Weiß. Das erste Byte entspricht dem ganz linken Pixel der Zeile. Ist byteWidth größer als N, werden nachfolgende zusätzliche Bytes ignoriert.

​

Verwendung in

IEngine::PrepareBitmapBits

IEngine::OpenBitmapBits