pods::...Groups(3pm)

💖 NAME 💖

okay so bestie, welcome to the pods::...Groups(3pm) page from User Contributed Perl Documentation 💅 it's literally all about 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 );

The page says "group_newer" returns the first available channel of this group. 👀

🎀 group_count

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

The page says "group_newer" returns the number of channels in this group. 💀

🎀 group_oldest

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

The page says "group_newer" returns the channel number which started to play at first. ⭐

🎀 group_newer

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

The page says "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. 💖

---

byeee 🫶 this page is from perl v5.42.0, dated 2024-05-01, and it's pods::...Groups(3pm) — periodt 💅✨