Updated draft
[speexdsp.git] / doc / manual.lyx
index e61caae..43710b8 100644 (file)
@@ -4350,7 +4350,7 @@ spx_int32_t
 \end_layout
 
 \begin_layout Description
-SPEEX_PREPROCESS_GET_ECHO_SUPPRESS Set maximum attenuation of the residual
+SPEEX_PREPROCESS_GET_ECHO_SUPPRESS Get maximum attenuation of the residual
  echo in dB (negative 
 \begin_inset listings
 inline true
@@ -4384,7 +4384,7 @@ spx_int32_t
 \end_layout
 
 \begin_layout Description
-SPEEX_PREPROCESS_GET_ECHO_SUPPRESS_ACTIVE Set maximum attenuation of the
+SPEEX_PREPROCESS_GET_ECHO_SUPPRESS_ACTIVE Get maximum attenuation of the
  echo in dB when near end is active (negative 
 \begin_inset listings
 inline true
@@ -6461,7 +6461,7 @@ name "fig:The-CELP-model"
 \end_layout
 
 \begin_layout Section
-Linear Prediction (LPC)
+Linear Prediction Coefficients (LPC)
 \begin_inset Index
 status collapsed
 
@@ -8359,7 +8359,35 @@ Adaptive codebook
 \end_layout
 
 \begin_layout Standard
-Decode period (constant, offset, per sub-frame)
+For rates of 8 kbit/s and above, the pitch period is encoded for each subframe.
+ The real period is 
+\begin_inset Formula $T=p_{i}+17$
+\end_inset
+
+ where 
+\begin_inset Formula $p_{i}$
+\end_inset
+
+ is a value encoded with 7 bits and 17 corresponds to the minimum pitch.
+ The maximum period is 144.
+ At 5.95 kbit/s (mode 2), the pitch period is similarly encoded, but only
+ once for the frame.
+ Each sub-frame then has a 2-bit offset that is added to the pitch value
+ of the frame.
+ In that case, the pitch for each sub-frame is equal to 
+\begin_inset Formula $T-1+offset$
+\end_inset
+
+.
+ For rates below 5.95 kbit/s, only the per-frame pitch is used and the pitch
+ is constant for all sub-frames.
+\end_layout
+
+\begin_layout Standard
+Speex uses a 3-tap predictor for rates of 5.95 kbit/s and above.
+ The three gain values are obtained from a 5-bit or a 7-bit codebook, depending
+ on the mode.
+  
 \end_layout
 
 \begin_layout Subsection
@@ -8500,7 +8528,7 @@ reference "cap:Frame-open-loop-analysis"
 Linear prediction analysis is performed once per frame using an asymmetric
  Hamming window centered on the fourth sub-frame.
  Because linear prediction coefficients (LPC) are not robust to quantization,
- they are first are converted to line spectral pairs (LSP)
+ they are first converted to line spectral pairs (LSP)
 \begin_inset Index
 status collapsed
 
@@ -11047,7 +11075,7 @@ name "sec:IETF-draft"
 \begin_layout Standard
 \begin_inset CommandInset include
 LatexCommand verbatiminput
-filename "draft-ietf-avt-rtp-speex-01-tmp.txt"
+filename "draft-ietf-avt-rtp-speex-05-tmp.txt"
 
 \end_inset