1
0
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:
lllucius
2013-10-24 04:32:13 +00:00
parent 99acb56af6
commit 3effa9693f
124 changed files with 44671 additions and 44430 deletions

View File

@@ -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] &lt;infile&gt; [outfile]</p>
<div class="paragraph"><p><em>twolame</em> [options] &lt;infile&gt; [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&#8217;t
normally be needed.
</p>
</dd>
<dt>
<dt class="hdlist1">
-s, --samplerate &lt;int&gt;
</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 &lt;int&gt;
</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 &lt;int&gt;
</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 &lt;float&gt;
</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 &lt;float&gt;
</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 &lt;float&gt;
</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 &lt;char&gt;
</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 &lt;int&gt;
</dt>
<dd>
@@ -198,7 +216,7 @@ Sample Rate Mono Stereo
------------------------------</tt></pre>
</div></div>
</dd>
<dt>
<dt class="hdlist1">
-P, --psyc-mode &lt;int&gt;
</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 &lt;float&gt;
<dt class="hdlist1">
-V, --vbr-level &lt;float&gt;
</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 &lt;float&gt;
</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 &lt;int&gt;
</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 &lt;int&gt;
</dt>
<dd>
@@ -310,7 +330,7 @@ Sample Rate Mono Stereo
output bitstream.
</p>
</dd>
<dt>
<dt class="hdlist1">
-e, --deemphasis &lt;char&gt;
</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 &lt;int&gt;
</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&#8217;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 - - &gt; 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 &#169; 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 &#169; 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>