Overloads Sub LoadZones( _
   ByVal fileName As String _
) 

Visual Basic (Usage)	Copy Code
Dim instance As IOcrDocument Dim fileName As String   instance.LoadZones(fileName)

void LoadZones( 
   string fileName
)

void LoadZones( 
   String^ fileName
) 

Parameters

fileName

The name of the file containing the zones to load.

To save and load the zones of OCR pages, you can use one of these methods:

• IOcrPage.SaveZones(fileName) or IOcrPage.SaveZones(stream): These methods save the zones of a particular OCR page to a single-page disk file or stream. These methods will not use the page number, and hence, the file or stream will contain zones that are not tied to any particular page and can be loaded back into any OCR page regardless of its number. To load these zones back into any OCR page, use IOcrPage.LoadZones(fileName) or IOcrPage.LoadZones(stream).

• IOcrDocument.SaveZones(fileName) or IOcrDocument.SaveZones(stream): These methods save the zones of all the OCR pages in a document to a multi-page disk file or stream. The saved data will contain the page number of the zones. To load these zones, you can either use IOcrDocument.LoadZones(fileName) or IOcrDocument.LoadZones(stream) to load the zones from a multi-page file or stream back into a multi-page OCR document. Or IOcrPage.LoadZones(fileName, pageNumber) and IOcrPage.LoadZones(stream, pageNumber) to load any single page from a multi-page OCR document into a particular OCR page.

Note on loading zones from a multi-page zone file: If the file does not contain zones data with the correct page number, the engine will not load any zones for this page. After the method returns, any OCR page that did not have zones data will contain zero zones. (the IOcrPage.Zones property conatins 0 items). You can then use IOcrPage.AutoZone if required to re-zone this page.

Use this method to load the zones previously saved into a multi-page zones disk file with the IOcrDocument.SaveZones(fileName) method.

The zones of this page will first be cleared prior to loading the new items.

After this method finishes, you can access the loaded zones in the IOcrPage.Zones property.

To load and save the zones to a .NET stream, use IOcrDocument.SaveZones(stream), IOcrDocument.LoadZones(stream) and IOcrPage.LoadZones(stream, pageNumber).

Saving zones to an external file or a stream could be useful when you are processing forms. For example, you can load one of the forms and automatically find the zones inside it using AutoZone, if the automatic zone detection was not 100 percent satisfactory, you can update the zones in the IOcrPage.Zones collection manually and then save the result with IOcrDocument.SaveZones(fileName). Once the zones are saved. You can now process all similar forms in the following manner:

• Add the form page or pages to an OCR document using the Pages collection of IOcrDocument.
• Load the zones previously saved for each page using IOcrDocument.LoadZones(fileName).
• Skip calling AutoZone and directly call IOcrPage.Recognize or IOcrPage.RecognizeText. This will also speed up the recognition process considerably.

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

Reference