• Create BookmarkCreate Bookmark
  • Create Note or TagCreate Note or Tag
  • PrintPrint
Share this Page URL
Help

Chapter 8. Interactive Features > Viewer Preferences

8.1. Viewer Preferences

The ViewerPreferences entry in a document's catalog (see Section 3.6.1, “Document Catalog”) designates a viewer preferences dictionary (PDF 1.2) controlling the way the document is to be presented on the screen or in print. If no such dictionary is specified, viewing and printing applications should behave in accordance with their own current user preference settings. Table 8.1 shows the contents of the viewer preferences dictionary. (See implementation note 73 in Appendix H.)

Table 8.1. Entries in a viewer preferences dictionary
KEYTYPEVALUE
HideToolbarboolean(Optional) A flag specifying whether to hide the viewer application's tool bars when the document is active. Default value: false.
HideMenubarboolean(Optional) A flag specifying whether to hide the viewer application's menu bar when the document is active. Default value: false.
HideWindowUIboolean(Optional) A flag specifying whether to hide user interface elements in the document's window (such as scroll bars and navigation controls), leaving only the document's contents displayed. Default value: false.
FitWindowboolean(Optional) A flag specifying whether to resize the document's window to fit the size of the first displayed page. Default value: false.
CenterWindowboolean(Optional) A flag specifying whether to position the document's window in the center of the screen. Default value: false.
DisplayDocTitleboolean(Optional; PDF 1.4) A flag specifying whether the window's title bar should display the document title taken from the Title entry of the document information dictionary (see Section 10.2.1, “Document Information Dictionary”). If false, the title bar should instead display the name of the PDF file containing the document. Default value: false.
NonFullScreenPageModename(Optional) The document's page mode, specifying how to display the document on exiting full-screen mode:
 UseNoneNeither document outline nor thumbnail images visible
 UseOutlinesDocument outline visible
 UseThumbsThumbnail images visible
 UseOCOptional content group panel visible
This entry is meaningful only if the value of the PageMode entry in the catalog dictionary (see Section 3.6.1, “Document Catalog”) is FullScreen; it is ignored otherwise. Default value: UseNone.
Directionname(Optional; PDF 1.3) The predominant reading order for text:
 L2RLeft to right
 R2LRight to left (including vertical writing systems, such as Chinese, Japanese, and Korean)
This entry has no direct effect on the document's contents or page numbering but can be used to determine the relative positioning of pages when displayed side by side or printed n-up. Default value: L2R.
ViewAreaname(Optional; PDF 1.4) The name of the page boundary representing the area of a page to be displayed when viewing the document on the screen. The value is the key designating the relevant page boundary in the page object (see “Page Objects” on page 119 and Section 10.10.1, “Page Boundaries”). If the specified page boundary is not defined in the page object, its default value is used, as specified in Table 3.27 on page 119. Default value: CropBox.

Note

This entry is intended primarily for use by prepress applications that interpret or manipulate the page boundaries as described in Section 10.10.1, “Page Boundaries.” Most PDF consumer applications disregard it.

ViewClipname(Optional; PDF 1.4) The name of the page boundary to which the contents of a page are to be clipped when viewing the document on the screen. The value is the key designating the relevant page boundary in the page object (see “Page Objects” on page 119 and Section 10.10.1, “Page Boundaries”). If the specified page boundary is not defined in the page object, its default value is used, as specified in Table 3.27 on page 119. Default value: CropBox.

Note

This entry is intended primarily for use by prepress applications that interpret or manipulate the page boundaries as described in Section 10.10.1, “Page Boundaries.” Most PDF consumer applications disregard it.

PrintAreaname(Optional; PDF 1.4) The name of the page boundary representing the area of a page to be rendered when printing the document. The value is the key designating the relevant page boundary in the page object (see “Page Objects” on page 119 and Section 10.10.1, “Page Boundaries”). If the specified page boundary is not defined in the page object, its default value is used, as specified in Table 3.27 on page 119. Default value: CropBox.

Note

This entry is intended primarily for use by prepress applications that interpret or manipulate the page boundaries as described in Section 10.10.1, “Page Boundaries.” Most PDF consumer applications disregard it.

PrintClipname(Optional; PDF 1.4) The name of the page boundary to which the contents of a page are to be clipped when printing the document. The value is the key designating the relevant page boundary in the page object (see “Page Objects” on page 119 and Section 10.10.1, “Page Boundaries”). If the specified page boundary is not defined in the page object, its default value is used, as specified in Table 3.27 on page 119. Default value: CropBox.

Note

This entry is intended primarily for use by prepress applications that interpret or manipulate the page boundaries as described in Section 10.10.1, “Page Boundaries.” Most PDF consumer applications disregard it.

PrintScalingname(Optional; PDF 1.6) The page scaling option to be selected when a print dialog is displayed for this document. Valid values are None, which indicates that the print dialog should reflect no page scaling, and AppDefault, which indicates that applications should use the current print scaling. If this entry has an unrecognized value, applications should use the current print scaling. Default value: AppDefault.

Note

If the print dialog is suppressed and its parameters are provided directly by the application, the value of this entry should still be used.



PREVIEW

                                                                          

Not a subscriber?

Start A Free Trial


  
  • Creative Edge
  • Create BookmarkCreate Bookmark
  • Create Note or TagCreate Note or Tag
  • PrintPrint