GetBitmap Method of the Image Object
This method returns a part of the image as a top-down DIB (Device-Independent Bitmap). The palette, where 0 is the black color, is used for gray and black-and-white images.
The method returns the DIB as the Handle object. This object manages memory allocation and releases resources when they are no longer in use.
HRESULT GetBitmap( IImageModification* Modification, IHandle** Result );
IHandle GetBitmap( IImageModification Modification );
Visual Basic .NET
Function GetBitmap(Modification As IImageModification) As IHandle
- [in] This parameter of type ImageModification defines modifications that are performed upon image. It may include clipping rectangles, in which case only specified parts of the image are passed, stretch ratio, painting rectangles for filling up parts of the image with color and so on. This parameter may be 0, and in this case no modifications will be performed upon the image page and it will be passed "as is."
- [out, retval] A pointer to IHandle* pointer variable that receives interface pointer of the resulting Handle object representing the handle to the associated bitmap.
This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions.
This method does not work if the Engine object is created using the OutprocLoader object.
FREngine.IEngine engine; FREngine.IFRDocument frdoc; // We presume that the document have been created and images have been added to it // Get bitmap handle of a color image plane of a document page FREngine.IFRPage page = frDoc.Pages; FREngine.IImageDocument imageDoc = page.ImageDocument; FREngine.IImage image = imageDoc.ColorImage; FREngine.IHandle hBitmap = image.GetBitmap( null ); // Work with the bitmap System.Drawing.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle ); ... Gdi32.DeleteObject( hBitmap );