SaveZones(String) Method

void SaveZones( 
   string fileName
)

'Declaration
 
Overloads Sub SaveZones( _
   ByVal fileName As String _
) 

'Usage
 
Dim instance As IOcrDocument
Dim fileName As String
 
instance.SaveZones(fileName)

void SaveZones( 
   string fileName
)

function Leadtools.Forms.Ocr.IOcrDocument.SaveZones(String)( 
   fileName 
)

void SaveZones( 
   String^ fileName
) 

Parameters

fileName

The name of the file that will contain the zones data.

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).

• IOcrPage.SaveZones(fileName, pageNumber) or IOcrPage.SaveZones(stream, pageNumber): These methods save the zones of a particular OCR page to a multi-page disk file or stream. If the file or stream exist previously, these methods will replace the zones specified in 'pageNumber' with the zones of the IOcrPage. If the file or stream does not contain zones for the specified page number, the zones will be appended to the file or stream at the end and can be loaded later using IOcrPage.LoadZones(fileName, pageNumber) or IOcrPage.LoadZones(stream, pageNumber).

• 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 contains 0 items). You can then use IOcrPage.AutoZone if required to re-zone this page.

Use IOcrDocument.LoadZones(fileName) or IOcrPage.LoadZones(fileName, pageNumber) to load all or one page zones saved by this method.

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

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

IOcrDocument Interface
IOcrDocument Members
Overload List
IOcrPage.LoadZones(fileName)
IOcrPage.LoadZones(fileName, pageNumber)
IOcrDocument.LoadZones(fileName)
IOcrPage.LoadZones(Stream)
IOcrPage.LoadZones(Stream, pageNumber)
IOcrDocument.LoadZones(Stream)
IOcrPage.SaveZones(fileName)
IOcrPage.SaveZones(stream)
IOcrPage.SaveZones(fileName, pageNumber)
IOcrPage.SaveZones(stream, pageNumber)
IOcrDocument.SaveZones(Stream)
IOcrPageCollection Interface
IOcrZoneCollection Interface
OcrZone Structure
IOcrPage.Recognize
Programming with the LEADTOOLS .NET OCR