Class NbEncoder

java.lang.Object

javaforce.codec.speex.NbCodec

javaforce.codec.speex.NbEncoder

All Implemented Interfaces:

Codebook, Encoder

public class NbEncoder
extends NbCodec
implements Encoder

Narrowband Speex Encoder

Version:

$Revision$

Author:

Marc Gimpel, Wimba S.A. (mgimpel@horizonwimba.com)

Field Summary

Fields

Modifier and Type	Field	Description
protected float	abr_count
protected float	abr_drift	Relative quality that will be needed by VBR
protected float	abr_drift2
protected int	abr_enabled	1 for enabling VAD, 0 otherwise
protected int	complexity	Number of consecutive DTX frames
static final int[]	NB_QUALITY_MAP	The Narrowband Quality map indicates which narrowband submode to use for the given narrowband quality setting
protected float	relative_quality	Quality setting for VBR encoding
protected int	sampling_rate
protected int	submodeSelect
protected int	vad_enabled	1 for enabling VBR, 0 otherwise
protected int	vbr_enabled	Complexity setting (0-10 from least complex to most complex)
protected float	vbr_quality	ABR setting (in bps), 0 if off

Fields inherited from class javaforce.codec.speex.NbCodec

awk1, awk2, awk3, bufSize, dtx_enabled, exc_gain_quant_scal1, exc_gain_quant_scal3, excBuf, excIdx, filters, first, frameSize, frmBuf, frmIdx, gamma1, gamma2, innov, interp_qlpc, interp_qlsp, lag_factor, lpc, lpc_floor, lpcSize, m_lsp, max_pitch, mem_sp, min_pitch, NB_FRAME_SIZE, NB_SUBMODE_BITS, NB_SUBMODES, nbSubframes, old_qlsp, pi_gain, pre_mem, preemph, qlsp, subframeSize, submodeID, submodes, VERY_SMALL, voc_m1, voc_m2, voc_mean, voc_offset, windowSize

Fields inherited from interface javaforce.codec.speex.Codebook

cdbk_nb, cdbk_nb_high1, cdbk_nb_high2, cdbk_nb_low1, cdbk_nb_low2, exc_10_16_table, exc_10_32_table, exc_20_32_table, exc_5_256_table, exc_5_64_table, exc_8_128_table, gain_cdbk_lbr, gain_cdbk_nb, h0, h1, hexc_10_32_table, hexc_table, high_lsp_cdbk, high_lsp_cdbk2, NB_CDBK_SIZE, NB_CDBK_SIZE_HIGH1, NB_CDBK_SIZE_HIGH2, NB_CDBK_SIZE_LOW1, NB_CDBK_SIZE_LOW2

Constructor Summary

Constructors

Constructor	Description
NbEncoder()

Method Summary

Modifier and Type	Method	Description
int	encode(Bits bits, float[] in)	Encode the given input signal.
int	getAbr()	Returns the Average Bit Rate used (0 if ABR is not turned on).
int	getBitRate()	Gets the bitrate.
int	getComplexity()	Returns the algorthmic complexity.
int	getEncodedFrameSize()	Returns the size in bits of an audio frame encoded with the current mode.
int	getLookAhead()	Return LookAhead.
int	getMode()	Returns the encoding submode currently in use.
float	getRelativeQuality()	Returns the relative quality.
int	getSamplingRate()	Returns the sampling rate.
boolean	getVad()	Returns whether or not we are using Voice Activity Detection encoding.
boolean	getVbr()	Returns whether or not we are using Variable Bit Rate encoding.
float	getVbrQuality()	Returns the Varible Bit Rate Quality.
void	init(int frameSize, int subframeSize, int lpcSize, int bufSize)	Initialisation
void	setAbr(int abr)	Sets the Average Bit Rate.
void	setBitRate(int bitrate)	Sets the bitrate.
void	setComplexity(int complexity)	Sets the algorthmic complexity.
void	setDtx(boolean dtx)	Sets whether or not to use Discontinuous Transmission encoding.
void	setMode(int mode)	Sets the encoding submode.
void	setQuality(int quality)	Sets the Quality
void	setSamplingRate(int rate)	Sets the sampling rate.
void	setVad(boolean vad)	Sets whether or not to use Voice Activity Detection encoding.
void	setVbr(boolean vbr)	Sets whether or not to use Variable Bit Rate encoding.
void	setVbrQuality(float quality)	Sets the Varible Bit Rate Quality.

Methods inherited from class javaforce.codec.speex.NbCodec

getDtx, getExc, getFrameSize, getInnov, getPiGain, nbinit

Methods inherited from class java.lang.Object

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

Methods inherited from interface javaforce.codec.speex.Encoder

getDtx, getExc, getFrameSize, getInnov, getPiGain

Field Details

NB_QUALITY_MAP

public static final int[] NB_QUALITY_MAP

The Narrowband Quality map indicates which narrowband submode to use for the given narrowband quality setting

