org.monte.media.quicktime

Class QuickTimeReader

java.lang.Object

org.monte.media.quicktime.AbstractQuickTimeStream

org.monte.media.quicktime.QuickTimeInputStream

org.monte.media.quicktime.QuickTimeReader

All Implemented Interfaces:

MovieReader

public class QuickTimeReader
extends QuickTimeInputStream
implements MovieReader

QuickTimeReader.

Version:

$Id: QuickTimeReader.java 305 2013-01-04 16:07:34Z werner $

Author:

Werner Randelshofer

Nested Class Summary

Nested classes/interfaces inherited from class org.monte.media.quicktime.AbstractQuickTimeStream

AbstractQuickTimeStream.Atom, AbstractQuickTimeStream.AudioTrack, AbstractQuickTimeStream.Chunk, AbstractQuickTimeStream.CompositeAtom, AbstractQuickTimeStream.DataAtom, AbstractQuickTimeStream.Edit, AbstractQuickTimeStream.Group, AbstractQuickTimeStream.Sample, AbstractQuickTimeStream.SampleSizeGroup, AbstractQuickTimeStream.States, AbstractQuickTimeStream.TimeToSampleGroup, AbstractQuickTimeStream.Track, AbstractQuickTimeStream.VideoTrack, AbstractQuickTimeStream.WideDataAtom

Field Summary

Fields

Modifier and Type	Field and Description
static Format	QUICKTIME

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

in

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

creationTime, currentTime, mdatAtom, mdatOffset, modificationTime, moovAtom, movieMatrix, movieTimeScale, out, posterTime, preferredRate, preferredVolume, previewDuration, previewTime, selectionDuration, selectionTime, state, streamOffset, tracks

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
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.
void	read(int track, Buffer buffer) Reads the next sample chunk from the specified track.
BufferedImage	read(int track, BufferedImage img) Reads an image.
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, ensureRealized, getCreationTime, getCurrentTime, getMediaDuration, getMediaTimeScale, getModificationTime, getMovieDuration, getMovieTimeScale, getMovieTransformationMatrix, getPosterTime, getPreferredRate, getPreferredVolume, getPreviewDuration, getPreviewTime, getTrackCount, getTransformationMatrix

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

getRelativeStreamPosition, intToType, seekRelative, typeToInt

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.MovieReader

close, getTrackCount

Field Detail

QUICKTIME

public static final Format QUICKTIME

Constructor Detail

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 Detail

timeToSample

public long timeToSample(int track,
                Rational seconds)

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 sample)

Description copied from interface: MovieReader

Returns the time for the specified sample number.

Specified by:

sampleToTime in interface MovieReader

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 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)

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.

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