clip Element
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Note
[Deprecated. This API may be removed from future releases of Windows.]
The clip epecifies a media source.
Attributes
clsid, framerate, lock, mlength, mstart, mstop, mute, src, start, stop, stream, stretchmode, userdata, userid, username
Parent/Child Information
| Label | Value |
|---|---|
| Parent | track |
| Children | effect |
Remarks
The clsid attribute specifies the CLSID of a source filter to use as the source. Do not specify the src and clsid attributes within the same clip element.
Specify at least one start-time attribute (start or mstart) and one stop-time attribute (stop or mstop). If one of the start-time attributes is unspecified, it defaults to 0 (the beginning of the timeline for start, or the beginning of the clip for mstart). If one of the stop-time attributes is unspecified, DES assumes a normal playback rate and calculates the unspecified stop time accordingly. If both stop times are specified, playback is faster or slower than normal, if necessary.
In the following example, the timeline duration is seven seconds (stop minus start). Normal playback rate is assumed, so the media stop time defaults to 10 seconds (the duration plus mstart).
<clip start="2" stop="9" mstart="3" />
In the next example, the media start time defaults to 0, forcing the media duration to be 10 seconds. The timeline duration is five seconds, so the clip plays back at twice the normal rate.
<clip start="5" stop="10" mstop="10" />
If the src attribute specifies a still image, DES attempts to load a series of still images to create an animation. For example, if the src attribute is IMAGE001.BMP, DES looks for IMAGE002.BMP, IMAGE003.BMP, IMAGE004.BMP, and so on. Assuming they exist, they are displayed in sequential numerical order, at the rate specified by the framerate attribute.
Examples
<clip src="sample.avi" start="1:05" stop="1:42.5" mstart="30" />
See also