Repository navigation
PDF20 Spec 13 Movies
Part of: PDF20-Spec-13-Multimedia
Navigation: PDF20-Spec-13-Sounds | PDF20-Spec-Index | PDF20-Spec-13-Alternate
13.4 Movies The features described in this subclause are deprecated with PDF 2.0. They are superseded by the general multimedia framework described in 13.2, "Multimedia". 638
© ISO 2020 – All rights reserved
ISO 32000-2:2020(E)
PDF may embed movies within a document by means of movie annotations (see 12.5.6.17, "Movie annotations"). Despite the name, a movie may consist entirely of sound with no visible images to be displayed on the screen. The Movie and A (activation) entries in the movie annotation dictionary shall refer, respectively, to a movie dictionary ("Table 306 — Entries in a movie dictionary") that shall describe the static characteristics of the movie and a movie activation dictionary ("Table 307 — Entries in a movie activation dictionary") that shall specify how it shall be presented. Table 306 — Entries in a movie dictionary Key
Type
Value
F
file specification
(Required) A file specification identifying a self-describing movie file. The format of a self-describing movie file shall be left unspecified, and there is no guarantee of portability.
Aspect
array
(Optional) The width and height of the movie’s bounding box, in pixels, and shall be specified as [width height]. This entry should be omitted for a movie consisting entirely of sound with no visible images.
Rotate
integer
(Optional) The number of degrees by which the movie shall be rotated clockwise relative to the page. The value shall be a multiple of 90. Default value: 0.
Poster
boolean or stream
(Optional) A flag or stream specifying whether and how a poster image representing the movie shall be displayed. If this value is a stream, it shall contain an image XObject (see 8.9, "Images") to be displayed as the poster. If it is the boolean value true, the poster image shall be retrieved from the movie file; if it is false, no poster shall be displayed. Default value: false.
Table 307 — Entries in a movie activation dictionary Key
Type
Value
Start
(various)
(Optional) The starting time shall be nominally a non-negative 64-bit integer, specified as follows: •
If it is representable as a 32 bit integer, it shall be specified as such.
•
If it is not representable as a 32 bit integer, it shall be specified as an 8-byte string representing a 64-bit twos-complement integer, most significant byte first.
•
If it is expressed in a time scale different from that of the movie itself, it shall be represented as an array of two values: an integer or byte string denoting the starting time, followed by an integer specifying the time scale in units per second.
If this entry is omitted, the movie shall be played from the beginning. Duration
(various)
(Optional) The duration of the movie segment to be played, that shall be specified in the same form as Start. If this entry is omitted, the movie shall be played to the end.
Rate
number
(Optional) The initial speed at which to play the movie. If the value of this entry is negative, the movie shall be played backward with respect to Start and Duration. Default value: 1.0.
© ISO 2020 – All rights reserved
639
ISO 32000-2:2020(E)
Key
Type
Value
Volume
number
(Optional) The initial sound volume at which to play the movie, in the range -1.0 to 1.0. Higher values shall denote greater volume; negative values shall mute the sound. Default value: 1.0.
ShowControls boolean
(Optional) A flag specifying whether to display a movie controller bar while playing the movie. Default value: false.
Mode
(Optional) The play mode for playing the movie:
name
Once
Play once and stop.
Open
Play and leave the movie controller bar open.
Repeat
Play repeatedly from beginning to end until stopped.
Palindrome Play continuously forward and backward until stopped. Default value: Once. Synchronous
boolean
(Optional) A flag specifying whether to play the movie synchronously or asynchronously. If this value is true, the movie player shall retain control until the movie is completed or dismissed by the user. If the value is false, the player shall return control to the interactive PDF processor immediately after starting the movie. Default value: false.
FWScale
array
(Optional) The magnification (zoom) factor at which the movie shall be played. The presence of this entry implies that the movie shall be played in a floating window. If the entry is absent, the movie shall be played in the annotation rectangle. The value of the entry shall be an array of two positive integers, [numerator denominator], denoting a rational magnification factor for the movie. The final window size, in pixels, shall be (numerator ÷ denominator) × Aspect where the value of Aspect shall be taken from the movie dictionary (see "Table 306 — Entries in a movie dictionary").
FWPosition
array
(Optional) For floating play windows, the relative position of the window on the screen. The value shall be an array of two numbers [horiz vert] each in the range 0.0 to 1.0, denoting the relative horizontal and vertical position of the movie window with respect to the screen. EXAMPLE
The value [0.5 0.5] centres the window on the screen.
Default value: [0.5 0.5].
Navigation: PDF20-Spec-13-Sounds | PDF20-Spec-Index | PDF20-Spec-13-Alternate