GetBitmap-Methode des Image-Objekts

Diese Methode ist in FRE für Windows implementiert.

Diese Methode gibt einen Teil des Bildes als Top-down-DIB (Device-Independent Bitmap) zurück. Für Graustufen- und Schwarzweißbilder wird eine Palette verwendet, bei der 0 der Farbe Schwarz entspricht. Die Methode gibt das DIB als Handle-Objekt zurück. Dieses Objekt verwaltet die Speicherbelegung und gibt Ressourcen frei, wenn sie nicht mehr verwendet werden.

Syntax

C++

HRESULT GetBitmap(
  IImageModification* Modification,
  IHandle**           Result
);

C#

IHandle GetBitmap( IImageModification Modification );

Visual Basic .NET

Function GetBitmap(Modification As IImageModification) As IHandle

Parameter

Modification [in] Dieser Parameter vom Typ ImageModification definiert die Änderungen, die am Bild vorgenommen werden. Er kann Zuschneiderechtecke enthalten; in diesem Fall werden nur die angegebenen Teile des Bildes übergeben, außerdem ein Streckungsverhältnis, Füllrechtecke zum Füllen von Bildbereichen mit Farbe und so weiter. Dieser Parameter kann 0 sein; in diesem Fall werden keine Änderungen an der Bildseite vorgenommen und sie wird „wie besehen“ übergeben. Result [out, retval] Ein Zeiger auf eine IHandle*-Zeigervariable, die den Schnittstellenzeiger des resultierenden Handle-Objekts erhält, das das Handle für die zugeordnete Bitmap darstellt.

Rückgabewerte

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

Hinweise

Diese Methode funktioniert nicht, wenn die Engine unter Linux als Out-of-Process-Server geladen wird oder wenn das Objekt unter Windows über das Objekt OutprocLoader erstellt wird.

Beispiele

C#-Code

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// Wir setzen voraus, dass das Dokument erstellt und ihm Bilder hinzugefügt wurden
// Bitmap-Handle einer Farbbildebene einer Dokumentseite abrufen
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// Mit der Bitmap arbeiten
System.Drawing.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );