19.5.28 cmd

This element describes the several non-durational commands that can be executed within a timeline. This can be used to send events, call functions on elements, and send verbs to embedded objects. For example “Object Action” effects for Embedded objects and Media commands for sounds/movies such as “PlayFrom(0.0)” and “togglePause”.

Attributes

cmd (Command)

This attribute defines the actual command to be issued. Depending on the command specified, the actual command can be made to invoke a wide range of actions on the linked or embedded object.

Reserved Values (when type = “call”):

Description

play corresponding media

play corresponding media starting from s, where s is the number of seconds from the beginning of the clip

pause corresponding media

resume play of corresponding media

stop play of corresponding media

play corresponding media if media is already paused, pause corresponding media if media is already playing. If the corresponding media is not active, this command restarts the media and plays from its beginning.

Reserved Values (when type = “evt”): Value

Description

stop play of all audio

Reserved Values (when type = “verb”): Value

Description

Open the object for editing

Open the object for viewing

The value of the cmd attribute shall be the string representation of an integer that represents the embedded object verb number. This verb number determines the action that the rendering application should take corresponding to this object when this point in the animation is reached.

[Example: Consider the following command

Attributes

type (Command Type)

In the above example, the event of onstopaudio stops all audio from playing once this particular animation is reached in the timeline.

The possible values for this attribute are defined by the W3C XML Schema string datatype.

This attribute specifies the kind of command that is issued by the rendering application to the appropriate target application or object.

There are three possible values, call, evt, and verb. A call command type is used to specify the class of commands that can then be issued.

Call commands (type=”call”): This command type is used to call methods on the object specified (play(), pause(), etc.)

Event Commands (type=”evt”): This command type is used to set an event for the object at this point in the timeline (onstopaudio, etc.)

Verb Commands (type=”verb”): This command type is used to set verbs for the object to occur at this point in the timeline (0, 1, etc.)

The possible values for this attribute are defined by the ST_TLCommandType simple type (19.7.32).

[Note: The W3C XML Schema definition of this element’s content model (CT_TLCommandBehavior) is located in A.3. end note]

Last updated on