Updated Articles

[sdlgit/SDL-Site.git] / pages / SDL-Mixer-Channels.html-inc

diff --git a/pages/SDL-Mixer-Channels.html-inc b/pages/SDL-Mixer-Channels.html-inc
index f254f2d..c68613b 100644 (file)
--- a/pages/SDL-Mixer-Channels.html-inc
+++ b/pages/SDL-Mixer-Channels.html-inc
@@ -21,10 +21,11 @@
 <li><a href="#playing">playing</a></li>
 <li><a href="#paused">paused</a></li>
 <li><a href="#fading_channel">fading_channel</a></li>
-<li><a href="#get_chunk">get_chunk</a>
-</li>
+<li><a href="#get_chunk">get_chunk</a></li>
 </ul>
 </li>
+<li><a href="#AUTHORS">AUTHORS</a>
+</li>
 </ul><hr />
 <!-- INDEX END -->
 
@@ -167,7 +168,27 @@ current volume. </p>
 </div>
 <h2 id="channel_finished">channel_finished</h2>
 <div id="channel_finished_CONTENT">
-<p>TODO</p>
+<pre> SDL::Mixer::Channels::channel_finished( $callback );
+
+</pre>
+<p>Add your own callback when a channel has finished playing. <code>NULL</code> to disable callback. The callback may be called from the mixer's audio 
+callback or it could be called as a result of <a href="http://search.cpan.org/perldoc?halt_channel">halt_channel</a>, etc. do not call <code>lock_audio</code> from this callback; you will either be inside 
+the audio callback, or SDL_mixer will explicitly lock the audio before calling your callback.</p>
+<p>Example 1:</p>
+<pre> my $callback = sub{ printf(&quot;[channel_finished] callback called for channel %d\n&quot;, shift); };
+
+ SDL::Mixer::Channels::channel_finished( $callback );
+
+</pre>
+<p>Example 2:</p>
+<pre> sub callback
+ {
+     ...
+ }
+
+ SDL::Mixer::Channels::channel_finished( \&amp;callback );
+
+</pre>
 
 </div>
 <h2 id="playing">playing</h2>
@@ -212,4 +233,9 @@ current volume. </p>
 <p><strong>Note</strong>: Never pass <code>-1</code> to this function!</p>
 
 </div>
+<h1 id="AUTHORS">AUTHORS</h1><p><a href="#TOP" class="toplink">Top</a></p>
+<div id="AUTHORS_CONTENT">
+<p>See <a href="/SDL.html#AUTHORS">/SDL.html#AUTHORS</a>.</p>
+
+</div>
 </div>
\ No newline at end of file