mirror of
https://github.com/cookiengineer/audacity
synced 2025-10-16 23:51:18 +02:00
Update twolame to 0.3.13.
This commit is contained in:
@@ -2,14 +2,19 @@
|
||||
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
||||
<meta name="generator" content="AsciiDoc 7.1.2" />
|
||||
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
|
||||
<meta name="generator" content="AsciiDoc 8.6.3" />
|
||||
<title>TWOLAME(1)</title>
|
||||
<link rel="stylesheet" href="./twolame.css" type="text/css" />
|
||||
<link rel="stylesheet" href="./twolame-manpage.css" type="text/css" />
|
||||
<link rel="stylesheet" href="./twolame-quirks.css" type="text/css" />
|
||||
<title>TWOLAME(1)</title>
|
||||
<script type="text/javascript">
|
||||
/*<![CDATA[*/
|
||||
window.onload = function(){asciidoc.footnotes();}
|
||||
/*]]>*/
|
||||
</script>
|
||||
<script type="text/javascript" src="./asciidoc-xhtml11.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<body class="manpage">
|
||||
<div id="header">
|
||||
<h1>
|
||||
TWOLAME(1) Manual Page
|
||||
@@ -21,29 +26,40 @@ TWOLAME(1) Manual Page
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<h2>SYNOPSIS</h2>
|
||||
<div id="content">
|
||||
<div class="sect1">
|
||||
<h2 id="_synopsis">SYNOPSIS</h2>
|
||||
<div class="sectionbody">
|
||||
<p><em>twolame</em> [options] <infile> [outfile]</p>
|
||||
<div class="paragraph"><p><em>twolame</em> [options] <infile> [outfile]</p></div>
|
||||
</div>
|
||||
<h2>DESCRIPTION</h2>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_description">DESCRIPTION</h2>
|
||||
<div class="sectionbody">
|
||||
<p>TwoLAME is an optimised MPEG Audio Layer 2 (MP2) encoder based on tooLAME by
|
||||
<div class="paragraph"><p>TwoLAME is an optimised MPEG Audio Layer 2 (MP2) encoder based on tooLAME by
|
||||
Mike Cheng, which in turn is based upon the ISO dist10 code and portions of
|
||||
LAME. Encoding is performed by the libtwolame library backend.</p>
|
||||
LAME. Encoding is performed by the libtwolame library backend.</p></div>
|
||||
</div>
|
||||
<h2>OPTIONS</h2>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_options">OPTIONS</h2>
|
||||
<div class="sectionbody">
|
||||
<h3>Input File</h3>
|
||||
<p>twolame uses libsndfile for reading the input sound file, so
|
||||
<div class="sect2">
|
||||
<h3 id="_input_file">Input File</h3>
|
||||
<div class="paragraph"><p>twolame uses libsndfile for reading the input sound file, so
|
||||
the input file can be in any format supported by libsndfile.
|
||||
To read raw PCM audio from STDIN, then use - as the input filename.</p>
|
||||
<h3>Output File</h3>
|
||||
<p>If no output filename is specified, then suffix of the input filename
|
||||
To read raw PCM audio from STDIN, then use - as the input filename.</p></div>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_output_file">Output File</h3>
|
||||
<div class="paragraph"><p>If no output filename is specified, then suffix of the input filename
|
||||
is automatically changed to .mp2. To write the encoded audio to STDOUT
|
||||
then use - as the output filename.</p>
|
||||
<h3>Input Options</h3>
|
||||
<dl>
|
||||
<dt>
|
||||
then use - as the output filename.</p></div>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_input_options">Input Options</h3>
|
||||
<div class="dlist"><dl>
|
||||
<dt class="hdlist1">
|
||||
-r, --raw-input
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -53,17 +69,17 @@ then use - as the output filename.</p>
|
||||
between the two channels.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-x, --byte-swap
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
Force byte-swapping of the input. Endian detection is performed
|
||||
automatically by libsndfile, so this option shouldn't
|
||||
automatically by libsndfile, so this option shouldn’t
|
||||
normally be needed.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-s, --samplerate <int>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -74,7 +90,7 @@ then use - as the output filename.</p>
|
||||
Default sample rate is 44100Hz.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
--samplesize <int>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -84,7 +100,7 @@ then use - as the output filename.</p>
|
||||
Default sample size is 16-bit.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-N, --channels <int>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -93,7 +109,7 @@ then use - as the output filename.</p>
|
||||
in the input audio. Default number of channels is 2.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-g, --swap-channels
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -101,7 +117,7 @@ then use - as the output filename.</p>
|
||||
Swap the Left and Right channels of a stereo input file.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
--scale <float>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -112,7 +128,7 @@ then use - as the output filename.</p>
|
||||
above 1 will increase the gain of the audio.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
--scale-l <float>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -120,7 +136,7 @@ then use - as the output filename.</p>
|
||||
Same as --scale, but only affects the left channel.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
--scale-r <float>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -128,17 +144,19 @@ then use - as the output filename.</p>
|
||||
Same as --scale, but only affects the right channel.
|
||||
</p>
|
||||
</dd>
|
||||
</dl>
|
||||
<h3>Output Options</h3>
|
||||
<dl>
|
||||
<dt>
|
||||
</dl></div>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_output_options">Output Options</h3>
|
||||
<div class="dlist"><dl>
|
||||
<dt class="hdlist1">
|
||||
-m, --mode <char>
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
Choose the mode of the resulting audio. Default is auto.
|
||||
</p>
|
||||
<ul>
|
||||
<div class="ulist"><ul>
|
||||
<li>
|
||||
<p>
|
||||
"a" auto - choose mode automatically based on the input
|
||||
@@ -164,9 +182,9 @@ then use - as the output filename.</p>
|
||||
"m" mono
|
||||
</p>
|
||||
</li>
|
||||
</ul>
|
||||
</ul></div>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-a, --downmix
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -175,7 +193,7 @@ then use - as the output filename.</p>
|
||||
input channels into a single mono channel.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-b, --bitrate <int>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -198,7 +216,7 @@ Sample Rate Mono Stereo
|
||||
------------------------------</tt></pre>
|
||||
</div></div>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-P, --psyc-mode <int>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -211,7 +229,7 @@ Sample Rate Mono Stereo
|
||||
Default model is 3.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-v, --vbr
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -220,8 +238,8 @@ Sample Rate Mono Stereo
|
||||
Default VBR level is 5.0.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
-v, --vbr-level <float>
|
||||
<dt class="hdlist1">
|
||||
-V, --vbr-level <float>
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
@@ -231,7 +249,7 @@ Sample Rate Mono Stereo
|
||||
See <em>vbr</em> documentation file for details.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-l, --ath <float>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -239,7 +257,7 @@ Sample Rate Mono Stereo
|
||||
Set the ATH level. Default level is 0.0.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-q, --quick <int>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -248,7 +266,7 @@ Sample Rate Mono Stereo
|
||||
model every specified number of frames.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-S, --single-frame
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -257,10 +275,12 @@ Sample Rate Mono Stereo
|
||||
is output and then the program terminates.
|
||||
</p>
|
||||
</dd>
|
||||
</dl>
|
||||
<h3>Miscellaneous Options</h3>
|
||||
<dl>
|
||||
<dt>
|
||||
</dl></div>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_miscellaneous_options">Miscellaneous Options</h3>
|
||||
<div class="dlist"><dl>
|
||||
<dt class="hdlist1">
|
||||
-c, --copyright
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -268,7 +288,7 @@ Sample Rate Mono Stereo
|
||||
Turn on Copyright flag in output bitstream.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-o, --non-original
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -276,7 +296,7 @@ Sample Rate Mono Stereo
|
||||
Turn off Original flag in output bitstream.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
--original
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -284,7 +304,7 @@ Sample Rate Mono Stereo
|
||||
Turn on Original flag in output bitstream.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-p, --protect
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -293,7 +313,7 @@ Sample Rate Mono Stereo
|
||||
An extra 16-bit checksum is added to frames.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-d, --padding
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -301,7 +321,7 @@ Sample Rate Mono Stereo
|
||||
Turn on padding in output bitstream.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-R, --reserve <int>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -310,7 +330,7 @@ Sample Rate Mono Stereo
|
||||
output bitstream.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-e, --deemphasis <char>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -318,7 +338,7 @@ Sample Rate Mono Stereo
|
||||
Set the de-emphasis type (n/c/5). Default is none.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
-E, --energy
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -326,10 +346,12 @@ Sample Rate Mono Stereo
|
||||
Turn on energy level extensions.
|
||||
</p>
|
||||
</dd>
|
||||
</dl>
|
||||
<h3>Verbosity Options</h3>
|
||||
<dl>
|
||||
<dt>
|
||||
</dl></div>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_verbosity_options">Verbosity Options</h3>
|
||||
<div class="dlist"><dl>
|
||||
<dt class="hdlist1">
|
||||
-t, --talkativity <int>
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -338,16 +360,16 @@ Sample Rate Mono Stereo
|
||||
Default is 2.
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
--quiet
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
Don't send any messages to stderr, unless there is an error.
|
||||
Don’t send any messages to stderr, unless there is an error.
|
||||
(Same as --talkativity=0)
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
--brief
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -357,7 +379,7 @@ Sample Rate Mono Stereo
|
||||
(Same as --talkativity=1)
|
||||
</p>
|
||||
</dd>
|
||||
<dt>
|
||||
<dt class="hdlist1">
|
||||
--verbose
|
||||
</dt>
|
||||
<dd>
|
||||
@@ -367,13 +389,16 @@ Sample Rate Mono Stereo
|
||||
(Same as --talkativity=4)
|
||||
</p>
|
||||
</dd>
|
||||
</dl>
|
||||
</dl></div>
|
||||
</div>
|
||||
<h2>Return Codes</h2>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_return_codes">Return Codes</h2>
|
||||
<div class="sectionbody">
|
||||
<p>If encoding completes successfully, then twolame will return 0.
|
||||
However if encoding is not successful, then it will return one of the following codes.</p>
|
||||
<ul>
|
||||
<div class="paragraph"><p>If encoding completes successfully, then twolame will return 0.
|
||||
However if encoding is not successful, then it will return one of the following codes.</p></div>
|
||||
<div class="ulist"><ul>
|
||||
<li>
|
||||
<p>
|
||||
1 (No encoding performed)
|
||||
@@ -414,62 +439,75 @@ However if encoding is not successful, then it will return one of the following
|
||||
14 (Error writing output audio)
|
||||
</p>
|
||||
</li>
|
||||
</ul>
|
||||
</ul></div>
|
||||
</div>
|
||||
<h2>EXAMPLES</h2>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_examples">EXAMPLES</h2>
|
||||
<div class="sectionbody">
|
||||
<p>This will encode sound.wav to sound.mp2 using the default constant bitrate of 192 kbps
|
||||
and using the default psycho-acoustic model (model 3):</p>
|
||||
<div class="paragraph"><p>This will encode sound.wav to sound.mp2 using the default constant bitrate of 192 kbps
|
||||
and using the default psycho-acoustic model (model 3):</p></div>
|
||||
<div class="literalblock">
|
||||
<div class="content">
|
||||
<pre><tt>twolame sound.wav</tt></pre>
|
||||
</div></div>
|
||||
<p>Constant bitrate of 160kbps and joint stereo encoding, saved to file sound_160.mp2:</p>
|
||||
<div class="paragraph"><p>Constant bitrate of 160kbps and joint stereo encoding, saved to file sound_160.mp2:</p></div>
|
||||
<div class="literalblock">
|
||||
<div class="content">
|
||||
<pre><tt>twolame -b 160 -m j sound.aiff sound_160.mp2</tt></pre>
|
||||
</div></div>
|
||||
<p>Encode sound.wav to newfile.mp2 using psycho-acoustic model 2 and encoding
|
||||
with variable bitrate:</p>
|
||||
<div class="paragraph"><p>Encode sound.wav to newfile.mp2 using psycho-acoustic model 2 and encoding
|
||||
with variable bitrate:</p></div>
|
||||
<div class="literalblock">
|
||||
<div class="content">
|
||||
<pre><tt>twolame -P 2 -v sound.wav newfile.mp2</tt></pre>
|
||||
</div></div>
|
||||
<p>Same as example above, except that the negative value of the "-V" argument
|
||||
means that the lower bitrates will be favoured over the higher ones:</p>
|
||||
<div class="paragraph"><p>Same as example above, except that the negative value of the "-V" argument
|
||||
means that the lower bitrates will be favoured over the higher ones:</p></div>
|
||||
<div class="literalblock">
|
||||
<div class="content">
|
||||
<pre><tt>twolame -P 2 -V -5 sound.wav newfile.mp2</tt></pre>
|
||||
</div></div>
|
||||
<p>Resample audio file using sox and pipe straight through twolame:</p>
|
||||
<div class="paragraph"><p>Resample audio file using sox and pipe straight through twolame:</p></div>
|
||||
<div class="literalblock">
|
||||
<div class="content">
|
||||
<pre><tt>sox sound_11025.aiff -t raw -r 16000 | twolame -r -s 16000 - - > out.mp2</tt></pre>
|
||||
</div></div>
|
||||
</div>
|
||||
<h2>AUTHORS</h2>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_authors">AUTHORS</h2>
|
||||
<div class="sectionbody">
|
||||
<p>The twolame frontend was (re)written by Nicholas J Humfrey.
|
||||
<div class="paragraph"><p>The twolame frontend was (re)written by Nicholas J Humfrey.
|
||||
The libtwolame library is based on toolame by Mike Cheng.
|
||||
For a full list of authors, please see the AUTHORS file.</p>
|
||||
For a full list of authors, please see the AUTHORS file.</p></div>
|
||||
</div>
|
||||
<h2>RESOURCES</h2>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_resources">RESOURCES</h2>
|
||||
<div class="sectionbody">
|
||||
<p>TwoLAME web site: http://www.twolame.org/</p>
|
||||
<div class="paragraph"><p>TwoLAME web site: <a href="http://www.twolame.org/">http://www.twolame.org/</a></p></div>
|
||||
</div>
|
||||
<h2>SEE ALSO</h2>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_see_also">SEE ALSO</h2>
|
||||
<div class="sectionbody">
|
||||
<p>lame(1), mpg123(1), madplay(1), sox(1)</p>
|
||||
<div class="paragraph"><p>lame(1), mpg123(1), madplay(1), sox(1)</p></div>
|
||||
</div>
|
||||
<h2>COPYING</h2>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_copying">COPYING</h2>
|
||||
<div class="sectionbody">
|
||||
<p>Copyright © 2004-2006 The TwoLAME Project. Free use of this software is
|
||||
granted under the terms of the GNU Lesser General Public License (LGPL).</p>
|
||||
<div class="paragraph"><p>Copyright © 2004-2006 The TwoLAME Project. Free use of this software is
|
||||
granted under the terms of the GNU Lesser General Public License (LGPL).</p></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="footnotes"><hr /></div>
|
||||
<div id="footer">
|
||||
<div id="footer-text">
|
||||
Version 0.3.11<br />
|
||||
Last updated 09-Jan-2008 11:45:19 BST
|
||||
Version 0.3.13<br />
|
||||
Last updated 2011-01-02 12:18:34 GMT
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
|
Reference in New Issue
Block a user