AltoXmlDocumentOptions Class

Summary

Provides extra options to use when saving a document using the ALTO (Analyzed Layout and Text Object) format.

Syntax

Objective-C

C++

Java

[SerializableAttribute()] 
[DataContractAttribute()] 
public class AltoXmlDocumentOptions : DocumentOptions

<DataContractAttribute()> 
<SerializableAttribute()> 
Public Class AltoXmlDocumentOptions  
   Inherits DocumentOptions

@interface LTAltoXmlDocumentOptions : LTDocumentOptions <NSCopying, NSCoding>

public class AltoXmlDocumentOptions extends DocumentOptions

[DataContractAttribute()] 
[SerializableAttribute()] 
public ref class AltoXmlDocumentOptions : public DocumentOptions

Remarks

The options set in the AltoXmlDocumentOptions class will be used when the user saves a document using the DocumentFormat.AltoXml format.

To change the options used with the Alto format, perform the following steps:

Use the DocumentWriter.GetOptions method of the DocumentWriter object being used. Passing DocumentFormat.AltoXml to the format parameter. Note that the resulting object from the base DocumentOptions class needs to be cast to AltoXmlDocumentOptions.
Use the various AltoXmlDocumentOptions properties to change the options.
Use DocumentWriter.SetOptions to set the new options in the engine.
Now you can call the DocumentWriter.BeginDocument method (again, with DocumentFormat.AltoXml for the format parameter) to create a new document and add the pages.

Note that this format does not support calling DocumentWriter.InsertPage.

Example

This example will create a new text file using some of the supported options.

using Leadtools.Document.Writer; 
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Ocr; 
 
public void AltoXmlDocumentOptionsExample() 
{ 
   var inputFileName = Path.Combine(LEAD_VARS.ImagesDir, "ocr1.tif"); 
   var outputFileName = Path.Combine(LEAD_VARS.ImagesDir, "Example.xml"); 
 
   // Setup LEADTOOLS OCR engine 
   using (var ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.LEAD)) 
   { 
      ocrEngine.Startup(null, null, null, LEAD_VARS.OcrLEADRuntimeDir); 
 
      // Get the DocumentWriter instance 
      var docWriter = new DocumentWriter(); 
      // Change the ALTO XML options 
      var altoXmlOptions = docWriter.GetOptions(DocumentFormat.AltoXml) as AltoXmlDocumentOptions; 
      altoXmlOptions.FileName = inputFileName; 
      altoXmlOptions.SoftwareCreator = "LEAD"; 
      docWriter.SetOptions(DocumentFormat.AltoXml, altoXmlOptions); 
 
      // Create a document 
      using (var ocrDocument = ocrEngine.DocumentManager.CreateDocument()) 
      { 
         // Add the image 
         var ocrPage = ocrDocument.Pages.AddPage(inputFileName, null); 
 
         // Recognize it 
         ocrPage.Recognize(null); 
 
         // Save the document as ALTO XML 
         ocrDocument.Save(outputFileName, DocumentFormat.AltoXml, null); 
      } 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images"; 
   public const string OcrLEADRuntimeDir = @"C:\LEADTOOLS21\Bin\Common\OcrLEADRuntime"; 
}

Imports Leadtools.Document.Writer 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.Ocr 
 
Public Sub AltoXmlDocumentOptionsExample() 
   Dim inputFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "ocr1.tif") 
   Dim outputFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Example.xml") 
 
   ' Setup LEADTOOLS OCR engine 
   Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.LEAD) 
      ocrEngine.Startup(Nothing, Nothing, Nothing, LEAD_VARS.OcrLEADRuntimeDir) 
 
      ' Get the DocumentWriter instance 
      Dim docWriter As New DocumentWriter() 
      ' Change the ALTO XML options 
      Dim altoXmlOptions As AltoXmlDocumentOptions = DirectCast(docWriter.GetOptions(DocumentFormat.AltoXml), AltoXmlDocumentOptions) 
      altoXmlOptions.FileName = inputFileName 
      altoXmlOptions.SoftwareCreator = "LEAD" 
      docWriter.SetOptions(DocumentFormat.AltoXml, altoXmlOptions) 
 
      ' Create a document 
      Using ocrDocument As IOcrDocument = ocrEngine.DocumentManager.CreateDocument() 
         ' Add the image 
         Dim ocrPage As IOcrPage = ocrDocument.Pages.AddPage(inputFileName, Nothing) 
 
         ' Recognize it 
         ocrPage.Recognize(Nothing) 
 
         ' Save the document as ALTO XML 
         ocrDocument.Save(outputFileName, DocumentFormat.AltoXml, Nothing) 
      End Using 
   End Using 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\LEADTOOLS21\Resources\Images" 
   Public Const OcrLEADRuntimeDir As String = "C:\LEADTOOLS21\Bin\Common\OcrLEADRuntime" 
End Class