DocumentConverterOptions Class

Summary

Manages the extra options to use with the document converter.

Syntax

C++/CLI

Java

Python

public class DocumentConverterOptions

public ref class DocumentConverterOptions

public class DocumentConverterOptions

class DocumentConverterOptions:

Remarks

DocumentConverterOptions manages the extra options to use with the document converter and can be accessed through the Options property of DocumentConverter.

This class contains the following members:

Member	Description
JobErrorMode	Ability to resume on none critical errors.
PageNumberingTemplate	Template to use for the individual file names when the output format does not support multipages.
OutputSinglePages	Force outputting single page files even if the format supports multipage. For raster conversion only.
EnableSvgConversion	Use SVG conversion when supported.
SvgImagesRecognitionMode	Determines how to treat any image elements encountered in an input SVG page during the conversion.
EmptyPageMode	Determines how empty pages are treated during the conversion.
UseThreads	Indicates whether to use multiple threads during the conversion.

DocumentConverterOptions supports saving and loading the options to a stream or string using:

Method	Description
Save	Saves the current option to a stream as XML.
SaveToString	Gets the current options as an XML string.
Load	Loads the options previously saved from an XML stream.
LoadFromString	Sets the options from an XML string.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Document.Writer; 
using Leadtools.Svg; 
using LeadtoolsExamples.Common; 
using Leadtools.Document; 
using Leadtools.Caching; 
using Leadtools.Annotations.Engine; 
using Leadtools.Ocr; 
using Leadtools.Document.Converter; 
using Leadtools.Annotations.Rendering; 
 
public void DocumentConverterOptionsExample() 
{ 
   using (DocumentConverter documentConverter = new DocumentConverter()) 
   { 
      //use options to force ocr conversion (disable SVG) 
      documentConverter.Options.EnableSvgConversion = false; 
      //abort job at first error (in any page) 
      documentConverter.Options.JobErrorMode = DocumentConverterJobErrorMode.Abort; 
 
      var ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.LEAD); 
      var rasterCodecs = new RasterCodecs(); 
      var documentWriter = new DocumentWriter(); 
      ocrEngine.Startup(rasterCodecs, documentWriter, null, LEAD_VARS.OcrLEADRuntimeDir); 
      documentConverter.SetOcrEngineInstance(ocrEngine, true); 
      documentConverter.Diagnostics.EnableTrace = true; 
 
      var inFile = Path.Combine(ImagesPath.Path, @"Leadtools.docx"); 
      var outFile = Path.Combine(ImagesPath.Path, @"output.pdf"); 
      var format = DocumentFormat.Pdf; 
      var jobData = DocumentConverterJobs.CreateJobData(inFile, outFile, format); 
      jobData.JobName = "conversion job"; 
 
      var job = documentConverter.Jobs.CreateJob(jobData); 
      documentConverter.Jobs.RunJob(job); 
 
      if (job.Status == DocumentConverterJobStatus.Success) 
      { 
         Console.WriteLine("Success"); 
      } 
      else 
      { 
         Console.WriteLine("{0} Errors", job.Status); 
         foreach (var error in job.Errors) 
         { 
            Console.WriteLine("  {0} at {1}: {2}", error.Operation, error.InputDocumentPageNumber, error.Error.Message); 
         } 
      } 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string OcrLEADRuntimeDir = @"C:\LEADTOOLS22\Bin\Common\OcrLEADRuntime"; 
}

Requirements

Target Platforms

Reference

DocumentConverterOptions Members

Leadtools.Document.Converter Namespace

Using LEADTOOLS Document Converter

Programming with the LEADTOOLS .NET OCR

Download our FREE evaluation

Help Version 22.0.2023.5.10

Leadtools.Document.Converter Assembly

Introduction

Getting Started

Namespaces

Leadtools.Document.Converter Namespace

Assemblies