From 3269dcec2f1b48046740a150e2797651f847aa54 Mon Sep 17 00:00:00 2001 From: Kat Walsh Date: Mon, 15 Aug 2011 22:43:51 -0400 Subject: Updated README files to reflect current output of tool and tweaked punctuation and wording. Corrected typo in test_opus ("constraint"->"constrained"). --- README | 21 ++++++++++++++------- README.draft | 29 ++++++++++++++++++----------- src/test_opus.c | 2 +- 3 files changed, 33 insertions(+), 19 deletions(-) diff --git a/README b/README index a6be1406..b271f163 100644 --- a/README +++ b/README @@ -5,7 +5,7 @@ To build from a distribution tarball, you only need to do the following: % ./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 @@ To build from the git repository, the following steps are necessary 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 [options] +Usage: ./test_opus [-e | -d] [options] -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 : 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 : 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 : maximum payload size in bytes, default: 1024 -complexity : 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 : simulate packet loss, in percent (0-100); default: 0 diff --git a/README.draft b/README.draft index cc8219e0..400180f5 100644 --- a/README.draft +++ b/README.draft @@ -2,11 +2,12 @@ To build this source code, simply type: % 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 @@ steps are necessary % ./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 [options] +Usage: ./test_opus [-e | -d] [options] -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 : 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 : 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 : maximum payload size in bytes, default: 1024 -complexity : 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 : simulate packet loss, in percent (0-100); default: 0 diff --git a/src/test_opus.c b/src/test_opus.c index d1476d62..dd9fb8c4 100644 --- a/src/test_opus.c +++ b/src/test_opus.c @@ -49,7 +49,7 @@ void print_usage( char* argv[] ) 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 : 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 : maximum payload size in bytes, default: 1024\n" ); -- cgit v1.2.3