Tuesday, June 19, 2012

Acrobat Distiller/Normalizer joboptions AutoRotatePages settings and behavior

In the Adobe Distiller or Normalizer products, there is a joboptions file that controls presentation and conversion to PDF behavior.

I've been doing some research around the settings for the AutoRotatePages entry in this file. When editing the joboptions file with a text editor, the valid values are "None", "All" and "PageByPage". These correspond to the GUI editor settings "Off", "Collectively By File" and "Individually". 
In theory, the settings mean:

  •  None/Off: Do not perform any automatic page rotation. 
  • All/Collectively By File: Rotate the minority number of pages such that all pages are presented in the orientation of the majority of pages. 
  • PageByPage/Individually: Present each page such that its native orientation is demonstrated 


In practice, it's a little more complex.

A PDF document has a default orientation that applies to every page. That orientation is either portrait or landscape.

One can give the impression of a differing orentation for a subset of the pages by using page rotation. For example, a Portrait PDF file may have pages that appear in landscape orientation by rotating it 90 degress clockwise or counter clockwise.

Additionally, using the Document->Insert pages menu item in Acrobat Pro, one can insert pages that are in a different orientation than the rest of the PDF. This is not accomplished using page rotation, but by defining the page dimensions (in points) for a page. It is not possible to change an existing page's dimensions, nor is it possible to add a new page with different page dimensions.

Consider this PDF (Portrait with inserted landscape pages)
After distilling/normalizing, the resulting PDF page orientation with various settings of AutoRotatePages is:
None: All pages are displayed portrait, but page 2 and 3 are rotated 90 degrees counter clockwise
All: Same
PageByPage: Same

Consider this PDF (Landscape with inserted portrait pages)
After distilling/normalizing, the resulting PDF page orientation with various settings of AutoRotatePages is:
None: All pages are displayed portrait, with landscape pages rotates 90 degress counter clockwise
All: All pages are displayed landscape, with portrait pages rotated 90 degrees clockwise
PageByPage: All pages displayed landscape, with portrait pages rotated 90 degrees clockwise.
Analysis:
Page By Page setting does not work. It should show each page in its native orientation but it always behaves the same as "All".
All setting makes all the pages render in the same orientation, based on a majority of page orientation. This setting should be used in most cases.

No comments: