Class AbstractAVIStream.Track

java.lang.Object
org.monte.media.avi.AbstractAVIStream.Track
Direct Known Subclasses:
AbstractAVIStream.AudioTrack, AbstractAVIStream.MidiTrack, AbstractAVIStream.TextTrack, AbstractAVIStream.VideoTrack
Enclosing class:
AbstractAVIStream
protected abstract class AbstractAVIStream.Track extends Object
Represents a track (or "stream") in an AVI file.

A track is defined by an "strh" chunk, which contains an AVISTREAMHEADER struct. Additional chunks can be provided depending on the media type of the track.

See http://msdn.microsoft.com/en-us/library/ms779638(VS.85).aspx 

 -----------------
 AVI Stream Header
 -----------------

 enum {
    audioStream = "auds",
   midiStream = "mids",
   textStream = "txts",
   videoStream = "vids"
 } aviStrhType;

 set {
    disabled = 0x00000001, // Indicates this stream should not be enabled by default.
    videoPaletteChanges = 0x00010000
        // Indicates this video stream contains palette changes. This flag
        // warns the playback software that it will need to animate the palette.
 } aviStrhFlags;

 typedef struct {
    Int16 left;
    Int16 top;
    Int16 right;
    Int16 bottom;
 } aviRectangle;

 typedef struct {
     FOURCC enum aviStrhType type;
        // Contains a FOURCC that specifies the type of the data contained in
        // the stream. The following standard AVI values for video and audio are
        // defined.
     FOURCC handler;
        // Optionally, contains a FOURCC that identifies a specific data
        // handler.
        // The data handler is the preferred handler for the stream. For audio
        // and video streams, this specifies the codec for decoding the stream.
     DWORD  set aviStrhFlags flags;
        // Contains any flags for the data stream. The bits in the high-order
        // word of these flags are specific to the type of data contained in the
        // stream.
     WORD   priority;
        // Specifies priority of a stream type. For example, in a file with
        // multiple audio streams, the one with the highest priority might be
        // the default stream.
     WORD   language;
     DWORD  initialFrames;
        // Specifies how far audio data is skewed ahead of the video frames in
        // interleaved files. Typically, this is about 0.75 seconds. If you are
        // creating interleaved files, specify the number of frames in the file
        // prior to the initial frame of the AVI sequence in this member. For
        // more information about the contents of this member, see "Special
        // Information for Interleaved Files" in the Video for Windows
        // Programmer's Guide.
     DWORD  scale;
        // Used with "rate" to specify the time scale that this stream will use.
        // Dividing "rate" by "scale" gives the number of samples per second.
        // For video streams, this is the frame rate. For audio streams, this
        // rate corresponds to the time needed to play blockAlign bytes of
        // audio, which for PCM audio is the just the sample rate.
     DWORD  rate;
        // See "scale".
     DWORD  startTime;
        // Specifies the starting time for this stream. The units are defined by
        // the "rate" and "scale" members in the main file header. Usually, this
        // is zero, but it can specify a delay time for a stream that does not
        // startTime concurrently with the file.
     DWORD  length;
        // Specifies the length of this stream. The units are defined by the
        // "rate" and "scale" members of the stream's header.
     DWORD  suggestedBufferSize;
        // Specifies how large a buffer should be used to read this stream.
        // Typically, this contains a value corresponding to the largest chunk
        // present in the stream. Using the correct buffer size makes playback
        // more efficient. Use zero if you do not know the correct buffer size.
     DWORD  quality;
        // Specifies an indicator of the quality of the data in the stream.
        // Quality is represented as a number between 0 and 10,000. For
        // compressed data, this typically represents the value of the quality
        // parameter passed to the compression software. If set to �1, drivers
        // use the default quality value.
     DWORD  sampleSize;
        // Specifies the size of a single sample of data. This is set to zero if
        // the samples can vary in size. If this number is nonzero, then
        // multiple samples of data can be grouped into a single chunk within
        // the file. If it is zero, each sample of data (such as a video frame)
        // must be in a separate chunk. For video streams, this number is
        // typically zero, although it can be nonzero if all video frames are
        // the same size. For audio streams, this number should be the same as
        // the blockAlign member of the WAVEFORMATEX structure describing the audio.
    aviRectangle frame;
        // Specifies the destination rectangle for a text or video stream within
        // the movie rectangle specified by the "frameWidth" and "frameHeight"
        // members of the AVI main header structure. The "frame" member is
        // typically used in support of multiple video streams. Set this
        // rectangle to the coordinates corresponding to the movie rectangle to
        // update the whole movie rectangle. Units for this member are pixels.
        // The upper-left corner of the destination rectangle is relative to the
        // upper-left corner of the movie rectangle.
 } AVISTREAMHEADER; *
