SDL::Mixer::Groups

Section: User Contributed Perl Documentation (3)
Updated: 2020-01-30
Page Index
 

NAME

SDL::Mixer::Groups - Audio channel group functions  

CATEGORY

Mixer  

METHODS

 

reserve_channels

 my $reserved = SDL::Mixer::Groups::reserve_channels( $num );

$num is the number of channels to reserve from default mixing. Zero removes all reservations.

Reserve $num channels from being used when playing samples when passing in "-1" as a channel number to playback functions. The channels are reserved starting from channel 0 to "$num-1". Passing in zero will unreserve all channels. Normally SDL_mixer starts without any channels reserved.

The following functions are affected by this setting:

SDL::Mixer::Channels::play_channel
SDL::Mixer::Channels::play_channel_timed
SDL::Mixer::Channels::fade_in_channel
SDL::Mixer::Channels::fade_in_channel_timed

Returns: The number of channels reserved. Never fails, but may return less channels than you ask for, depending on the number of channels previously allocated (see SDL::Mixer::Channels::allocate_channels).  

group_channel

 my $grouped = SDL::Mixer::Groups::group_channel( $channel, $group );

Add a channel to group id (any positive integer), or reset it's group to the default group by passing (-1).

Returns: True(1) on success. False(0) is returned when the channel specified is invalid.  

group_channels

 my $grouped = SDL::Mixer::Groups::group_channels( $from_channel, $to_channel, $group );

Add a range of channels to group id (any positive integer), or reset their group to the default group by passing (-1).

Returns: The number of affected channels.  

group_available

 my $channel = SDL::Mixer::Groups::group_count( $group );

"group_newer" returns the first available channel of this group.  

group_count

 my $channels = SDL::Mixer::Groups::group_count( $group );

"group_newer" returns the number of channels in this group.  

group_oldest

 my $channel = SDL::Mixer::Groups::group_oldest( $group );

"group_newer" returns the channel number which started to play at first.  

group_newer

 my $channel = SDL::Mixer::Groups::group_newer( $group );

"group_newer" returns the channel number which started to play at last.  

fade_out_group

 SDL::Mixer::Groups::fade_out_group( $group, $ms );

Fades out the channels by the given group id. The fade-out-time is specified by $ms.

Returns the number of affected channels.  

halt_group

 SDL::Mixer::Groups::hals_group( $group );

Halts the channels by the given group id.

Returns 0.  

AUTHORS

See ``AUTHORS'' in SDL.


 

Index

NAME
CATEGORY
METHODS
reserve_channels
group_channel
group_channels
group_available
group_count
group_oldest
group_newer
fade_out_group
halt_group
AUTHORS
LinuxReviews : manual page archive : man3pm