ref: 3269dcec2f1b48046740a150e2797651f847aa54
parent: 66ff26f3565820ce8acea5511a0a6ae7b1246a78
author: Kat Walsh <[email protected]>
date: Mon Aug 15 18:43:51 EDT 2011
Updated README files to reflect current output of tool and tweaked punctuation and wording. Corrected typo in test_opus ("constraint"->"constrained").
--- a/README
+++ b/README
@@ -5,7 +5,7 @@
% ./configure
% make
-To build from the git repository, the following steps are necessary
+To build from the git repository, the following steps are necessary:
1) Clone the repository:
@@ -20,18 +20,25 @@
Once you have compiled the codec, there will be a test_opus executable in
-the src/ directory. This can be in the following way:
+the src/ directory.
-% ./test_opus <mode (0/1/2)> <sampling rate (Hz)> <channels> <bits per second> [options] <input> <output>
+Usage: ./test_opus [-e | -d] <application (0/1)> <sampling rate (Hz)> <channels
+(1/2)> <bits per second> [options] <input> <output>
-mode: 0 for audo, 1 for voice, 2 for audio:
+mode: 0 for VoIP, 1 for audio:
options:
--cbr : enable constant bitrate; default: VBR
--bandwidth <NB|MB|WB|SWB|FB> : audio bandwidth (from narrowband to fullband); default: sampling rate
--framesize <2.5|5|10|20|40|60> : frame size in ms; default: 20
+-e : only runs the encoder (output the bit-stream)
+-d : only runs the decoder (reads the bit-stream as input)
+-cbr : enable constant bitrate; default: variable bitrate
+-cvbr : enable constrained variable bitrate;
+ default: unconstrained
+-bandwidth <NB|MB|WB|SWB|FB> : audio bandwidth (from narrowband to fullband);
+ default: sampling rate
+-framesize <2.5|5|10|20|40|60> : frame size in ms; default: 20
-max_payload <bytes> : maximum payload size in bytes, default: 1024
-complexity <comp> : complexity, 0 (lowest) ... 10 (highest); default: 10
-inbandfec : enable SILK inband FEC
+-forcemono : force mono encoding, even for stereo input
-dtx : enable SILK DTX
-loss <perc> : simulate packet loss, in percent (0-100); default: 0
--- a/README.draft
+++ b/README.draft
@@ -2,11 +2,12 @@
% make
-If this does not work, or to change the default configuration (e.g. compile for
-a fixed-point architecture), simply edit the options in the Makefile
+If this does not work, or if you want to change the default configuration (e.g.,
+to compile for a fixed-point architecture), simply edit the options in the
+Makefile.
-To build from the git repository instead of using this draft, the following
-steps are necessary
+To build from the git repository instead of using this draft, follow these
+steps:
1) Clone the repository:
@@ -19,20 +20,26 @@
% ./configure
% make
-
Once you have compiled the codec, there will be a test_opus executable in
-the src/ directory. This can be in the following way:
+the src/ directory.
-% ./test_opus <mode (0/1/2)> <sampling rate (Hz)> <channels> <bits per second> [options] <input> <output>
+Usage: ./test_opus [-e | -d] <application (0/1)> <sampling rate (Hz)> <channels
+(1/2)> <bits per second> [options] <input> <output>
-mode: 0 for audo, 1 for voice, 2 for audio:
+mode: 0 for VoIP, 1 for audio:
options:
--cbr : enable constant bitrate; default: VBR
--bandwidth <NB|MB|WB|SWB|FB> : audio bandwidth (from narrowband to fullband); default: sampling rate
--framesize <2.5|5|10|20|40|60> : frame size in ms; default: 20
+-e : only runs the encoder (output the bit-stream)
+-d : only runs the decoder (reads the bit-stream as input)
+-cbr : enable constant bitrate; default: variable bitrate
+-cvbr : enable constrained variable bitrate;
+ default: unconstrained
+-bandwidth <NB|MB|WB|SWB|FB> : audio bandwidth (from narrowband to fullband);
+ default: sampling rate
+-framesize <2.5|5|10|20|40|60> : frame size in ms; default: 20
-max_payload <bytes> : maximum payload size in bytes, default: 1024
-complexity <comp> : complexity, 0 (lowest) ... 10 (highest); default: 10
-inbandfec : enable SILK inband FEC
+-forcemono : force mono encoding, even for stereo input
-dtx : enable SILK DTX
-loss <perc> : simulate packet loss, in percent (0-100); default: 0
--- a/src/test_opus.c
+++ b/src/test_opus.c
@@ -49,7 +49,7 @@
fprintf(stderr, "-e : only runs the encoder (output the bit-stream)\n" );
fprintf(stderr, "-d : only runs the decoder (reads the bit-stream as input)\n" );
fprintf(stderr, "-cbr : enable constant bitrate; default: variable bitrate\n" );
- fprintf(stderr, "-cvbr : enable constraint variable bitrate; default: unconstraint\n" );
+ fprintf(stderr, "-cvbr : enable constrained variable bitrate; default: unconstrained\n" );
fprintf(stderr, "-bandwidth <NB|MB|WB|SWB|FB> : audio bandwidth (from narrowband to fullband); default: sampling rate\n" );
fprintf(stderr, "-framesize <2.5|5|10|20|40|60> : frame size in ms; default: 20 \n" );
fprintf(stderr, "-max_payload <bytes> : maximum payload size in bytes, default: 1024\n" );