test includes
[sdlgit/SDL-Site.git] / pages / SDL-Mixer.html-inc
diff --git a/pages/SDL-Mixer.html-inc b/pages/SDL-Mixer.html-inc
new file mode 100644 (file)
index 0000000..70e4cd4
--- /dev/null
@@ -0,0 +1,282 @@
+<div class="pod">
+<!-- INDEX START -->
+<h3 id="TOP">Index</h3>
+
+<ul><li><a href="#NAME">NAME</a></li>
+<li><a href="#SYNOPSIS">SYNOPSIS</a></li>
+<li><a href="#DESCRIPTION">DESCRIPTION</a></li>
+<li><a href="#METHODS">METHODS</a>
+<ul><li><a href="#new">new()</a></li>
+<li><a href="#query_spec">query_spec()</a></li>
+<li><a href="#reserve_channels">reserve_channels</a></li>
+<li><a href="#allocate_channels">allocate_channels()</a></li>
+<li><a href="#group_channel_channel_group">group_channel(channel,group)</a></li>
+<li><a href="#group_channels_from_to_group">group_channels(from,to,group)</a></li>
+<li><a href="#group_available_group">group_available(group)</a></li>
+<li><a href="#group_count_group">group_count(group)</a></li>
+<li><a href="#group_oldest">group_oldest()</a></li>
+<li><a href="#group_newer">group_newer()</a></li>
+<li><a href="#play_channel">play_channel()</a></li>
+<li><a href="#play_music">play_music()</a></li>
+<li><a href="#fade_in_channel_channel_chunk_loops_">fade_in_channel(channel,chunk,loops,ms,ticks)</a></li>
+<li><a href="#fade_in_music_music_loops_ms">fade_in_music(music,loops,ms)</a></li>
+<li><a href="#channel_volume_channel_volume">channel_volume(channel,volume)</a></li>
+<li><a href="#mucis_volume_volume">mucis_volume(volume)</a></li>
+<li><a href="#halt_channel_channel">halt_channel(channel)</a></li>
+<li><a href="#halt_group_group">halt_group(group)</a></li>
+<li><a href="#halt_music">halt_music()</a></li>
+<li><a href="#channel_expire_channel_ticks">channel_expire(channel,ticks)</a></li>
+<li><a href="#fade_out_channel_channel_ms">fade_out_channel(channel,ms)</a></li>
+<li><a href="#fade_out_group_group_ms">fade_out_group(group,ms)</a></li>
+<li><a href="#fade_out_music_ms">fade_out_music(ms)</a></li>
+<li><a href="#fading_music">fading_music()</a></li>
+<li><a href="#fading_channel">fading_channel()</a></li>
+<li><a href="#pause_channel">pause( channel )</a></li>
+<li><a href="#resume_channel">resume(channel)</a></li>
+<li><a href="#paused">paused()</a></li>
+<li><a href="#pause_music">pause_music()</a></li>
+<li><a href="#resume_music">resume_music()</a></li>
+<li><a href="#rewind_music">rewind_music()</a></li>
+<li><a href="#music_paused">music_paused()</a></li>
+<li><a href="#playing">playing()</a></li>
+<li><a href="#playing_music">playing_music ()</a></li>
+</ul>
+</li>
+<li><a href="#set_panning_channel_left_right">set_panning($channel, $left, $right)</a>
+</li>
+</ul><hr />
+<!-- INDEX END -->
+
+<h1 id="NAME">NAME</h1><p><a href="#TOP" class="toplink">Top</a></p>
+<div id="NAME_CONTENT">
+<p>SDL::Mixer - a SDL perl extension</p>
+
+</div>
+<h1 id="SYNOPSIS">SYNOPSIS</h1><p><a href="#TOP" class="toplink">Top</a></p>
+<div id="SYNOPSIS_CONTENT">
+<pre>  $mixer = new SDL::Mixer         -frequency =&gt; MIX_DEFAULT_FREQUENCY,
+                               -format =&gt; MIX_DEFAULT_FORMAT,
+                               -channels =&gt; MIX_DEFAULT_CHANNELS,
+                               -size =&gt; 4096;
+
+</pre>
+
+</div>
+<h1 id="DESCRIPTION">DESCRIPTION</h1><p><a href="#TOP" class="toplink">Top</a></p>
+<div id="DESCRIPTION_CONTENT">
+<p>SDL::Mixer allows you access to the SDL mixer library, enablig sound and
+music volume setting, playing, pausing and resuming, as well as fading
+the sound and music in and out.</p>
+
+</div>
+<h1 id="METHODS">METHODS</h1><p><a href="#TOP" class="toplink">Top</a></p>
+<div id="METHODS_CONTENT">
+
+</div>
+<h2 id="new">new()</h2>
+<div id="new_CONTENT">
+<pre>  $mixer = SDL::Mixer-&gt;new(    -frequency =&gt; MIX_DEFAULT_FREQUENCY,
+                                       -format    =&gt; MIX_DEFAULT_FORMAT,
+                                       -channels  =&gt; MIX_DEFAULT_CHANNELS,
+                                       -size      =&gt; 4096);
+
+</pre>
+<p>Creates a new SDL::Mixer object. <code>$size</code> is the buffer size in bytes.</p>
+
+</div>
+<h2 id="query_spec">query_spec()</h2>
+<div id="query_spec_CONTENT">
+<pre>  my $specs = SDL::Mixer::query_spec();
+
+</pre>
+<p>Returns a hash reference, containing the following keys and their respective
+values:</p>
+<pre>  -status
+       -frequency
+       -channels
+       -format
+
+</pre>
+
+</div>
+<h2 id="reserve_channels">reserve_channels</h2>
+<div id="reserve_channels_CONTENT">
+<pre>  $mixer-&gt;reserve_channels(4);
+
+</pre>
+<p>Reserve so many channels.</p>
+
+</div>
+<h2 id="allocate_channels">allocate_channels()</h2>
+<div id="allocate_channels_CONTENT">
+<pre>  $mixer-&gt;reserve_channels(2);
+
+</pre>
+<p>Allocate so many channels.</p>
+
+</div>
+<h2 id="group_channel_channel_group">group_channel(channel,group)</h2>
+<div id="group_channel_channel_group_CONTENT">
+<p>Group the channel number <code>$channel</code> into group <code>$group</code>.</p>
+
+</div>
+<h2 id="group_channels_from_to_group">group_channels(from,to,group)</h2>
+<div id="group_channels_from_to_group_CONTENT">
+<p>Groups a range of channels</p>
+
+</div>
+<h2 id="group_available_group">group_available(group)</h2>
+<div id="group_available_group_CONTENT">
+<p>Return true when the group is available.</p>
+
+</div>
+<h2 id="group_count_group">group_count(group)</h2>
+<div id="group_count_group_CONTENT">
+<p>Returns the number of channels in the group</p>
+
+</div>
+<h2 id="group_oldest">group_oldest()</h2>
+<div id="group_oldest_CONTENT">
+
+
+
+
+
+</div>
+<h2 id="group_newer">group_newer()</h2>
+<div id="group_newer_CONTENT">
+
+
+
+
+
+</div>
+<h2 id="play_channel">play_channel()</h2>
+<div id="play_channel_CONTENT">
+
+
+
+
+
+</div>
+<h2 id="play_music">play_music()</h2>
+<div id="play_music_CONTENT">
+<p>Play <code>$music</code> <code>$loop</code> times.</p>
+
+</div>
+<h2 id="fade_in_channel_channel_chunk_loops_">fade_in_channel(channel,chunk,loops,ms,ticks)</h2>
+<div id="fade_in_channel_channel_chunk_loops_-2">
+<p>Fades a channel in</p>
+
+</div>
+<h2 id="fade_in_music_music_loops_ms">fade_in_music(music,loops,ms)</h2>
+<div id="fade_in_music_music_loops_ms_CONTENT">
+<p>Fades the music in over a number of ms, looping as it does</p>
+
+</div>
+<h2 id="channel_volume_channel_volume">channel_volume(channel,volume)</h2>
+<div id="channel_volume_channel_volume_CONTEN">
+<p>Sets the volume for a single channel</p>
+
+</div>
+<h2 id="mucis_volume_volume">mucis_volume(volume)</h2>
+<div id="mucis_volume_volume_CONTENT">
+<p>Set the volume for the music.</p>
+
+</div>
+<h2 id="halt_channel_channel">halt_channel(channel)</h2>
+<div id="halt_channel_channel_CONTENT">
+<p>Stops a specific channel</p>
+
+</div>
+<h2 id="halt_group_group">halt_group(group)</h2>
+<div id="halt_group_group_CONTENT">
+<p>Stops a group of channels</p>
+
+</div>
+<h2 id="halt_music">halt_music()</h2>
+<div id="halt_music_CONTENT">
+<p>Stops the music</p>
+
+</div>
+<h2 id="channel_expire_channel_ticks">channel_expire(channel,ticks)</h2>
+<div id="channel_expire_channel_ticks_CONTENT">
+<p>Ignores the channel after <code>ticks</code> has expired</p>
+
+</div>
+<h2 id="fade_out_channel_channel_ms">fade_out_channel(channel,ms)</h2>
+<div id="fade_out_channel_channel_ms_CONTENT">
+<p>Fade the channel number <code>$channel</code> in <code>$ms</code> ms out.</p>
+
+</div>
+<h2 id="fade_out_group_group_ms">fade_out_group(group,ms)</h2>
+<div id="fade_out_group_group_ms_CONTENT">
+<p>Fade the channel group <code>$group</code> in <code>$ms</code> ms out.</p>
+
+</div>
+<h2 id="fade_out_music_ms">fade_out_music(ms)</h2>
+<div id="fade_out_music_ms_CONTENT">
+<p>Fade the music in <code>$ms</code> ms out.</p>
+
+</div>
+<h2 id="fading_music">fading_music()</h2>
+<div id="fading_music_CONTENT">
+<p>Return true when the music is currently fading in or out.</p>
+
+</div>
+<h2 id="fading_channel">fading_channel()</h2>
+<div id="fading_channel_CONTENT">
+<p>Return true when the channel number <code>$channel</code> is currently fading in or out.</p>
+
+</div>
+<h2 id="pause_channel">pause( channel )</h2>
+<div id="pause_channel_CONTENT">
+<p>Pause the channel <code>$channel</code>.</p>
+
+</div>
+<h2 id="resume_channel">resume(channel)</h2>
+<div id="resume_channel_CONTENT">
+<p>Resume the channel <code>$channel</code>.</p>
+
+</div>
+<h2 id="paused">paused()</h2>
+<div id="paused_CONTENT">
+<p>Return true when the channel is currently paused.</p>
+
+</div>
+<h2 id="pause_music">pause_music()</h2>
+<div id="pause_music_CONTENT">
+<p>Pause the music play.</p>
+
+</div>
+<h2 id="resume_music">resume_music()</h2>
+<div id="resume_music_CONTENT">
+<p>Resume the music play.</p>
+
+</div>
+<h2 id="rewind_music">rewind_music()</h2>
+<div id="rewind_music_CONTENT">
+<p>Resets the music file to the beginning</p>
+
+</div>
+<h2 id="music_paused">music_paused()</h2>
+<div id="music_paused_CONTENT">
+<p>Return true when the music is currently paused.</p>
+
+</div>
+<h2 id="playing">playing()</h2>
+<div id="playing_CONTENT">
+<p>Return true when the channel is currently playing.</p>
+
+</div>
+<h2 id="playing_music">playing_music ()</h2>
+<div id="playing_music_CONTENT">
+<p>Return true when the music is currently playing.</p>
+
+</div>
+<h1 id="set_panning_channel_left_right">set_panning($channel, $left, $right)</h1><p><a href="#TOP" class="toplink">Top</a></p>
+<div id="set_panning_channel_left_right_CONTE">
+<p>Sets the volume for the left or right channels. To do true panning:</p>
+
+</div>
+</div>
\ No newline at end of file