[xiph-commits] r7385 - icecast/trunk/ices0/doc
brendan at dactyl.lonelymoon.com
brendan
Tue Jul 27 20:19:16 PDT 2004
Author: brendan
Date: Tue Jul 27 20:19:16 2004
New Revision: 7385
Modified:
icecast/trunk/ices0/doc/icesmanual.html
Log:
Add crossfading documentation
Modified: icecast/trunk/ices0/doc/icesmanual.html
===================================================================
--- icecast/trunk/ices0/doc/icesmanual.html 2004-07-28 02:04:49 UTC (rev 7384)
+++ icecast/trunk/ices0/doc/icesmanual.html 2004-07-28 03:19:14 UTC (rev 7385)
@@ -14,7 +14,8 @@
<ol type=1>
<li> <a href="#features_cue">Cue file </a></li>
<li> <a href="#features_signals">Signal Handling </a></li>
- <li> <a href="#features_reencoding">Reencoding</a></li>
+ <li> <a href="#features_reencoding">Reencoding</a></li>
+ <li> <a href="#features_crossfading">Crossfading</a></li>
<li> <a href="#features_multistream">Multiple streams</a></li>
<li> <a href="#features_playlists">Playlist Handling </a></li>
</ol>
@@ -115,10 +116,6 @@
<br>
The sample rate, number of channels, etc, will be chosen on the fly by
lame itself, unless you specify something using the -H and -N options.
-<br>
-If you want to change it, I suggest you add support for this to ices
-and mail me a patch.
-<br>
I think you should be fine with whatever lame chooses though.
<br>
Also, please make sure that your files are ok before you start
@@ -130,6 +127,22 @@
</p>
</li>
+ <li> <a name="features_crossfading">Crossfading</a>
+ <p>
+If you've compiled with support for reencoding, you can
+crossfade between tracks (blend the end of one into the start
+of the next). This is controlled by the <tt>-C</tt> command line
+option or the <tt>Playlist/Crossfade</tt> parameter in the
+configuration file. Both of these take an integer argument,
+which is the number of seconds to crossfade.
+Songs less than twice the length of the crossfade requested will not
+be faded. This is handy for eg station IDs. <b>NOTE</b>: The
+crossfader doesn't know how to resample, so if you activate this
+feature you should make sure that all your source tracks have the
+same sampling rate.
+ </p>
+ </li>
+
<li> <a name="features_multistream">Multiple streams</a>
<p>
You can feed the same playlist simultaneously to different
@@ -198,6 +211,7 @@
<ul>
<li>-B (Background (daemon mode))</li>
<li>-b <stream bitrate></li>
+ <li>-C <crossfade seconds></li>
<li>-c <configfile></li>
<li>-D <base directory></li>
<li>-d <stream description></li>
@@ -233,34 +247,35 @@
<?xml version="1.0"?>
<ices:Configuration xmlns:ices="http://www.icecast.org/projects/ices">
- <ices:Playlist>
- <ices:File>apan.txt</ices:File>
- <ices:Randomize>1</ices:Randomize>
- <ices:Type>builtin</ices:Type>
- <ices:Module>ices</ices:Module>
- </ices:Playlist>
- <ices:Server>
- <ices:Hostname>localhost</ices:Hostname>
- <ices:Port>8000</ices:Port>
- <ices:Password>letmein</ices:Password>
- <ices:Protocol>xaudiocast</ices:Protocol>
- </ices:Server>
- <ices:Execution>
- <ices:Background>0</ices:Background>
- <ices:Verbose>1</ices:Verbose>
- <ices:Base_Directory>/tmp</ices:Base_Directory>
- </ices:Execution>
- <ices:Stream>
- <ices:Name>Cool ices default name from XML</ices:Name>
- <ices:Genre>Cool ices genre from XML</ices:Genre>
- <ices:Description>Cool ices description from XML</ices:Description>
- <ices:URL>Cool ices URL from XML</ices:URL>
- <ices:Bitrate>128</ices:Bitrate>
- <ices:Public>1</ices:Public>
- <ices:Reencode>0</ices:Reencode>
- <ices:Samplerate>-1</ices:Samplerate>
- <ices:Channels>-1</ices:Channels>
- </ices:Stream>
+ <Playlist>
+ <File>apan.txt</File>
+ <Randomize>1</Randomize>
+ <Type>builtin</Type>
+ <Module>ices</Module>
+ <Crossfade>0;<Crossfade>
+ </Playlist>
+ <Server>
+ <Hostname>localhost</Hostname>
+ <Port>8000</Port>
+ <Password>letmein</Password>
+ <Protocol>xaudiocast</Protocol>
+ </Server>
+ <Execution>
+ <Background>0</Background>
+ <Verbose>1</Verbose>
+ <Base_Directory>/tmp</Base_Directory>
+ </Execution>
+ <Stream>
+ <Name>Cool ices default name from XML</Name>
+ <Genre>Cool ices genre from XML</Genre>
+ <Description>Cool ices description from XML</Description>
+ <URL>Cool ices URL from XML</URL>
+ <Bitrate>128</Bitrate>
+ <Public>1</Public>
+ <Reencode>0</Reencode>
+ <Samplerate>-1</Samplerate>
+ <Channels>-1</Channels>
+ </Stream>
</ices:Configuration>
</pre>
</p>
@@ -422,6 +437,11 @@
Default for python is ices.py and default for perl is ices.pm, although do NOT specify the file extension for the module. Use 'whatever' instead of 'whatever.pm' or 'whatever.py'<br>
</li>
+ <li>Crossfade<br/>
+ Command line option: -C <seconds> <br/>
+ Config file tag: Playlist/Crossfade<br>
+If this option is specified and reencoding is enabled, ices will
+crossfade <tt>seconds</tt> between tracks.
</ul>
</p>
</ol>
@@ -444,10 +464,9 @@
<hr width="10%">
-<p align=right> This document is written by Alexander Haväng [eel at icecast.org].<br>
-<!-- hhmts start -->
-Last modified: Sat Jun 23 18:44:50 EDT 2001
-<!-- hhmts end -->
+<p align=right> This document was mostly written by Alexander Haväng
+ [eel at icecast.org].<br>
+
</p>
</body>
More information about the commits
mailing list