Tailoring the Output
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.