de.jarnbjo.jmf

Class OggJmfStream

java.lang.Object

de.jarnbjo.jmf.OggJmfStream

All Implemented Interfaces:

PhysicalOggStream

public class OggJmfStream
extends java.lang.Object
implements PhysicalOggStream

Implementation of the PhysicalOggStream interface for accessing JMF (Java Media Framework) media streams.

Constructor Summary

Constructors

Constructor and Description
OggJmfStream(PullSourceStream source) Creates access to the specified PullSourceStream through the PhysicalOggStream interface.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes this stream.
LogicalOggStream	getLogicalStream(int serialNumber)
java.util.Collection	getLogicalStreams() Returns a collection of objects implementing LogicalOggStream for accessing the separate logical streams within this physical Ogg stream.
OggPage	getOggPage(int index) Return the Ogg page with the absolute index index, independent from the logical structure of this stream or if the index parameter is -1, the next Ogg page is returned.
boolean	isOpen() Checks if this stream is open for reading.
boolean	isSeekable()
void	setTime(long granulePosition) Sets this stream's (and its logical stream's) position to the granule position.

Methods inherited from class java.lang.Object

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

Constructor Detail

OggJmfStream

public OggJmfStream(PullSourceStream source)
             throws OggFormatException,
                    java.io.FileNotFoundException,
                    java.io.IOException

Creates access to the specified PullSourceStream through the PhysicalOggStream interface. The specified source must implement the Seekable interface.

Parameters:

source - the media stream to read from

Throws:

OggFormatException - if the stream format is incorrect

java.io.IOException - if some other IO error occurs when reading the stream

java.io.FileNotFoundException

Method Detail

getLogicalStreams

public java.util.Collection getLogicalStreams()

Description copied from interface: PhysicalOggStream

Returns a collection of objects implementing LogicalOggStream for accessing the separate logical streams within this physical Ogg stream.

Specified by:

getLogicalStreams in interface PhysicalOggStream

Returns:

a collection of objects implementing LogicalOggStream which are representing the logical streams contained within this physical stream

See Also:

LogicalOggStream

isOpen

public boolean isOpen()

Description copied from interface: PhysicalOggStream

Checks if this stream is open for reading.

Specified by:

isOpen in interface PhysicalOggStream

Returns:

true if this stream is open for reading, false otherwise

close

public void close()
           throws java.io.IOException

Description copied from interface: PhysicalOggStream

Closes this stream. After invoking this method, no further access to the streams data is possible.

Specified by:

close in interface PhysicalOggStream

Throws:

java.io.IOException

getOggPage

public OggPage getOggPage(int index)
                   throws java.io.IOException

Description copied from interface: PhysicalOggStream

Return the Ogg page with the absolute index index, independent from the logical structure of this stream or if the index parameter is -1, the next Ogg page is returned. This method should only be used by implementations of LogicalOggStream to access the raw pages.

Specified by:

getOggPage in interface PhysicalOggStream

Parameters:

index - the absolute index starting from 0 at the beginning of the file or stream or -1 to get the next page in a non-seekable stream

Returns:

the Ogg page with the physical absolute index index

Throws:

OggFormatException - if the ogg stream is corrupted

java.io.IOException - if some other IO error occurs

getLogicalStream

public LogicalOggStream getLogicalStream(int serialNumber)

setTime

public void setTime(long granulePosition)
             throws java.io.IOException

Description copied from interface: PhysicalOggStream

Sets this stream's (and its logical stream's) position to the granule position. The next packet read from any logical stream will be the first packet beginning on the first page with a granule position higher than the argument.

At the moment, this method only works correctly for Ogg files with a single logical Vorbis stream, and due to the different interpretations of the granule position, depending on mixed content, this method will never be able to work for mixed streams. Chained and interleaved streams are also not yet supported. Actually, this method is only a hack to support seeking from JMF, but may of course be abused otherwise too :)

Specified by:

setTime in interface PhysicalOggStream

Throws:

OggFormatException - if the ogg stream is corrupted

java.io.IOException - if some other IO error occurs

isSeekable

public boolean isSeekable()

Specified by:

isSeekable in interface PhysicalOggStream

Returns:

true if the stream is seekable, false otherwise