Adobe Acrobat SDK
Interactive Features (Chapter 8 in PDF Reference)
Adobe® Supplement to the ISO 32000
8.2.4 Collections 34
As previously mentioned, files in the
EmbeddedFiles
name tree are associated with folders by a special
naming convention applied to the name tree key strings. Strings that conform to the following rules serve
to associate the corresponding file with a folder:
●
The name tree keys are PDF text strings.
●
The first character, excluding any byte order marker, is U+003C, the LESS-THAN SIGN (<).
●
The following characters shall one or more digits (0 to 9) followed by the closing U+003E, the
GREATER-THAN SIGN (>)
●
The remainder of the string is a file name.
The section of the string enclosed by LESS-THAN SIGN GREATER-THAN SIGN(
<>)
is interpreted as a
numeric value that specifies the
ID
value of the folder with which the file is associated. The value shall
correspond to a folder
ID
. The section of the string following the folder ID tag represents the file name of
the embedded file.
Files in the
EmbeddedFiles
name tree that do not conform to these rules shall be treated as associated
with the root folder.
Navigators
Beginning with extension level 3, a portable collection can include a SWF file-based interactive layout, or
presentation, of the collection contents. The SWF file that manages the presentation is called a
navigator
. A
conforming interactive reader shall play the SWF file that drives the presentation of the collection, unless
some other considerations such as accessibility require a non-SWF file-based presentation. (See
implementation note E-2,
page 130
.)
This section describes how navigator information is stored in a PDF file, but does not describe the SWF file
that implements the navigator itself. (See implementation note E-3,
page 130
.)
When a portable collection is created, the
View
entry of the collection dictionary (Table 8.6,
page 29
) is
given a value of
C
to indicate that the collection view is provided by a custom navigator. A
Navigator
entry in the collection dictionary contains an indirect reference to the navigator dictionary that describes
the navigator. Other entries in the collection dictionary may also be present. These include
Resources
,
Colors
,
Folders
, and
Split
. See Table 8.6 on
page 29
for information about these entries.
The navigator dictionary contains a variety of information about the navigator to be used, such as the
location of the SWF file that implements the layout of the collection, a unique ID number, load type, and
resources. The following table lists the entries in the navigator dictionary; the entries used only for
authoring are noted.
TABLE 8.6d Entries in a navigator dictionary
KEY
TYPE
VALUE
SWF
text string
(
Required; ExtensionLevel 3
) The location of the SWF file that
implements the layout of the collection, expressed as an entry in
the navigator's resources tree. See the
Resources
entry later in
this table.
Name
text string
(
Required; ExtensionLevel 3; authoring only
) The name to be
displayed to the user when choosing a navigator in a conforming
interactive reader.
