←Select platform

Linearize Method

Summary

Converts the file associated with this PDFFile object to a linearized version (optimized for Web viewing).

Syntax

C++

public void Linearize(  
   string destinationFileName 
)

Public Sub Linearize( _ 
   ByVal destinationFileName As String _ 
)

public: 
void Linearize(  
   String^ destinationFileName 
)

Parameters

destinationFileName
Name of the destination PDF file to be created. If the value of this parameter is null then the filename set in FileName will be updated.

Remarks

A Linearized PDF file is a file that has been organized in a special way to enable efficient, incremental access in a network environment. The first page of the PDF file is displayed in a user Web browser before the entire file is downloaded from the Web server.

To use this method, associate the PDFFile object with a valid PDF filename and optional password. Do this by either using the PDFFile(string fileName) or PDFFile(string fileName, string password) constructor or set the filename 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:

DocumentProperties. If the value of this property is null, then default properties will be used.
CompatibilityLevel. The PDF version to be generated.

The following properties are not used by this method:

SecurityOptions. You cannot create encrypted linearized PDF files

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

Example

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

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") 
   Dim pdfFile As PDFFile = New PDFFile(sourceFileName) 
   pdfFile.Linearize(destinationFileName) 
 
   ' 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:\Users\Public\Documents\LEADTOOLS Images" 
End Class

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"); 
   PDFFile pdfFile = new PDFFile(sourceFileName); 
   pdfFile.Linearize(destinationFileName); 
 
   // 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:\Users\Public\Documents\LEADTOOLS Images"; 
}