ExportPages(Int32,Int32,String,RasterImageFormat,Int32,Int32,CodecsSavePageMode) Method

C#
Visual Basic
WinRT C#
Objective-C
Java
WinRT JavaScript
C++

void ExportPages( 
   int firstPageIndex,
   int lastPageIndex,
   string fileName,
   RasterImageFormat format,
   int bitsPerPixel,
   int firstSavePageNumber,
   CodecsSavePageMode pageMode
)

'Declaration
 
Overloads Sub ExportPages( _
   ByVal firstPageIndex As Integer, _
   ByVal lastPageIndex As Integer, _
   ByVal fileName As String, _
   ByVal format As RasterImageFormat, _
   ByVal bitsPerPixel As Integer, _
   ByVal firstSavePageNumber As Integer, _
   ByVal pageMode As CodecsSavePageMode _
)

'Usage
 
Dim instance As IOcrPageCollection
Dim firstPageIndex As Integer
Dim lastPageIndex As Integer
Dim fileName As String
Dim format As RasterImageFormat
Dim bitsPerPixel As Integer
Dim firstSavePageNumber As Integer
Dim pageMode As CodecsSavePageMode
 
instance.ExportPages(firstPageIndex, lastPageIndex, fileName, format, bitsPerPixel, firstSavePageNumber, pageMode)

void ExportPages( 
   int firstPageIndex,
   int lastPageIndex,
   string fileName,
   RasterImageFormat format,
   int bitsPerPixel,
   int firstSavePageNumber,
   CodecsSavePageMode pageMode
)

function Leadtools.Forms.Ocr.IOcrPageCollection.ExportPages(Int32,Int32,String,RasterImageFormat,Int32,Int32,CodecsSavePageMode)( 
   firstPageIndex ,
   lastPageIndex ,
   fileName ,
   format ,
   bitsPerPixel ,
   firstSavePageNumber ,
   pageMode 
)

void ExportPages( 
   int firstPageIndex,
   int lastPageIndex,
   String^ fileName,
   RasterImageFormat format,
   int bitsPerPixel,
   int firstSavePageNumber,
   CodecsSavePageMode pageMode
)

Parameters

firstPageIndex

The zero-based index of the first page to export.

lastPageIndex

The zero-based index of the last page to export. A value of -1 means export up to and including the last page in the OCR document.

fileName

The name of the file to save the pages to.

format

The image file format to use.

bitsPerPixel

The bits/pixel value of the result image file.

firstSavePageNumber

1-based index of the first output page. If the output file already exists, then this parameter lets you control which pages to overwrite and/or where to append the new pages.

pageMode

Determines how to handle the page when saving to multipage formats. This can be one of the following:

Value	Meaning
CodecsSavePageMode.Append	Append the new page(s) to the end of the file. If the file does not exist, this option will create the file and add the pages to it. firstSavePageNumber is not used.
CodecsSavePageMode.Insert	Insert the new page(s) at the index specified by firstSavePageNumber.
CodecsSavePageMode.Replace	Replace the page(s) starting at the index specified by firstSavePageNumber.
CodecsSavePageMode.Overwrite	Overwrite the page(s) starting at the index specified by firstSavePageNumber.
CodecsSavePageMode.Append	Append the new page(s) to the end of the file. If the file does not exist, this option will create the file and add the pages to it.

To export one page to a disk file, use ExportPages(int pageIndex, string fileName, RasterImageFormat format, int bitsPerPixel).

You can export the page to any of the file formats supported by LEADTOOLS. For more information, refer to Summary of All Supported Image File Formats.

C#
Visual Basic
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.Forms.Ocr
Imports Leadtools.Forms
Imports Leadtools.Forms.DocumentWriters
Imports Leadtools.WinForms
Imports Leadtools.ImageProcessing.Core
Imports Leadtools.Drawing

Public Sub ExportPagesToFile()
   Dim imagesPath As String = LEAD_VARS.ImagesDir
   Dim tifFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "OcrMultiPage.tif")
   ' Create an instance of the engine
   Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, False)
      ' Since we have a RasterCodecs object, re-use it in the OCR engine. Although
      ' this demo will not use it, it is always a good practice
      ocrEngine.Startup(Nothing, Nothing, Nothing, LEAD_VARS.OcrAdvantageRuntimeDir)

      ' Create an OCR document
      Using ocrDocument As IOcrDocument = ocrEngine.DocumentManager.CreateDocument()

         ' Loop through the images, add them to the document
         For i As Integer = 0 To 4
            Dim pageFileName As String = Path.Combine(imagesPath, String.Format("Ocr{0}.tif", i + 1))
            ocrDocument.Pages.AddPage(pageFileName, Nothing)
         Next

         Console.WriteLine("OCR document contains {0} pages", ocrDocument.Pages.Count)

         ' Export the pages from index 1 to 3 to disk
         ocrDocument.Pages.ExportPages(1, 3, tifFileName, RasterImageFormat.Tif, 1, 1, CodecsSavePageMode.Overwrite)
      End Using

      ' Shutdown the engine
      ' Note: calling Dispose will also automatically shutdown the engine if it has been started
      ocrEngine.Shutdown()
   End Using
End Sub

Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
Public Const OcrAdvantageRuntimeDir As String = "C:\LEADTOOLS 18\Bin\Common\OcrAdvantageRuntime"
End Class

using Leadtools;
using Leadtools.Codecs;
using Leadtools.Forms.Ocr;
using Leadtools.Forms.DocumentWriters;
using Leadtools.Forms;
using Leadtools.ImageProcessing.Core;

public void ExportPagesToFile()
{
   string tifFileName = Path.Combine(LEAD_VARS.ImagesDir, "OcrMultiPage.tif");
   // Create an instance of the engine
   using (IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, false))
   {
      // Since we have a RasterCodecs object, re-use it in the OCR engine. Although
      // this demo will not use it, it is always a good practice
      ocrEngine.Startup(null, null, null, LEAD_VARS.OcrAdvantageRuntimeDir);

      // Create an OCR document
      using (IOcrDocument ocrDocument = ocrEngine.DocumentManager.CreateDocument())
      {
         // Loop through the images, add them to the document
         for (int i = 0; i < 4; i++)
         {
            string pageFileName = Path.Combine(LEAD_VARS.ImagesDir, string.Format("Ocr{0}.tif", i + 1));
            ocrDocument.Pages.AddPage(pageFileName, null);
         }

         Console.WriteLine("OCR Document contains {0} pages", ocrDocument.Pages.Count);

         // Export the pages from index 1 to 3 to disk
         ocrDocument.Pages.ExportPages(1, 3, tifFileName, RasterImageFormat.Tif, 1, 1, CodecsSavePageMode.Overwrite);
      }

      // Shutdown the engine
      // Note: calling Dispose will also automatically shutdown the engine if it has been started
      ocrEngine.Shutdown();
   }
}

static class LEAD_VARS
{
public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
public const string OcrAdvantageRuntimeDir = @"C:\LEADTOOLS 18\Bin\Common\OcrAdvantageRuntime";
}

Target Platforms

Reference

IOcrPageCollection Interface
IOcrPageCollection Members
Overload List
OcrEngineManager Class
OcrEngineType Enumeration
IOcrPage Interface
Programming with the LEADTOOLS .NET OCR
Summary of All Supported Image File Formats