AVIInputStream (MonteCC repack 1.0.1 API)

java.lang.Object
- org.monte.media.avi.AbstractAVIStream
- - org.monte.media.avi.AVIInputStream

Direct Known Subclasses:

AVIReader
```
public class AVIInputStream
extends AbstractAVIStream
```
Provides low-level support for reading encoded audio and video samples from an AVI 1.0 or an AVI 2.0 file.
The length of an AVI 1.0 file is limited to 1 GB. This class supports lengths of up to 4 GB, but such files may not work on all players.
Support for AVI 2.0 file is incomplete. This class currently ignores the extended index chunks. Instead all chunks in the "movi" list are scanned. With scanning, the reader is not able to distinguish between keyframes and non-keyframes. As a consequence opening an AVI 2.0 file is very slow, and decoding of frames may fail.
For detailed information about the AVI 1.0 file format see:
msdn.microsoft.com AVI RIFF
www.microsoft.com FOURCC for Video Compression
www.saettler.com RIFF

For detailed information about the AVI 2.0 file format see:
OpenDML AVI File Format Extensions, Version 1.02

Version:

$Id: AVIInputStream.java 299 2013-01-03 07:40:18Z werner $

Author:

Werner Randelshofer

Nested Class Summary
- Nested classes/interfaces inherited from class org.monte.media.avi.AbstractAVIStream
  AbstractAVIStream.AudioTrack, AbstractAVIStream.AVIMediaType, AbstractAVIStream.Chunk, AbstractAVIStream.CompositeChunk, AbstractAVIStream.DataChunk, AbstractAVIStream.FixedSizeDataChunk, AbstractAVIStream.MainHeader, AbstractAVIStream.MidiTrack, AbstractAVIStream.Sample, AbstractAVIStream.TextTrack, AbstractAVIStream.Track, AbstractAVIStream.VideoTrack

Field Summary

Fields
Modifier and Type	Field and Description
`protected ArrayList<AbstractAVIStream.Sample>`	`idx1`
`protected ImageInputStream`	`in` The image input stream.
`protected AbstractAVIStream.MainHeader`	`mainHeader`

Fields inherited from class org.monte.media.avi.AbstractAVIStream
AVI_ID, AVIH_FLAG_COPYRIGHTED, AVIH_FLAG_HAS_INDEX, AVIH_FLAG_IS_INTERLEAVED, AVIH_FLAG_MUST_USE_INDEX, AVIH_FLAG_TRUST_CK_TYPE, AVIH_FLAG_WAS_CAPTURE_FILE, AVIH_ID, AVIX_ID, CHUNK_SUBTYPE_MASK, DB_ID, DC_ID, HDRL_ID, IDX1_ID, LIST_ID, MOVI_ID, out, PC_ID, REC_ID, RIFF_ID, STRD_ID, streamOffset, STRF_ID, STRH_FLAG_DISABLED, STRH_FLAG_VIDEO_PALETTE_CHANGES, STRH_ID, STRL_ID, STRN_ID, tracks, WB_ID

Constructor Summary

Constructors
Constructor and Description

AVIInputStream(File file)
Creates a new instance.

AVIInputStream(ImageInputStream in)
Creates a new instance.

Constructors
Constructor and Description
`AVIInputStream(File file)` Creates a new instance.
`AVIInputStream(ImageInputStream in)` Creates a new instance.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`close()`
`protected void`	`ensureRealized()` Ensures that all meta-data has been read from the file.
`long`	`getChunkCount(int track)` Returns the number of media data chunks in the track.
`byte[]`	`getExtraHeader(int track, String fourcc)` Returns the contents of the extra track header.
`String[]`	`getExtraHeaderFourCCs(int track)` Returns the fourcc's of all extra stream headers.
`int`	`getHeaderFlags()` Returns the main header flags.
`long`	`getMicroSecPerFrame()` Returns the number of microseconds (10^-6 seconds) per frame.
`String`	`getName(int track)` Returns the name of the track, or null if the name is not specified.
`long`	`getStartTime(int track)` Returns the start time of the track given as the number of frames in microSecPerFrame units.
`long`	`getTimeScale(int track)` Returns the time scale of the specified track.
`int`	`getTrackCount()`
`Dimension`	`getVideoDimension()`
`protected void`	`readAllMetadata()` Reads all metadata of the file.

