←Select platform

Linearize Method

Converts the file associated with this PDFFile object into a linearized version (one optimized for Web viewing).
public void Linearize( 
   string destinationFileName 
Public Sub Linearize( _ 
   ByVal destinationFileName As String _ 
void Linearize(  
   String^ destinationFileName 

public void linearize( 
   java.lang.String string 


Name of the destination PDF file to be created. If the value of this parameter is null, the file name will be pulled from FileName.


A linearized PDF file is a file that has been organized to enable efficient, incremental access in a network environment. The requested page of the PDF file is displayed in a user Web browser while the rest of the file is downloaded from the Web server.

To use this method, associate the PDFFile object with a valid PDF file name and optional password. Do this by either using the PDFFile(string fileName) or PDFFile(string fileName, string password) constructor, or set the file name and optional password directly by setting the FileName and Password properties. It is not necessary to call Load before using this method.

This method will use the following properties of the PDFFile object:

The following property is not used by this method:

Call IsLinearized to quickly determine if a PDF file is linearized.

Note: Currently, generating linearized PDF files with PDF/A compatibility can result in a PDF file that is not compatible with Adobe Preflight.


This example will linearize a PDF (optimize it for Web viewing).

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Controls; 
using Leadtools.Drawing; 
using Leadtools.ImageProcessing; 
using Leadtools.Pdf; 
using Leadtools.Svg; 
using Leadtools.WinForms; 
public void PDFFileLinearizeExample() 
   string sourceFileName = Path.Combine(LEAD_VARS.ImagesDir, @"Leadtools.pdf"); 
   string destinationFileName = Path.Combine(LEAD_VARS.ImagesDir, @"LEAD_linearized.pdf"); 
   // Ensure that the source file is not linearized 
   bool isLinearized = PDFFile.IsLinearized(sourceFileName, null); 
   Console.WriteLine("PDF file {0} isLinearized = {1}", sourceFileName, isLinearized); 
   PDFFile pdf = new PDFFile(sourceFileName); 
   // Ensure that the destination file is linearized 
   isLinearized = PDFFile.IsLinearized(destinationFileName, null); 
   Console.WriteLine("PDF file {0} isLinearized = {1}", destinationFileName, isLinearized); 
   // Check again using PDFDocument class 
   using (PDFDocument document = new PDFDocument(destinationFileName)) 
      isLinearized = document.IsLinearized; 
      Console.WriteLine("PDF document {0} isLinearized = {1}", destinationFileName, isLinearized); 
   // Open the destination file in Adobe Acrobat and go to 
   // File/Properties. You should see the "Fast Web View" option as "Yes"; 
static class LEAD_VARS 
   public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images"; 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.Pdf 
Imports Leadtools.WinForms 
Imports Leadtools.Svg 
Imports Leadtools.ImageProcessing 
Public Sub PDFFileLinearizeExample() 
   Dim sourceFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Leadtools.pdf") 
   Dim destinationFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "LEAD_linearized.pdf") 
   ' Ensure that the source file Is Not linearized 
   Dim isLinearized As Boolean = PDFFile.IsLinearized(sourceFileName, Nothing) 
   Console.WriteLine("PDF file {0} isLinearized = {1}", sourceFileName, isLinearized) 
   Dim pdf As PDFFile = New PDFFile(sourceFileName) 
   ' Ensure that the destination file Is linearized 
   isLinearized = PDFFile.IsLinearized(destinationFileName, Nothing) 
   Console.WriteLine("PDF file {0} isLinearized = {1}", destinationFileName, isLinearized) 
   ' Check again using PDFDocument class 
   Using document As New PDFDocument(destinationFileName) 
      isLinearized = document.IsLinearized 
      Console.WriteLine("PDF document {0} isLinearized = {1}", destinationFileName, isLinearized) 
   End Using 
   ' Open the destination file in Adobe Acrobat and go to 
   ' File/Properties. You should see the "Fast Web View" option as "Yes"; 
End Sub 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\LEADTOOLS21\Resources\Images" 
End Class 

Target Platforms

See Also


PDFFile Class

PDFFile Members

Help Version 21.0.2021.3.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Pdf Assembly