Property Linearize

Namespace

BitMiracle.Docotic.Pdf

Assembly

BitMiracle.Docotic.Pdf.dll

Linearize

Gets or sets a value indicating whether output PDF files should be linearized for faster web viewing.

public bool Linearize { get; set; }

Property Value

bool

true if library should linearize output PDF files; otherwise, false.

Remarks

Default value: false.

Linearization (sometimes called Fast Web View by Adobe) restructures a PDF document for page-at-a-time downloading (byte-serving) from web servers.

A linearized (or a Fast Web View optimized) PDF file is a file that has been organized in a special way to enable efficient incremental access in a network environment. The file is valid PDF in all respects, and is compatible with all existing viewers and other PDF applications. Enhanced viewer applications can recognize that a PDF file has been linearized and can take advantage of that organization (as well as added hint information) to enhance viewing performance. This is especially important with large documents that can take a long time to download from a server.

Please note that linearized document will display faster if you set PageLayout property to SinglePage and PageMode property to UseNone because it will minimize the amount of objects a PDF viewer should process before showing first page of the document.

Please note that fillable PDF forms won't usually benefit from being linearized.

The value of this property is ignored when WriteIncrementally is true because mixing linearization and incremental updates can yield unexpected results. The library will produce a non-linearized file when updating a file incrementally.