Share via

clipEnd

  • Article

banner art

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.

  1. The first element starts playing when the time container starts and runs for 30 seconds.
  2. The second element starts when the first element ends and runs for 30 seconds.
  3. The third element starts when the second element ends and runs for 2 minutes.
  4. The fourth element starts when the third element ends and runs for 4 minutes.
  5. 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