clipEnd
Previous | Next |
clipEnd
The clipEnd attribute specifies the time at which a stream stops playing, relative to the start of the media file.
Syntax
clipEnd ::= (Metric "=" )? (Clock-val) Metric ::= "npt" Clock-value ::= (Full-clock-value | Partial-clock-value | Timecount-value) Full-clock-value ::= Hours ":" Minutes ":" Seconds ("." Fraction)? Partial-clock-value ::= Minutes ":" Seconds ("." Fraction)? Timecount-value ::= Timecount ("." Fraction)? (Metric)? Metric ::= "h" | "min" | "s" |"ms" Hours ::= DIGIT Minutes ::= 2DIGIT; any range from 00 to 59 Seconds ::= 2DIGIT: range from 00 to 59 Fraction ::= DIGIT+ Timecount ::= DIGIT+ 2DIGIT ::= DIGIT DIGIT DIGIT ::= (0-9)
Remarks
The value of this attribute must be specified as a clock value. For more information, see Attribute Time Formats.
The WMS SMIL Playlist Parser plug-in enforces case sensitivity on the clipEnd attribute.
The difference between this attribute and the end attribute is that the offset you specify for clipEnd is relative to the start of the file, whereas the offset you specify for end is relative to the start of the time container.
If you specify a value greater than the duration of the stream, the entire stream is played.
- Note You can use a normal play time "npt" specifier in front of the clock value, but it will not affect the attribute. The following are not supported: the "marker" specifier, SMPTE frame values, and negative offsets. Negative offsets are ignored and the entire stream is played.
Example Code
The following example illustrates the clipEnd attribute. The Windows Media files are played in the following sequence. Assume that the duration of each file is at least as long as its clipEnd value.
- The first element starts playing when the time container starts and runs for 30 seconds.
- The second element starts when the first element ends and runs for 30 seconds.
- The third element starts when the second element ends and runs for 2 minutes.
- The fourth element starts when the third element ends and runs for 4 minutes.
- Clip_5.wmv is not played.
<?wsx version="1.0"?> <smil> <seq> <ref src="c:\wmpub\wmroot\Clip_1.wmv" clipEnd="0:30" /> <ref src="c:\wmpub\wmroot\Clip_2.wmv" clipEnd=":30" /> <ref src="c:\wmpub\wmroot\Clip_3.wmv" clipEnd="2min" /> <ref src="c:\wmpub\wmroot\Clip_4.wmv" clipEnd="4:00" /> <ref src="c:\wmpub\wmroot\Clip_5.wmv" clipEnd="0h" /> </seq> </smil>
See Also
Previous | Next |