Module org.monte.media

Package org.monte.media.quicktime

Class QuickTimeReader

java.lang.Object

org.monte.media.quicktime.QuickTimeInputStream

org.monte.media.quicktime.QuickTimeReader

All Implemented Interfaces:

AutoCloseable, MovieReader

public class QuickTimeReader
extends QuickTimeInputStream
implements MovieReader

QuickTimeReader.

Author:

Werner Randelshofer

Field Summary

Fields

Modifier and Type	Field	Description
static final Format	QUICKTIME

Fields inherited from class org.monte.media.quicktime.QuickTimeInputStream

currentTime, in, meta, streamOffset

Constructor Summary

Constructors

Constructor	Description
QuickTimeReader(File file)	Creates a new instance.
QuickTimeReader(ImageInputStream in)	Creates a new instance.

Method Summary

Modifier and Type	Method	Description
protected void	ensureRealized()	Ensures that all meta-data has been read from the file.
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.
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 the next sample chunk from the specified track.
Rational	sampleToTime(int track, long sample)	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 seconds)	Returns the sample number for the specified time.

Methods inherited from class org.monte.media.quicktime.QuickTimeInputStream

close, getCreationTime, getCurrentTime, getMediaDuration, getMediaTimeScale, getModificationTime, getMovieDuration, getMovieTimeScale, getMovieTransformationMatrix, getPosterTime, getPreferredRate, getPreferredVolume, getPreviewDuration, getPreviewTime, getTrackCount, getTransformationMatrix

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.monte.media.av.MovieReader

close, getTrackCount

Field Details

QUICKTIME

public static final Format QUICKTIME

Constructor Details

QuickTimeReader

public QuickTimeReader(File file)
                throws IOException

Creates a new instance.

Parameters:

file - the input file

Throws:

IOException

QuickTimeReader

public QuickTimeReader(ImageInputStream in)
                throws IOException

Creates a new instance.

Parameters:

in - the input stream.

Throws:

IOException

Method Details

timeToSample

public long timeToSample(int track,
 Rational seconds)
                  throws IOException

Description copied from interface: MovieReader

Returns the sample number for the specified time.

Specified by:

timeToSample in interface MovieReader

Throws:

IOException

sampleToTime

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

Description copied from interface: MovieReader

Returns the time for the specified sample number.

Specified by:

sampleToTime in interface MovieReader

Throws:

IOException

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

ensureRealized

protected void ensureRealized()
                       throws IOException

Description copied from class: QuickTimeInputStream

Ensures that all meta-data has been read from the file.

Overrides:

ensureRealized in class QuickTimeInputStream

Throws:

IOException

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

read

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

Description copied from interface: MovieReader

Reads the next sample chunk from the specified track.

Specified by:

read in interface MovieReader

Parameters:

track - Track number.

buffer - The buffer into which to store the sample data.

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

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

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

getDuration

public Rational getDuration()
                     throws IOException

Description copied from interface: MovieReader

Returns the total duration of the movie .

Specified by:

getDuration in interface MovieReader

Throws:

IOException

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

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