StartOptimizedLoad() Method

Summary

Start optimized page loading for the same source image file or document in this RasterCodecs object.

Syntax

C++

public void StartOptimizedLoad()

Public Sub StartOptimizedLoad()

public:  
   void StartOptimizedLoad()

Remarks

Optimizes getting information, loading or conversion from a file with multiple pages. Call this method before a loop that involves loading from the same source file or stream. Call StopOptimizedLoad when finished.

This method should be used only if the source file is the same and its contents is unchanged.

This method can greatly speed up a loop involving multiple GetInformation, GetInformationAsync, Load, LoadAsync, or Convert) methods for certain formats (for example, TXT, DOCX, and PDF files).

For more information, refer to Using the OptimizedLoad Functions to Speed Loading Large Files.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Svg; 
using LeadtoolsExamples.Common; 
 
public void OptimizedLoadExample() 
{ 
   using (RasterCodecs codecs = new RasterCodecs()) 
   { 
      // The speed improvement is most noticeable in source files with many pages 
      string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "MultiPage.pdf"); 
 
      // indicate the start of a loop from the same source file 
      codecs.StartOptimizedLoad(); 
 
      for (int i = 1; i < 10; i++) 
      { 
         using (RasterImage image = codecs.Load(srcFileName, i)) 
         { 
            string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "out_" + i.ToString() + ".jpg"); 
            // Save as the destination image 
            codecs.Save(image, destFileName, RasterImageFormat.Jpeg411, 24); 
         } 
      } 
 
      // Indicate that I finished using the same source file. 
      codecs.StopOptimizedLoad(); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing 
Imports Leadtools.ImageProcessing.Color 
Imports Leadtools.Drawing 
Imports Leadtools.Svg 
 
Public Sub OptimizedLoadExample() 
   Using codecs As RasterCodecs = New RasterCodecs() 
 
      ' The speed improvement is most noticeable in source files with many pages 
      Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "MultiPage.pdf") 
 
      ' indicate the start of a loop from the same source file 
      codecs.StartOptimizedLoad() 
 
      For i As Integer = 1 To 10 
         Using image As RasterImage = codecs.Load(srcFileName, i) 
            Dim destFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "out_" + i.ToString() + ".jpg") 
            ' Save as the destination image 
            codecs.Save(image, destFileName, RasterImageFormat.Jpeg411, 24) 
         End Using 
      Next 
 
      ' Indicate that I finished using the same source file. 
      codecs.StopOptimizedLoad() 
   End Using 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class

Requirements

Target Platforms

Reference

RasterCodecs Class

RasterCodecs Members

Leadtools.Codecs Namespace

Download our FREE evaluation

Help Version 20.0.2020.4.3

Leadtools.Codecs Assembly

Introduction

Getting Started

Namespaces

Leadtools.Codecs Namespace

Assemblies