CHAPTER 9
764
Multimedia Features
TABLE 9.8 Entries common to all media clip dictionaries
KEY
TYPE
VALUE
Type
name
name
(Optional)
The type of PDF object that this dictionary describes; if present, must be
MediaClip
for a media clip dictionary.
(Required)
The subtype of media clip that this dictionary describes. May be
MCD
for
media clip data (see “Media Clip Data” on page 764) or
MCS
for a media clip section
(see “Media Clip Section” on page 767). The media clip is considered non-viable if
the viewer application does not recognize the value of this entry.
(Optional)
The name of the media clip, for use in the user interface.
S
N
text string
Media Clip Data
A
media clip data dictionary
defines the data for a media object that can be
played. For example, it may reference a URL to a streaming video presentation or
a movie embedded in the PDF file. Its entries are listed in Table 9.9.
TABLE 9.9 Additional entries in a media clip data dictionary
KEY
TYPE
VALUE
D
file specification
or stream
ASCII string
(Required)
A full file specification or form XObject that specifies the actual media
data.
(Optional; not allowed for form XObjects)
An ASCII string identifying the type of
data in
D
. The string should conform to the content type specification described in
Internet RFC 2045,
Multipurpose Internet Mail Extensions (MIME) Part One: For-
mat of Internet Message Bodies
(see the Bibliography).
(Optional)
A
media permissions dictionary
(see Table 9.10) containing permissions
that control the use of the media data. Default value: a media permissions dictio-
nary containing default values.
(Optional)
An array that provides alternate text descriptions for the media clip data
in case it cannot be played; see “Multi-language Text Arrays” on page 942.
(Optional)
A
media players dictionary
(see “Media Players Dictionary” on page 777)
that identifies, among other things, players that are legal and not legal for playing
the media.
Note:
If the media players dictionary is non-viable, the media clip data is non-viable.
CT
P
dictionary
Alt
array
dictionary
PL