CHAPTER 9
772
Multimedia Features
hosting a media object. This recommendation may be relaxed if it is possible to com-
municate the nature of such windows to the user; for example, with text in a float-
ing window’s title bar.
TABLE 9.17 Entries in a media screen parameters dictionary
KEY
TYPE
VALUE
Type
name
dictionary
dictionary
(Optional)
The type of PDF object that this dictionary describes; if present, must be
MediaScreenParams
for a media screen parameters dictionary.
(Optional)
A dictionary whose entries (see Table 9.18) must be honored for the me-
dia screen parameters to be considered viable.
(Optional)
A dictionary whose entries (see Table 9.18) need only be honored in a
“best effort” sense.
MH
BE
TABLE 9.18 Entries in a media screen parameters MH/BE dictionary
KEY
TYPE
VALUE
W
integer
(Optional)
The type of window that the media object should play in:
0
1
2
3
A floating window
A full-screen window that obscures all other windows
A hidden window
The rectangle occupied by the screen annotation (see “Screen
Default value: 3. Unrecognized value in
MH
: object is non-viable; in
BE
: treat as de-
fault value.
B
array
(Optional)
An array of three numbers in the range 0.0 to 1.0 specifying the compo-
nents in the
DeviceRGB
color space of the background color for the rectangle in
which the media is being played. This color is used if the media object does not en-
tirely cover the rectangle or if it has transparent sections. Ignored for hidden win-
dows.
Default value: implementation-defined. The viewer application should choose a
reasonable value based on the value of
W
; for example, a system default background
color for floating windows or a user-preferred background color for full-screen
windows.
Note:
If a media format has an intrinsic background color,
B
does not override it.
However, the
B
color is visible if the media has transparent areas or otherwise does not
cover the entire window.