com.google.android.exoplayer.util.extensions

Class SimpleDecoder<I extends InputBuffer,O extends OutputBuffer,E extends Exception>

java.lang.Object

java.lang.Thread

com.google.android.exoplayer.util.extensions.SimpleDecoder<I,O,E>

All Implemented Interfaces:

Decoder<I,O,E>, Runnable

public abstract class SimpleDecoder<I extends InputBuffer,O extends OutputBuffer,E extends Exception>
extends Thread
implements Decoder<I,O,E>

Base class for Decoders that use their own decode thread.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SimpleDecoder.EventListener<E> Listener for SimpleDecoder events.

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SimpleDecoder(I[] inputBuffers, O[] outputBuffers)

Method Summary

Modifier and Type	Method and Description
protected abstract I	createInputBuffer() Creates a new input buffer.
protected abstract O	createOutputBuffer() Creates a new output buffer.
protected abstract E	decode(I inputBuffer, O outputBuffer, boolean reset) Decodes the inputBuffer and stores any decoded output in outputBuffer.
I	dequeueInputBuffer() Dequeues the next input buffer to be filled and queued to the decoder.
O	dequeueOutputBuffer() Dequeues the next output buffer from the decoder.
void	flush() Flushes input/output buffers that have not been dequeued yet and returns ownership of any dequeued input buffer to the decoder.
void	queueInputBuffer(I inputBuffer) Queues an input buffer to the decoder.
void	release() Releases the decoder.
protected void	releaseOutputBuffer(O outputBuffer) Releases an output buffer back to the decoder.
void	run()
protected void	setInitialInputBufferSize(int size) Sets the initial size of each input buffer.

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleDecoder

protected SimpleDecoder(I[] inputBuffers,
                        O[] outputBuffers)

Parameters:

inputBuffers - An array of nulls that will be used to store references to input buffers.

outputBuffers - An array of nulls that will be used to store references to output buffers.

Method Detail

setInitialInputBufferSize

protected final void setInitialInputBufferSize(int size)

Sets the initial size of each input buffer.

This method should only be called before the decoder is used (i.e. before the first call to dequeueInputBuffer().

Parameters:

size - The required input buffer size.

dequeueInputBuffer

public final I dequeueInputBuffer()
                           throws E extends Exception

Description copied from interface: Decoder

Dequeues the next input buffer to be filled and queued to the decoder.

Specified by:

dequeueInputBuffer in interface Decoder<I extends InputBuffer,O extends OutputBuffer,E extends Exception>

Returns:

The input buffer, or null if an input buffer isn't available.

Throws:

E - If a decoder error has occurred.

E extends Exception

queueInputBuffer

public final void queueInputBuffer(I inputBuffer)
                            throws E extends Exception

Description copied from interface: Decoder

Queues an input buffer to the decoder.

Specified by:

queueInputBuffer in interface Decoder<I extends InputBuffer,O extends OutputBuffer,E extends Exception>

Parameters:

inputBuffer - The input buffer.

Throws:

E - If a decoder error has occurred.

E extends Exception

dequeueOutputBuffer

public final O dequeueOutputBuffer()
                            throws E extends Exception

Description copied from interface: Decoder

Dequeues the next output buffer from the decoder.

Specified by:

dequeueOutputBuffer in interface Decoder<I extends InputBuffer,O extends OutputBuffer,E extends Exception>

Returns:

The output buffer, or null if an output buffer isn't available.

Throws:

E - If a decoder error has occurred.

E extends Exception

releaseOutputBuffer

protected void releaseOutputBuffer(O outputBuffer)

Releases an output buffer back to the decoder.

Parameters:

outputBuffer - The output buffer being released.

flush

public final void flush()

Description copied from interface: Decoder

Flushes input/output buffers that have not been dequeued yet and returns ownership of any dequeued input buffer to the decoder. Flushes any pending output currently in the decoder. The caller is still responsible for releasing any dequeued output buffers.

Specified by:

flush in interface Decoder<I extends InputBuffer,O extends OutputBuffer,E extends Exception>

release

public void release()

Description copied from interface: Decoder

Releases the decoder. Must be called when the decoder is no longer needed.

Specified by:

release in interface Decoder<I extends InputBuffer,O extends OutputBuffer,E extends Exception>

run

public final void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

createInputBuffer

protected abstract I createInputBuffer()

Creates a new input buffer.

createOutputBuffer

protected abstract O createOutputBuffer()

Creates a new output buffer.

decode

protected abstract E decode(I inputBuffer,
                            O outputBuffer,
                            boolean reset)

Decodes the inputBuffer and stores any decoded output in outputBuffer.

Parameters:

inputBuffer - The buffer to decode.

outputBuffer - The output buffer to store decoded data. The flag Buffer.FLAG_DECODE_ONLY will be set if the same flag is set on inputBuffer, but the decoder may set/unset the flag if required. If the flag is set after this method returns, any output should not be presented.

reset - True if the decoder must be reset before decoding.

Returns:

A decoder exception if an error occurred, or null if decoding was successful.