[xiph-commits] r12902 - trunk/speex/doc
jm at svn.xiph.org
jm at svn.xiph.org
Mon Apr 30 08:54:01 PDT 2007
Author: jm
Date: 2007-04-30 08:54:00 -0700 (Mon, 30 Apr 2007)
New Revision: 12902
Modified:
trunk/speex/doc/manual.lyx
Log:
some info on the mode-quality mapping
Modified: trunk/speex/doc/manual.lyx
===================================================================
--- trunk/speex/doc/manual.lyx 2007-04-30 10:38:22 UTC (rev 12901)
+++ trunk/speex/doc/manual.lyx 2007-04-30 15:54:00 UTC (rev 12902)
@@ -1411,9 +1411,32 @@
frame_size
\emph default
will correspond to 20 ms when using 8, 16, or 32 kHz sampling rate.
+ There are many parameters that can be set for the Speex encoder, but the
+ most useful one is the quality parameter that controls the quality vs bit-rate
+ tradeoff.
+ This is set by:
\end_layout
+\begin_layout LyX-Code
+speex_encoder_ctl(enc_state,SPEEX_SET_QUALITY,&quality);
+\end_layout
+
\begin_layout Standard
+where
+\emph on
+quality
+\emph default
+ is an integer value ranging from 0 to 10 (inclusively).
+ The mapping between quality and bit-rate is described in Fig.
+
+\begin_inset LatexCommand \ref{cap:quality_vs_bps}
+
+\end_inset
+
+ for narrowband.
+\end_layout
+
+\begin_layout Standard
Once the initialization is done, for every input frame:
\end_layout
@@ -6358,11 +6381,12 @@
\begin_inset Tabular
-<lyxtabular version="3" rows="17" columns="4">
+<lyxtabular version="3" rows="17" columns="5">
<features>
<column alignment="center" valignment="top" leftline="true" width="0pt">
<column alignment="center" valignment="top" leftline="true" width="0pt">
<column alignment="center" valignment="top" leftline="true" width="0pt">
+<column alignment="center" valignment="top" leftline="true" width="0pt">
<column alignment="center" valignment="top" leftline="true" rightline="true" width="0pt">
<row topline="true" bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
@@ -6378,6 +6402,15 @@
\begin_inset Text
\begin_layout Standard
+Quality
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
Bit-rate
\begin_inset LatexCommand \index{bit-rate}
@@ -6426,6 +6459,15 @@
\begin_inset Text
\begin_layout Standard
+-
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
250
\end_layout
@@ -6435,7 +6477,7 @@
\begin_inset Text
\begin_layout Standard
-N/A
+0
\end_layout
\end_inset
@@ -6464,6 +6506,15 @@
\begin_inset Text
\begin_layout Standard
+0
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
2,150
\end_layout
@@ -6502,6 +6553,15 @@
\begin_inset Text
\begin_layout Standard
+2
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
5,950
\end_layout
@@ -6540,6 +6600,15 @@
\begin_inset Text
\begin_layout Standard
+3-4
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
8,000
\end_layout
@@ -6578,6 +6647,15 @@
\begin_inset Text
\begin_layout Standard
+5-6
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
11,000
\end_layout
@@ -6616,6 +6694,15 @@
\begin_inset Text
\begin_layout Standard
+7-8
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
15,000
\end_layout
@@ -6654,6 +6741,15 @@
\begin_inset Text
\begin_layout Standard
+9
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
18,200
\end_layout
@@ -6692,6 +6788,15 @@
\begin_inset Text
\begin_layout Standard
+10
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
24,600
\end_layout
@@ -6730,6 +6835,15 @@
\begin_inset Text
\begin_layout Standard
+1
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
3,950
\end_layout
@@ -6768,7 +6882,7 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
@@ -6777,11 +6891,20 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+-
+\end_layout
+
+\end_inset
+</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
@@ -6806,7 +6929,7 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
@@ -6815,11 +6938,20 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+-
+\end_layout
+
+\end_inset
+</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
@@ -6844,7 +6976,7 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
@@ -6853,11 +6985,20 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+-
+\end_layout
+
+\end_inset
+</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
@@ -6882,7 +7023,7 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
@@ -6891,11 +7032,20 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+-
+\end_layout
+
+\end_inset
+</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
@@ -6920,7 +7070,7 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
@@ -6929,11 +7079,20 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+-
+\end_layout
+
+\end_inset
+</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
@@ -6958,7 +7117,7 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
@@ -6967,11 +7126,20 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+-
+\end_layout
+
+\end_inset
+</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
@@ -6996,7 +7164,7 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
@@ -7005,11 +7173,20 @@
\begin_inset Text
\begin_layout Standard
-N/A
+-
\end_layout
\end_inset
</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+-
+\end_layout
+
+\end_inset
+</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
More information about the commits
mailing list