complexity

protected int complexity

Number of consecutive DTX frames

vbr_enabled

protected int vbr_enabled

Complexity setting (0-10 from least complex to most complex)

vad_enabled

protected int vad_enabled

1 for enabling VBR, 0 otherwise

abr_enabled

protected int abr_enabled

1 for enabling VAD, 0 otherwise

vbr_quality

protected float vbr_quality

ABR setting (in bps), 0 if off

relative_quality

protected float relative_quality

Quality setting for VBR encoding

abr_drift

protected float abr_drift

Relative quality that will be needed by VBR

abr_drift2

protected float abr_drift2

abr_count

protected float abr_count

sampling_rate

protected int sampling_rate

submodeSelect

protected int submodeSelect

Constructor Details

NbEncoder

public NbEncoder()

Method Details

init

public void init(int frameSize,
 int subframeSize,
 int lpcSize,
 int bufSize)

Initialisation

Overrides:

init in class NbCodec

Parameters:

frameSize -

subframeSize -

lpcSize -

bufSize -

encode

public int encode(Bits bits,
 float[] in)

Encode the given input signal.

Specified by:

encode in interface Encoder

Parameters:

bits - - Speex bits buffer.

in - - the raw mono audio frame to encode.

Returns:

return 1 if successful.

getEncodedFrameSize

public int getEncodedFrameSize()

Returns the size in bits of an audio frame encoded with the current mode.

Specified by:

getEncodedFrameSize in interface Encoder

Returns:

the size in bits of an audio frame encoded with the current mode.

setQuality

public void setQuality(int quality)

Sets the Quality

Specified by:

setQuality in interface Encoder

Parameters:

quality -

getBitRate

public int getBitRate()

Gets the bitrate.

Specified by:

getBitRate in interface Encoder

Returns:

the bitrate.

setMode

public void setMode(int mode)

Sets the encoding submode.

Specified by:

setMode in interface Encoder

Parameters:

mode -

getMode

public int getMode()

Returns the encoding submode currently in use.

Specified by:

getMode in interface Encoder

Returns:

the encoding submode currently in use.

setBitRate

public void setBitRate(int bitrate)

Sets the bitrate.

Specified by:

setBitRate in interface Encoder

Parameters:

bitrate -

setVbr

public void setVbr(boolean vbr)

Sets whether or not to use Variable Bit Rate encoding.

Specified by:

setVbr in interface Encoder

Parameters:

vbr -

getVbr

public boolean getVbr()

Returns whether or not we are using Variable Bit Rate encoding.

Specified by:

getVbr in interface Encoder

Returns:

whether or not we are using Variable Bit Rate encoding.

setVad

public void setVad(boolean vad)

Sets whether or not to use Voice Activity Detection encoding.

Specified by:

setVad in interface Encoder

Parameters:

vad -

getVad

public boolean getVad()

Returns whether or not we are using Voice Activity Detection encoding.

Specified by:

getVad in interface Encoder

Returns:

whether or not we are using Voice Activity Detection encoding.

setDtx

public void setDtx(boolean dtx)

Sets whether or not to use Discontinuous Transmission encoding.

Specified by:

setDtx in interface Encoder

Parameters:

dtx -

getAbr

public int getAbr()

Returns the Average Bit Rate used (0 if ABR is not turned on).

Specified by:

getAbr in interface Encoder

Returns:

the Average Bit Rate used (0 if ABR is not turned on).

setAbr

public void setAbr(int abr)

Sets the Average Bit Rate.

Specified by:

setAbr in interface Encoder

Parameters:

abr -

setVbrQuality

public void setVbrQuality(float quality)

Sets the Varible Bit Rate Quality.

Specified by:

setVbrQuality in interface Encoder

Parameters:

quality -

getVbrQuality

public float getVbrQuality()

Returns the Varible Bit Rate Quality.

Specified by:

getVbrQuality in interface Encoder

Returns:

the Varible Bit Rate Quality.

setComplexity

public void setComplexity(int complexity)

Sets the algorthmic complexity.

Specified by:

setComplexity in interface Encoder

Parameters:

complexity -

getComplexity

public int getComplexity()

Returns the algorthmic complexity.

Specified by:

getComplexity in interface Encoder

Returns:

the algorthmic complexity.

setSamplingRate

public void setSamplingRate(int rate)

Sets the sampling rate.

Specified by:

setSamplingRate in interface Encoder

Parameters:

rate -

getSamplingRate

public int getSamplingRate()

Returns the sampling rate.

Specified by:

getSamplingRate in interface Encoder

Returns:

the sampling rate.

getLookAhead

public int getLookAhead()

Return LookAhead.

Specified by:

getLookAhead in interface Encoder

Returns:

LookAhead.

getRelativeQuality

public float getRelativeQuality()

Returns the relative quality.

Specified by:

getRelativeQuality in interface Encoder

Returns:

the relative quality.