Methods inherited from class org.monte.media.avi.AbstractAVIStream
getRelativeStreamPosition, intToType, isFlagSet, seekRelative, typeToInt

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - in
```
protected final ImageInputStream in
```
    The image input stream.
  - mainHeader
```
protected AbstractAVIStream.MainHeader mainHeader
```
  - idx1
```
protected ArrayList<AbstractAVIStream.Sample> idx1
```
- Constructor Detail
  - AVIInputStream
```
public AVIInputStream(File file)
               throws IOException
```
    Creates a new instance.
    
    Parameters:
    file - the input file
    
    Throws:
    
    IOException
  - AVIInputStream
```
public AVIInputStream(ImageInputStream in)
               throws IOException
```
    Creates a new instance.
    
    Parameters:
    in - the input stream.
    
    Throws:
    
    IOException
- Method Detail
  - ensureRealized
```
protected void ensureRealized()
                       throws IOException
```
    Ensures that all meta-data has been read from the file.
    
    Throws:
    
    IOException
  - getHeaderFlags
```
public int getHeaderFlags()
                   throws IOException
```
    Returns the main header flags. The flags are an or-combination of the AVIH_... values.
    
    Throws:
    
    IOException
  - getVideoDimension
```
public Dimension getVideoDimension()
                            throws IOException
```
    Throws:
    
    IOException
  - getTrackCount
```
public int getTrackCount()
                  throws IOException
```
    Throws:
    
    IOException
  - getMicroSecPerFrame
```
public long getMicroSecPerFrame()
                         throws IOException
```
    Returns the number of microseconds (10^-6 seconds) per frame. This is used as a time basis for the start time of tracks within a movie.
    
    Throws:
    
    IOException
  - getTimeScale
```
public long getTimeScale(int track)
                  throws IOException
```
    Returns the time scale of the specified track.
    
    Throws:
    
    IOException
  - getStartTime
```
public long getStartTime(int track)
                  throws IOException
```
    Returns the start time of the track given as the number of frames in microSecPerFrame units.
    
    Throws:
    
    IOException
  - getChunkCount
```
public long getChunkCount(int track)
                   throws IOException
```
    Returns the number of media data chunks in the track. This includes chunks which do not affect the timing of the media, such as palette changes.
    
    Parameters:
    track -
    
    Returns:
    the number of chunks
    
    Throws:
    
    IOException
  - getName
```
public String getName(int track)
               throws IOException
```
    Returns the name of the track, or null if the name is not specified.
    
    Throws:
    
    IOException
  - getExtraHeader
```
public byte[] getExtraHeader(int track,
                    String fourcc)
                      throws IOException
```
    Returns the contents of the extra track header. Returns null if the header is not present.
    
    Parameters:
    track -
    fourcc -
    
    Returns:
    The extra header as a byte array
    
    Throws:
    
    IOException
  - getExtraHeaderFourCCs
```
public String[] getExtraHeaderFourCCs(int track)
                               throws IOException
```
    Returns the fourcc's of all extra stream headers.
    
    Parameters:
    track -
    
    Returns:
    An array of fourcc's of all extra stream headers.
    
    Throws:
    
    IOException
  - readAllMetadata
```
protected void readAllMetadata()
                        throws IOException
```
    Reads all metadata of the file.
    
    Throws:
    
    IOException
  - close
```
public void close()
           throws IOException
```
    Throws:
    
    IOException

Class AVIInputStream

Nested Class Summary

Nested classes/interfaces inherited from class org.monte.media.avi.AbstractAVIStream

Field Summary

Fields inherited from class org.monte.media.avi.AbstractAVIStream

Constructor Summary

Method Summary

Methods inherited from class org.monte.media.avi.AbstractAVIStream

Methods inherited from class java.lang.Object

Field Detail

in

mainHeader

idx1

Constructor Detail

AVIInputStream

AVIInputStream

Method Detail

ensureRealized

getHeaderFlags

getVideoDimension

getTrackCount

getMicroSecPerFrame

getTimeScale

getStartTime

getChunkCount

getName

getExtraHeader

getExtraHeaderFourCCs

readAllMetadata

close