Table 296 – Entries in a movie activation dictionary

Key

Type

Value

Start

(various)

(Optional) The starting time of the movie segment to be played. Movie time values shall be expressed in units of time based on a time scale, which defines the number of units per second. The default time scale shall be defined in the movie data. The starting time shall be nominally a non-negative 64-bit integer, specified as follows:

• If it is representable as an integer (subject to the implementation limit for integers, as described in Annex C ), it shall be specified as such.

• If it is not representable as an 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.

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

name

(Optional) The play mode for playing the movie:

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 conforming reader 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 295 ).

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 ] centers the window on the screen.

Default value: [ 0.5 0.5 ].