Introduction

This chapter explains how to tailor your output to:

  • Retain annotations from the original document (removed by default)
  • Achieve faster web delivery through linearization

Retaining Annotations

By default, APSplit excludes page annotations from the output files it creates. Annotations include notes, text, audio, stamps, form fields (Widgets), files, pencil marks, rectangles, ellipses, lines, highlights, cross outs (strikethroughs), and underlines.

If you want annotations from the input to appear in the output, use the -keepannots option.

Command

$ apsplit -keepannots -o outPDFFileorDir [other options] inPDFFile [inPDFFile2...]

Windows

> apsplit -keepannots -o C:\Appligent\APSplit\output\ C:\Appligent\APSplit\samples\SplitSample.pdf

UNIX/Macintosh

$ ./apsplit -keepannots -o /Appligent/APSplit/output/ /Appligent/APSplit/samples/SplitSample.pdf

Result

All annotations in SplitSample.pdf are retained in the files extracted to the output directory.

Linearizing for Faster Web Delivery

Linearizing a multipage file reorganizes it for more efficient web delivery. Individual pages can be rendered before the entire document has downloaded, so the user can start reading the document sooner.

To linearize multipage output, use the -w option.

Note: Linearization only works with multipage files. Attempting to linearize a one-page file will result in a larger file with no increase in web service efficiency.

Command

$ apsplit -w -o outPDFFileorDir [other options] inPDFFile [inPDFFile2...]

Windows

> apsplit -w -o C:\Appligent\APSplit\output\ -bybookmarks C:\Appligent\APSplit\samples\SplitSample.pdf

UNIX/Macintosh

$ ./apsplit -w -o /Appligent/APSplit/output/ -bybookmarks /Appligent/APSplit/samples/SplitSample.pdf

Result

APSplit creates one file for each first-level bookmark section. Each output file is linearized for more efficient web service.