Table 280 – Entries in a media play parameters MH/BE dictionary

Key

Type

Value

V

integer

(Optional) An integer that specifies the desired volume level as a percentage of recorded volume level. A zero value shall be equivalent to mute; negative values shall be illegal. Default value: 100.

C

boolean

(Optional) A flag specifying whether to display a player-specific controller user interface when playing.

EXAMPLE play/pause/stop controls.

Default value: false

F

integer‘

(Optional) The manner in which the player shall treat a visual media type that does not exactly fit the rectangle in which it plays.

0The media’s width and height shall be scaled while preserving the aspect ratio so that the media and play rectangles have the greatest possible intersection while still displaying all media content.

NOTE 1 Same as “meet” value of SMIL’s fit attribute.

1 The media’s width and height shall be scaled while preserving the aspect ratio so that the play rectangle is entirely filled, and the amount of media content that does not fit within the play rectangle shall be minimized.

NOTE 2 Same as “slice” value of SMIL’s fit attribute.

2 The media’s width and height shall be scaled independently so that the media and play rectangles are the same; the aspect ratio shall not be preserved.

NOTE 3 Same as “fill” value of SMIL’s fit attribute.

3 The media shall not be scaled. A scrolling user interface shall be provided if the media rectangle is wider or taller than the play rectangle.

NOTE 4 Same as “scroll” value of SMIL’s fit attribute.

4 The media shall not be scaled. Only the portions of the media rectangle that intersect the play rectangle shall be displayed.

NOTE 5 Same as “hidden” value of SMIL’s fit attribute.

5 Use the player’s default setting (author has no preference).

Default value: 5.

An unrecognized value shall be treated as the default value if the entry is in a BE dictionary. If the entry is in an MH dictionary and it has an unrecognized value, the object shall be considered non-viable.

D

dictionary

(Optional) A media duration dictionary (see Ta b l e 281 ). Default value: a dictionary specifying the intrinsic duration (see RC).

A

boolean

(Optional) If true, the media shall automatically play when activated. If false, the media shall be initially paused when activated.

EXAMPLE The first frame is displayed.

Relevant only for media that may be paused. Default value: true.

RC

number

(Optional) Specifies the number of iterations of the duration D to repeat.

NOTE 6 Similar to SMIL’s repeatCount attribute. Zero means repeat forever. Negative values shall be illegal; non-integral values shall be legal.

Default value: 1.0.