org.jitsi.impl.neomedia.codec.audio

Class FFmpegAudioDecoder

java.lang.Object

net.sf.fmj.media.AbstractControls

net.sf.fmj.media.AbstractPlugIn

net.sf.fmj.media.AbstractCodec

org.jitsi.impl.neomedia.codec.AbstractCodec2

org.jitsi.impl.neomedia.codec.audio.AbstractFFmpegAudioCodec

org.jitsi.impl.neomedia.codec.audio.FFmpegAudioDecoder

All Implemented Interfaces:

javax.media.Codec, javax.media.Controls, javax.media.PlugIn

Direct Known Subclasses:

JNIDecoder

public class FFmpegAudioDecoder
extends AbstractFFmpegAudioCodec

Implements an audio Codec using the FFmpeg library.

Author:

Lyubomir Marinov

Field Summary

Fields inherited from class org.jitsi.impl.neomedia.codec.audio.AbstractFFmpegAudioCodec

avctx, codecID, frameSizeInBytes

Fields inherited from class org.jitsi.impl.neomedia.codec.AbstractCodec2

BUFFER_FLAG_FEC, BUFFER_FLAG_PLC, EMPTY_FORMATS, features, MAX_AUDIO_SEQUENCE_NUMBERS_TO_PLC, SEQUENCE_MAX, SEQUENCE_MIN

Fields inherited from class net.sf.fmj.media.AbstractCodec

inputFormat, inputFormats, opened, outputFormat

Fields inherited from interface javax.media.PlugIn

BUFFER_PROCESSED_FAILED, BUFFER_PROCESSED_OK, INPUT_BUFFER_NOT_CONSUMED, OUTPUT_BUFFER_NOT_FILLED, PLUGIN_TERMINATED

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	FFmpegAudioDecoder(String name, int codecID, javax.media.Format[] supportedOutputFormats) Initializes a new FFmpegAudioDecoder instance with a specific PlugIn name, a specific AVCodecID, and a specific list of Formats supported as output.

Method Summary

Modifier and Type	Method and Description
static void	assertFindAVCodec(int codecID) Asserts that an decoder with a specific AVCodecID is found by FFmpeg.
protected void	doClose()
protected void	doOpen() Opens this Codec and acquires the resources that it needs to operate.
protected int	doProcess(javax.media.Buffer inBuf, javax.media.Buffer outBuf)
protected long	findAVCodec(int codecID) Finds an AVCodec with a specific AVCodecID.
protected javax.media.format.AudioFormat	getAVCodecContextFormat() Gets the AudioFormat with which AbstractFFmpegAudioCodec.avctx is to be configured and opened by AbstractFFmpegAudioCodec.doOpen().

Methods inherited from class org.jitsi.impl.neomedia.codec.audio.AbstractFFmpegAudioCodec

codecIDToString, configureAVCodecContext

Methods inherited from class org.jitsi.impl.neomedia.codec.AbstractCodec2

calculateLostSeqNoCount, close, discardOutputBuffer, getMatchingOutputFormats, getName, getSupportedOutputFormats, incrementSeqNo, matches, open, process, setInputFormat, setOutputFormat, specialize, updateOutput, validateByteArraySize, validateShortArraySize

Methods inherited from class net.sf.fmj.media.AbstractCodec

checkInputBuffer, dump, getInputFormat, getOutputFormat, getSupportedInputFormats, isEOM, propagateEOM

Methods inherited from class net.sf.fmj.media.AbstractPlugIn

reset

Methods inherited from class net.sf.fmj.media.AbstractControls

addControl, getControl, getControls, removeControl

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.media.PlugIn

reset

Methods inherited from interface javax.media.Controls

getControl, getControls

Constructor Detail

FFmpegAudioDecoder

protected FFmpegAudioDecoder(String name,
                             int codecID,
                             javax.media.Format[] supportedOutputFormats)

Initializes a new FFmpegAudioDecoder instance with a specific PlugIn name, a specific AVCodecID, and a specific list of Formats supported as output.

Parameters:

name - the PlugIn name of the new instance

codecID - the AVCodecID of the FFmpeg codec to be represented by the new instance

supportedOutputFormats - the list of Formats supported by the new instance as output

Method Detail

assertFindAVCodec

public static void assertFindAVCodec(int codecID)

Asserts that an decoder with a specific AVCodecID is found by FFmpeg.

Parameters:

codecID - the AVCodecID of the decoder to find

Throws:

RuntimeException - if no decoder with the specified codecID is found by FFmpeg

doClose

protected void doClose()

Overrides:

doClose in class AbstractFFmpegAudioCodec

doOpen

protected void doOpen()
               throws javax.media.ResourceUnavailableException

Opens this Codec and acquires the resources that it needs to operate. A call to PlugIn.open() on this instance will result in a call to doOpen only if AbstractCodec.opened is false. All required input and/or output formats are assumed to have been set on this Codec before doOpen is called.

Overrides:

doOpen in class AbstractFFmpegAudioCodec

Throws:

javax.media.ResourceUnavailableException - if any of the resources that this Codec needs to operate cannot be acquired

doProcess

protected int doProcess(javax.media.Buffer inBuf,
                        javax.media.Buffer outBuf)

Specified by:

doProcess in class AbstractCodec2

findAVCodec

protected long findAVCodec(int codecID)

Finds an AVCodec with a specific AVCodecID. The method is invoked by AbstractFFmpegAudioCodec.doOpen() in order to (eventually) open a new AVCodecContext.

Specified by:

findAVCodec in class AbstractFFmpegAudioCodec

Parameters:

codecID - the AVCodecID of the AVCodec to find

Returns:

an AVCodec with the specified codecID or 0

getAVCodecContextFormat

protected javax.media.format.AudioFormat getAVCodecContextFormat()

Gets the AudioFormat with which AbstractFFmpegAudioCodec.avctx is to be configured and opened by AbstractFFmpegAudioCodec.doOpen().

Specified by:

getAVCodecContextFormat in class AbstractFFmpegAudioCodec

Returns:

the AudioFormat with which avctx is to be configured and opened by doOpen()