Class ISO14496_Box_STSH

Description

The Shadow Sync Sample Box table provides an optional set of sync samples that can be used when seeking or for similar purposes. In normal forward play they are ignored.

Each entry in the Shadow Sync Table consists of a pair of sample numbers. The first entry (shadowedSampleNumber) indicates the number of the sample that a shadow sync will be defined for. This should always be a non-sync sample (e.g. a frame difference). The second sample number (syncSampleNumber) indicates the sample number of the sync sample (i.e. key frame) that can be used when there is a random access at, or before, the shadowedSampleNumber.

The shadow sync samples are normally placed in an area of the track that is not presented during normal play (edited out by means of an edit list), though this is not a requirement. The shadow sync table can be ignored and the track will play (and seek) correctly if it is ignored (though perhaps not optimally).

The Shadow Sync Sample replaces, not augments, the sample that it shadows (i.e. the next sample sent is shadowedSampleNumber+1). The shadow sync sample is treated as if it occurred at the time of the sample it shadows, having the duration of the sample it shadows.

Hinting and transmission might become more complex if a shadow sample is used also as part of normal playback, or is used more than once as a shadow. In this case the hint track might need separate shadow syncs, all of which can get their media data from the one shadow sync in the media track, to allow for the different time-stamps etc. needed in their headers.

Located in /ISO14496/Box/STSH.php (line 78)

ISO14496_Box
   |
   --ISO14496_Box_Full
      |
      --ISO14496_Box_STSH
Method Summary
ISO14496_Box_STSH __construct (Reader $reader, [ &$options = array()])
Variables
Methods
Constructor __construct (line 89)

Constructs the class with given parameters and reads box related data from the ISO Base Media file.

  • access: public
ISO14496_Box_STSH __construct (Reader $reader, [ &$options = array()])
  • Reader $reader: The reader object.
  • &$options

Redefinition of:
ISO14496_Box_Full::__construct()
Constructs the class with given parameters and reads box related data from the ISO Base Media file.
getShadowSyncSampleTable (line 113)

Returns an array of values. Each entry is an array containing the following keys.

  • shadowedSampleNumber - gives the number of a sample for which there is an alternative sync sample.
  • syncSampleNumber - gives the number of the alternative sync sample.

  • access: public
Array getShadowSyncSampleTable ()

Inherited Methods

Inherited From ISO14496_Box_Full

ISO14496_Box_Full::__construct()
ISO14496_Box_Full::getFlags()
ISO14496_Box_Full::getVersion()
ISO14496_Box_Full::hasFlag()
ISO14496_Box_Full::setFlags()
ISO14496_Box_Full::setVersion()
ISO14496_Box_Full::__toString()

Inherited From ISO14496_Box

ISO14496_Box::__construct()
ISO14496_Box::addBox()
ISO14496_Box::constructBoxes()
ISO14496_Box::getBoxes()
ISO14496_Box::getBoxesByIdentifier()
ISO14496_Box::getContainer()
ISO14496_Box::getOffset()
ISO14496_Box::getOption()
ISO14496_Box::getOptions()
ISO14496_Box::getParent()
ISO14496_Box::getSize()
ISO14496_Box::getType()
ISO14496_Box::hasBox()
ISO14496_Box::isContainer()
ISO14496_Box::setContainer()
ISO14496_Box::setOffset()
ISO14496_Box::setOption()
ISO14496_Box::setOptions()
ISO14496_Box::setParent()
ISO14496_Box::setSize()
ISO14496_Box::setType()
ISO14496_Box::__get()
ISO14496_Box::__isset()
ISO14496_Box::__set()
ISO14496_Box::__toString()
ISO14496_Box::__unset()

Documentation generated on Fri, 05 Sep 2008 20:19:29 +0300 by phpDocumentor 1.4.1