Class AVIReader

java.lang.Object

org.monte.media.avi.AVIReader

All Implemented Interfaces:

AutoCloseable, MovieReader

public class AVIReader
extends Object
implements MovieReader

Provides high-level support for decoding and reading audio and video samples from an AVI 1.0 file.

Author:

Werner Randelshofer

Field Summary

Fields

Modifier and Type	Field	Description
static final Format	AVI

Constructor Summary

Constructors

Constructor	Description
AVIReader(File file)
AVIReader(ImageInputStream in)

Method Summary

Modifier and Type	Method	Description
void	close()
int	findTrack(int fromTrack, Format format)	Finds a track with the specified format.
long	getChunkCount(int track)	Returns the number of media data chunks in the specified track.
Rational	getDuration()	Returns the total duration of the movie .
Rational	getDuration(int track)	Returns the duration of the specified track.
Format	getFileFormat()	Returns the file format.
Format	getFormat(int track)	Returns the media format of the specified track.
Rational	getReadTime(int track)	Returns the current time of the track.
long	getTimeScale(int track)
int	getTrackCount()	Returns the number of tracks.
int	nextTrack()	Returns the index of the next track in playback sequence.
BufferedImage	read(int track, BufferedImage img)	Reads an image.
void	read(int track, Buffer buffer)	Reads a chunk of media data from the specified track.
Rational	sampleToTime(int track, long sampleIndex)	Returns the time for the specified sample number.
void	setMovieReadTime(Rational newValue)	Sets the read time of all tracks to the closest sync sample before or at the specified time.
long	timeToSample(int track, Rational time)	Returns the sample number for the specified time.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

AVI

public static final Format AVI

Constructor Details

AVIReader

public AVIReader(ImageInputStream in)
          throws IOException

Throws:

IOException

AVIReader

public AVIReader(File file)
          throws IOException

Throws:

IOException

Method Details

getFileFormat

public Format getFileFormat()
                     throws IOException

Description copied from interface: MovieReader

Returns the file format.

Specified by:

getFileFormat in interface MovieReader

Throws:

IOException

getFormat

public Format getFormat(int track)
                 throws IOException

Description copied from interface: MovieReader

Returns the media format of the specified track.

Specified by:

getFormat in interface MovieReader

Parameters:

track - Track number.

Returns:

The media format of the track.

Throws:

IOException

getChunkCount

public long getChunkCount(int track)
                   throws IOException

Description copied from interface: MovieReader

Returns the number of media data chunks in the specified track. A chunk contains one or more samples.

Specified by:

getChunkCount in interface MovieReader

Throws:

IOException

read

public void read(int track,
 Buffer buffer)
          throws IOException

Reads a chunk of media data from the specified track.

If the track is a video track with palette change "..PC" chunks, then the body of the palette change chunk can be found in the buffer.header.

Specified by:

read in interface MovieReader

Parameters:

track - The track number.

buffer - The buffer for the media data.

Throws:

IOException - on IO failure

read

public BufferedImage read(int track,
 BufferedImage img)
                   throws IOException

Reads an image.

Parameters:

track - The track number

img - An image that can be reused if it fits the media format of the track. Pass null to create a new image on each read.

Returns:

An image or null if the end of the media has been reached.

Throws:

IOException

getReadTime

public Rational getReadTime(int track)
                     throws IOException

Description copied from interface: MovieReader

Returns the current time of the track.

Specified by:

getReadTime in interface MovieReader

Throws:

IOException

nextTrack

public int nextTrack()
              throws IOException

Description copied from interface: MovieReader

Returns the index of the next track in playback sequence.

Specified by:

nextTrack in interface MovieReader

Returns:

Index of next track or -1 if end of media reached.

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface MovieReader

Throws:

IOException

getDuration

public Rational getDuration()

Description copied from interface: MovieReader

Returns the total duration of the movie .

Specified by:

getDuration in interface MovieReader

getDuration

public Rational getDuration(int track)
                     throws IOException

Description copied from interface: MovieReader

Returns the duration of the specified track.

Specified by:

getDuration in interface MovieReader

Throws:

IOException

getTimeScale

public long getTimeScale(int track)
                  throws IOException

Throws:

IOException

timeToSample

public long timeToSample(int track,
 Rational time)

Description copied from interface: MovieReader

Returns the sample number for the specified time.

Specified by:

timeToSample in interface MovieReader

sampleToTime

public Rational sampleToTime(int track,
 long sampleIndex)
                      throws IOException

Description copied from interface: MovieReader

Returns the time for the specified sample number.

Specified by:

sampleToTime in interface MovieReader

Throws:

IOException

setMovieReadTime

public void setMovieReadTime(Rational newValue)
                      throws IOException

Description copied from interface: MovieReader

Sets the read time of all tracks to the closest sync sample before or at the specified time.

Specified by:

setMovieReadTime in interface MovieReader

Parameters:

newValue - Time in seconds.

Throws:

IOException

getTrackCount

public int getTrackCount()
                  throws IOException

Description copied from interface: MovieReader

Returns the number of tracks.

Specified by:

getTrackCount in interface MovieReader

Throws:

IOException

findTrack

public int findTrack(int fromTrack,
 Format format)
              throws IOException

Description copied from interface: MovieReader

Finds a track with the specified format.

Specified by:

findTrack in interface MovieReader

Parameters:

fromTrack - the start track number.

format - A format specification.

Returns:

The track number >= fromTrack or -1 if no track has been found.

Throws:

IOException