Previous Next


                                                     772
         CHAPTER 9                                                             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               (Optional) The type of PDF object that this dictionary describes; if present, must be
                          MediaScreenParams for a media screen parameters dictionary.

MH     dictionary         (Optional) A dictionary whose entries (see Table 9.18) must be honored for the me-
                          dia screen parameters to be considered viable.

BE     dictionary         (Optional) A dictionary whose entries (see Table 9.18) need only be honored in a
                          “best effort” sense.




                    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            A floating window
                             1            A full-screen window that obscures all other windows
                             2            A hidden window
                             3            The rectangle occupied by the screen annotation (see “Screen
                                          Annotations” on page 639) associated with the media rendition
                          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.

Previous Next