Interface Encoder

All Known Implementing Classes:
NbEncoder, SbEncoder

public interface Encoder
Speex Encoder interface, used as a base for the Narrowband and sideband encoders.
Version:
$Revision: 1.2 $
Author:
Marc Gimpel, Wimba S.A. (mgimpel@horizonwimba.com)
  • Method Summary

    Modifier and Type
    Method
    Description
    int
    encode(Bits bits, float[] in)
    Encode the given input signal.
    int
    Returns the Average Bit Rate used (0 if ABR is not turned on).
    int
    Get the current Bit Rate.
    int
    Returns the algorthmic complexity.
    boolean
    Returns whether or not we are using Discontinuous Transmission encoding.
    int
    Returns the size in bits of an audio frame encoded with the current mode.
    float[]
    Returns the excitation array.
    int
    Returns the size of a frame.
    float[]
    Returns the innovation array.
    int
    Return LookAhead.
    int
    Returns the encoding submode currently in use.
    float[]
    Returns the Pitch Gain array.
    float
    Returns the relative quality.
    int
    Returns the sampling rate.
    boolean
    Returns whether or not we are using Voice Activity Detection encoding.
    boolean
    Returns whether or not we are using Variable Bit Rate encoding.
    float
    Returns the Varible Bit Rate Quality.
    void
    setAbr(int abr)
    Sets the Average Bit Rate.
    void
    setBitRate(int bitrate)
    Sets the bitrate.
    void
    setComplexity(int complexity)
    Sets the algorithmic 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 (between 0 and 10).
    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.
  • Method Details

    • encode

      int encode(Bits bits, float[] in)
      Encode the given input signal.
      Parameters:
      bits - - Speex bits buffer.
      in - - the raw mono audio frame to encode.
      Returns:
      1 if successful.
    • getEncodedFrameSize

      int getEncodedFrameSize()
      Returns the size in bits of an audio frame encoded with the current mode.
      Returns:
      the size in bits of an audio frame encoded with the current mode.
    • getFrameSize

      int getFrameSize()
      Returns the size of a frame.
      Returns:
      the size of a frame.
    • setQuality

      void setQuality(int quality)
      Sets the Quality (between 0 and 10).
      Parameters:
      quality - - the desired Quality (between 0 and 10).
    • getBitRate

      int getBitRate()
      Get the current Bit Rate.
      Returns:
      the current Bit Rate.
    • getPiGain

      float[] getPiGain()
      Returns the Pitch Gain array.
      Returns:
      the Pitch Gain array.
    • getExc

      float[] getExc()
      Returns the excitation array.
      Returns:
      the excitation array.
    • getInnov

      float[] getInnov()
      Returns the innovation array.
      Returns:
      the innovation array.
    • setMode

      void setMode(int mode)
      Sets the encoding submode.
      Parameters:
      mode -
    • getMode

      int getMode()
      Returns the encoding submode currently in use.
      Returns:
      the encoding submode currently in use.
    • setBitRate

      void setBitRate(int bitrate)
      Sets the bitrate.
      Parameters:
      bitrate -
    • setVbr

      void setVbr(boolean vbr)
      Sets whether or not to use Variable Bit Rate encoding.
      Parameters:
      vbr -
    • getVbr

      boolean getVbr()
      Returns whether or not we are using Variable Bit Rate encoding.
      Returns:
      whether or not we are using Variable Bit Rate encoding.
    • setVad

      void setVad(boolean vad)
      Sets whether or not to use Voice Activity Detection encoding.
      Parameters:
      vad -
    • getVad

      boolean getVad()
      Returns whether or not we are using Voice Activity Detection encoding.
      Returns:
      whether or not we are using Voice Activity Detection encoding.
    • setDtx

      void setDtx(boolean dtx)
      Sets whether or not to use Discontinuous Transmission encoding.
      Parameters:
      dtx -
    • getDtx

      boolean getDtx()
      Returns whether or not we are using Discontinuous Transmission encoding.
      Returns:
      whether or not we are using Discontinuous Transmission encoding.
    • getAbr

      int getAbr()
      Returns the Average Bit Rate used (0 if ABR is not turned on).
      Returns:
      the Average Bit Rate used (0 if ABR is not turned on).
    • setAbr

      void setAbr(int abr)
      Sets the Average Bit Rate.
      Parameters:
      abr - - the desired Average Bit Rate.
    • setVbrQuality

      void setVbrQuality(float quality)
      Sets the Varible Bit Rate Quality.
      Parameters:
      quality - - the desired Varible Bit Rate Quality.
    • getVbrQuality

      float getVbrQuality()
      Returns the Varible Bit Rate Quality.
      Returns:
      the Varible Bit Rate Quality.
    • setComplexity

      void setComplexity(int complexity)
      Sets the algorithmic complexity.
      Parameters:
      complexity - - the desired algorithmic complexity (between 1 and 10 - default is 3).
    • getComplexity

      int getComplexity()
      Returns the algorthmic complexity.
      Returns:
      the algorthmic complexity.
    • setSamplingRate

      void setSamplingRate(int rate)
      Sets the sampling rate.
      Parameters:
      rate - - the sampling rate.
    • getSamplingRate

      int getSamplingRate()
      Returns the sampling rate.
      Returns:
      the sampling rate.
    • getLookAhead

      int getLookAhead()
      Return LookAhead.
      Returns:
      LookAhead.
    • getRelativeQuality

      float getRelativeQuality()
      Returns the relative quality.
      Returns:
      the relative quality.