X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pages%2FSDL-Mixer-Samples.html-inc;h=e71a4529d3b28cf8a79c0542ab280fcd40ac39e2;hb=0b221bb4fce84647a6cb9d7343de7330fb561c71;hp=b1950ec463713b361bfdbddb4d4880d3847e2c03;hpb=05971ac01a9556f7e769cda59ef5b419a60a0aa7;p=sdlgit%2FSDL-Site.git diff --git a/pages/SDL-Mixer-Samples.html-inc b/pages/SDL-Mixer-Samples.html-inc index b1950ec..e71a452 100644 --- a/pages/SDL-Mixer-Samples.html-inc +++ b/pages/SDL-Mixer-Samples.html-inc @@ -4,17 +4,18 @@
Mixer
-char* -mixsam_get_chunk_decoder (idecoder) - int idecoder - CODE: - RETVAL = (char *)Mix_GetChunkDecoder(idecoder); - OUTPUT: - RETVAL
-#endif
- - - - -Mix_Chunk * -mixsam_load_WAV ( filename ) - char *filename - PREINIT: - char * CLASS = "SDL::Mixer::MixChunk"; - CODE: - Mix_Chunk * mixchunk; - mixchunk = Mix_LoadWAV(filename); - RETVAL = mixchunk; - OUTPUT: - RETVAL
- +my $num_decoders = SDL::Mixer::Samples::get_num_chunk_decoders(); ++
Returns the number of available decoders.
+my $decoder = SDL::Mixer::Samples::get_chunk_decoder( $num_decoder ); -+Mix_Chunk * -mixsam_load_WAV_RW ( src, freesrc) - SDL_RWops * src - int freesrc - PREINIT: - char * CLASS = "SDL::Mixer::MixChunk"; - CODE: - Mix_Chunk * mixchunk; - mixchunk = Mix_LoadWAV_RW(src, freesrc); - RETVAL = mixchunk; - OUTPUT: - RETVAL
+
Returns the decoder for the given id.
+my $mix_chunk = SDL::Mixer::Samples::load_WAV( $file ); ++
load_WAV
reads a file and passes it to SDL::Mixer::Samples::load_WAV_RW. SO this is a quick way to load a file into a chunk.
Example:
+my $chunk = SDL::Mixer::Samples::load_WAV('sample.wav'); + SDL::Mixer::Channels::play_channel(-1, $chunk, -1); + SDL::delay(2000); -+Mix_Chunk * -mixsam_quick_load_WAV ( buf ) - Uint8 *buf - PREINIT: - char * CLASS = "SDL::Mixer::MixChunk"; - CODE: - RETVAL = Mix_QuickLoad_WAV(buf); - OUTPUT: - RETVAL
+
my $mix_chunk = SDL::Mixer::Samples::load_WAV_RW( $rwops, $free ); ++
load_WAV_RW
is a macro that loads a sound sample from a a block of memory. It supports WAVE-, MOD-, MIDI-, OGG- and MP3 files (sometimes
+depends on compilation options). It accepts two arguments, the first being a RWops object from which to read and the second being a flag to
+free the source memory after loading is complete or not.
Returns a Mix_Chunk containing the whole sample on success, or undef
on error.
Note: Do not reuse the RWops-object for another call to this function!
+Example:
+my $rwops = SDL::RWOps->new_file('sample.wav', 'r'); + my $chunk = SDL::Mixer::Samples::load_WAV_RW($rwops, 0); -+Mix_Chunk * -mixsam_quick_load_RAW ( buf , len) - Uint8 *buf - int len - PREINIT: - char * CLASS = "SDL::Mixer::MixChunk"; - CODE: - RETVAL = Mix_QuickLoad_RAW( buf, len ); - OUTPUT: - RETVAL
+ SDL::Mixer::Channels::play_channel(-1, $chunk, -1); + SDL::delay(2000); +
SDL::Mixer::Samples::quick_load_WAV( $buf ); ++
to be documented.
-int -mixsam_volume_chunk ( chunk, volume ) - Mix_Chunk *chunk - int volume - CODE: - RETVAL = Mix_VolumeChunk(chunk,volume); - OUTPUT: - RETVAL
+SDL::Mixer::Samples::quick_load_RAW( $buf, $len ); ++
to be documented.
+my $volume_before = SDL::Mixer::Samples::volume_chunk( $chunk, $new_volume ); ++
volume_chunk
let you set and get the volume of a chunk. When a chunk is created is volume is MIX_MAX_VOLUME
(128
).
If you pass -1
as $new_volume
you just get its volume without changing it.
void -mixsam_free_chunk( chunk ) - Mix_Chunk *chunk - CODE: - Mix_FreeChunk(chunk);
+See AUTHORS in SDL.