HTML+TIME: DirectMusic
This topic documents a feature of HTML+TIME 2.0, which is obsolete as of Windows Internet Explorer 9.
Authors can add sophisticated musical content to Web pages by combining the timeline control and synchronization offered by Introduction to HTML+TIME with some of the attributes and properties provided by the Microsoft DirectMusic API. DirectMusic provides support for MIDI, downloadable sounds, and consistent playback on the Windows platform.
The following links provide access to the object model exposed by the time behavior.
Overviews
In HTML+TIME (Timed Interactive Multimedia Extensions) various types of media, animation, and other time elements can be played over a period of time. It is often desirable to be able to jump to any point on this time line. This process of jumping to different points on a time element's time line is called seeking.
Using HTML+TIME with DirectMusic
This article briefly discusses some of the ways you can use HTML+TIME to add flexibility and control to DirectMusic content on the Web.
Using the HTML+TIME Document Object Model (DOM)
All HTML+TIME objects are accessible through script at run time. This article introduces you to the HTML+TIME objects, methods, events, and properties available to your Web pages.
Tutorials
Incorporate the time2 Behavior
This tutorial explains how to incorporate the time2 behavior in your Web pages so you can begin using timelines, multimedia, and animation with HTML elements.
DirectMusic Elements and Objects
Contains information about an HTML+TIME timeline.
Attributes and Properties
Sets or gets a value that applies an acceleration to an element timeline.
Gets the total duration of the timeline.
Gets the current point in time along the total active timeline, including repeats and time spent in reverse mode.
Sets or gets whether the timeline on an element begins playing in reverse immediately after it completes in the forward direction.
Sets or gets the delay time before the timeline begins playing on the element.
Sets when music should begin to play by using DirectMusic.
Gets a value that indicates the currentFrame of the object.
Sets or gets a value that applies a deceleration to the end of a simple duration.
Sets or gets a value indicating the amount of time the element remains active or displayed.
Sets or gets a value indicating the end time for the element, or the end of the simple duration when the element is set to repeat.
Sets or gets the action taken by an element if the element timeline ends before the timeline on its parent element ends.
Sets a value that indicates whether a DirectMusic segment ends immediately or plays a transition before ending.
Gets a value that indicates whether the element is currently active on the timeline.
Gets a Boolean value that indicates whether DirectMusic is installed on the machine.
Gets a value that specifies whether the element is active or holding on the timeline in its current state.
Gets a value that specifies whether the element is paused on the timeline.
Gets a Boolean value that indicates if the source of the media object is streamed.
Gets a Boolean value that indicates if the source of the media object is streamed.longTransition
Sets whether to allow introduction and ending transitions longer than one bar with DirectMusic.
Sets whether to attempt to modulate between keys when playing transitions with DirectMusic.
Sets the name of the DirectMusic motif to play.
Gets the begin time of the current element as an offset from the begin time of the parent element.
Gets the end time of the current element as an offset from the begin time of the parent element.
Gets the current progress of the element timeline.
Gets the current iteration in the repetition loop.
Sets or gets the number of times an element timeline repeats.
Sets or gets the number of seconds that an element timeline repeats.
Sets or gets the number of seconds that an element timeline repeats.restart
Sets or gets the conditions under which an element can be restarted on a timeline.
Gets the duration of an element on a timeline in seconds, including autoReverse.
Gets the current point in time along a segment of time.
Sets whether to play a DirectMusic segment as a controlling segment or a secondary segment.
Gets the duration of a repeat iteration.
Gets an object's current point along its timeline from zero to its dur value.
Sets or gets the playback speed of an element relative to its parent time container.
Gets the playback speed of an element at run time, which includes the cascading effect of the speed set for the parent time container.
Gets the current state of the element timeline.
Gets the current state of the element timeline.
Sets or gets a value that indicates the synchronization rules for the element timeline.
Sets or gets whether the time container must synchronize playback to this element.
Sets or gets the time variance that is allowed on a timeline with locked synchronization.
Sets or gets the action that is taken on the element while the timeline is active.
Sets or gets the type of timeline associated with an element.
Gets the parent time container element of the current element.
Sets or gets the type of DirectMusic transition to use between segments.
Sets or gets the volume of the media file.
Gets the playback volume of an element at run time.
Methods
Converts a value in the element's active timeline to the corresponding point in the parent timeline.
Converts a value in the element's active timeline to the corresponding point in the segment timeline.
Starts the element on the timeline.
Starts an element's timeline at the specified time.
Converts a value in the document timeline to the corresponding point in the element's parent timeline.
Stops the element on the timeline.
Ends an element's timeline at the specified time.
Converts a value in the parent timeline to the corresponding point in the element's active timeline.
Converts a value in the element's parent timeline to the corresponding point in the document timeline.
Stops playing an element's timeline at the current point.
Removes any changes made to the element and returns the element to its original state.
Restarts the element's timeline from a paused state.
Locates a specified point on the element's active timeline and begins playing from that point.
Locates a specified point on the element's active timeline and begins playing from that point.seekTo
Locates a specified point on the element's segment timeline, including repetitions, and begins playing from that point.
Locates a specified frame in the object.
Converts a value in the element's segment timeline to the corresponding point in the element's active timeline.
Converts a value in the element's segment timeline to the corresponding point in the element's simple timeline.
Converts a value in the element's simple timeline to the corresponding point in the element's segment timeline.
Events
Fires when the timeline starts on an element.
Fires when the timeline stops on an element.
Fires when the element's associated media finish loading.
Fires when the element's associated media finish loading.onmediaerror
Fires when an element's media file causes any error.
Fires when the element loses synchronization with its associated timeline.
Fires when the timeline on an element pauses.
Fires when the timeline repeats on an element, beginning with the second iteration.
Fires when the timeline reaches the value of the BEGIN attribute or when the resetElement method is called on the element.
Fires when an element's timeline resumes from a paused state.
Fires when the timeline on an element begins to play backward.
Fires whenever a seek operation is performed on the element.
Fires when synchronization is resumed between the element and its associated timeline.
Fires whenever a time-specific error occurs, usually as a result of setting a property to an invalid value.