Leadtools.Forms.Ocr Requires Document/Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
GetRasterImage Method
See Also 
Leadtools.Forms.Ocr Namespace > IOcrPage Interface : GetRasterImage Method



Gets the image data of this page as a raster image.

Syntax

Visual Basic (Declaration) 
Overridable Function GetRasterImage() As RasterImage
Visual Basic (Usage)Copy Code
Dim instance As IOcrPage
Dim value As RasterImage
 
value = instance.GetRasterImage()
C# 
virtual RasterImage GetRasterImage()
C++/CLI 
virtual RasterImage GetRasterImage(); 

Return Value

A RasterImage object that represent the image data of this page.

Example

For an example, refer to IOcrPage.

Remarks

Once you add a page to an OCR document, the image data used to create the page is copied and stored inside the OCR engine even if the original object used to create the page was a RasterImage object. To get a RasterImage that represents this page, use GetRasterImage.

The RasterImage object that this method returns contains a copy of the page image data. Any modifications you make to the RasterImage object will not affect the page. To update the page image data, you must call SetRasterImage. Since the RasterImage object is a copy, you must dispose it by calling its RasterImage.Dispose method once you are done using it.

Once you obtain a RasterImage object for this page, you can use it with other parts of LEADTOOLS, for example, you can set it in the RasterImageViewer or RasterPictureBox controls for viewing inside your Windows Forms-based application. You can also perform your own image processing on the page as follows:


// Flip the 2nd page added to the OCR document
// Get the page (index is zero-based)
IOcrPage page = ocrDocument.Pages[1];
// Get a RasterImage object that represents this page
Leadtools.RasterImage image = page.GetRasterImage();
// Flip it vertically
Leadtools.ImageProcessing.FlipCommand flip = new Leadtools.ImageProcessing.FlipCommand();
flip.Horizontal = false;
flip.Run(image);
// Set it back into the page
page.SetRasterImage(image);
// Dispose the image
image.Dispose();

You can also get a RasterImage object representation of a page with the IOcrPageCollection.ExportPage methods.

The RasterImage object returned from this method will contain one page only. To get a multi-page RasterImage object containing the image data of all or a specific range of the pages added to the OCR document, you can either create a RasterImage from the first then loop through the pages of the document and add the returned RasterImage objects to the first object with the RasterImage.AddPage method. Or you can use the IOcrPageCollection.ExportPages methods.

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also

GetRasterImage requires an OCR module license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features