Author:
Werner Randelshofer

  • Field Details

    • format

      public Format format
      The media format.

      FIXME - AbstractAVIStream should have no dependencies to Format.

    • samples

      public ArrayList<AbstractAVIStream.Sample> samples
      List of samples.

    • syncInterval

      public int syncInterval
      Interval between sync samples (keyframes). 0 = automatic. 1 = write all samples as sync samples. n = sync every n-th sample.

    • twoCC

      protected int twoCC
      The twoCC code is used for the ids of the chunks which hold the data samples.

    • mediaType

      public final AbstractAVIStream.AVIMediaType mediaType
      mediaType.fccType contains a FOURCC that specifies the type of the data contained in the stream. The following standard AVI values for video and audio are defined.

      FOURCC Description 'auds' Audio stream 'mids' MIDI stream 'txts' Text stream 'vids' Video stream

    • fccHandler

      protected int fccHandler
      Optionally, contains a FOURCC that identifies a specific data handler. The data handler is the preferred handler for the stream. For audio and video streams, this specifies the codec for decoding the stream.

    • flags

      protected int flags
      Contains any flags for the data stream. The bits in the high-order word of these flags are specific to the type of data contained in the stream. The following standard flags are defined.

      Value Description

      AVISF_DISABLED 0x00000001 Indicates this stream should not be enabled by default.

      AVISF_VIDEO_PALCHANGES 0x00010000 Indicates this video stream contains palette changes. This flag warns the playback software that it will need to animate the palette.

    • priority

      protected int priority
      Specifies priority of a stream type. For example, in a file with multiple audio streams, the one with the highest priority might be the default stream.

    • language

      protected int language
      Language tag.

    • initialFrames

      protected long initialFrames
      Specifies how far audio data is skewed ahead of the video frames in interleaved files. Typically, this is about 0.75 seconds. If you are creating interleaved files, specify the number of frames in the file prior to the initial frame of the AVI sequence in this member. For more information, see the remarks for the initialFrames member of the AVIMAINHEADER structure.

    • scale

      public long scale
      Used with rate to specify the time scale that this stream will use. Dividing rate by scale gives the number of samples per second. For video streams, this is the frame rate. For audio streams, this rate corresponds to the time needed to play blockAlign bytes of audio, which for PCM audio is the just the sample rate.

    • rate

      public long rate
      The rate of the media in scale units.

    • startTime

      public long startTime
      Specifies the starting time for this stream. The units are defined by the rate and scale members in the main file header. Usually, this is zero, but it can specify a delay time for a stream that does not startTime concurrently with the file.

    • length

      public long length
      Specifies the length of this stream. The units are defined by the rate and scale members of the stream's header.

    • quality

      protected int quality
      Specifies an indicator of the quality of the data in the stream. Quality is represented as a number between 0 and 10,000. For compressed data, this typically represents the value of the quality parameter passed to the compression software. If set to –1, drivers use the default quality value.

    • strhChunk

      protected AbstractAVIStream.FixedSizeDataChunk strhChunk
      This chunk holds the AVI Stream Header.

    • strfChunk

      protected AbstractAVIStream.FixedSizeDataChunk strfChunk
      This chunk holds the AVI Stream Format Header.

    • name

      protected String name
      The optional name of the track.

    • codec

      public Codec codec
      The codec.

    • outputBuffer

      public Buffer outputBuffer
      The output buffer is used to store the output of the codec.

    • inputBuffer

      public Buffer inputBuffer
      The input buffer is used when one of the convenience methods without a Buffer parameter is used.

    • readIndex

      public long readIndex
      The current chunk index of the reader.

    • extraHeaders

      protected ArrayList<RIFFChunk> extraHeaders
      List of additional header chunks.

  • Constructor Details

  • Method Details

    • getSTRFChunkSize

      public abstract long getSTRFChunkSize()

    • getSampleChunkFourCC

      public abstract int getSampleChunkFourCC(boolean isSync)

    • addSample

      public void addSample(AbstractAVIStream.Sample s)