pods::...udioCVT(3pm)

🌸 NAME 🌸

okay so this is the pods::...udioCVT(3pm) page from the User Contributed Perl Documentation, and the actual star is SDL::AudioCVT — Audio Conversion Structure. That's the whole name, and honestly it ate 💅

---

🦋 CATEGORY 🦋

Core, Audio, Structure — lowkey the triple threat ✨

---

✨ SYNOPSIS ✨

No synopsis lines here, bestie — the original is just the heading and then absolute silence, which is a mood 😭 moving on!

---

💖 DESCRIPTION 💖

okay so SDL::AudioCVT is the structure used to convert audio data between different formats. A SDL::AudioCVT structure is created with the SDL::AudioCVT->build function, while the actual conversion is done by the SDL::Audio::convert_audio function — no cap, that's the whole setup 🫶

---

🎀 METHODS 🎀

💖 new 💖

This constructor returns an empty SDL::AudioCVT structure — a fresh little blank slate, periodt ✨

🦋 build 🦋

$cvt = SDL::AudioCVT->build( $src_format, $src_channels, $src_rate
                            $dst_format, $dst_channels, $dst_rate );

Before an SDL::AudioCVT structure can be used to convert audio data, it must be initialized with source and destination information — no skipping steps, bestie 💅

src_format and dst_format are the source and destination format of the conversion. (For information on audio formats, see SDL::AudioSpec.) 🎀

src_channels and dst_channels are the number of channels in the source and destination formats. 🌸

Finally, src_rate and dst_rate are the frequency or samples-per-second of the source and destination formats. Once again, see SDL::AudioSpec — it's giving "check the spec, iykyk" 💜

Currently (SDL-1.2.11) only rate conversions of 2x and (1/2)x with x > 0 are done, nearing the requested rate conversion. That's the note — don't @ me 💀

See SDL::Audio::convert_audio.

🎀 needed 🎀

Set to one if the conversion is possible — that's the "can we do this?" flag ✅

🎀 src_format 🎀

Audio format of the source — where the audio is coming from, basically 🦋

🎀 dest_format 🎀

Audio format of the destination — where it's going, bestie 🌈

🎀 rate_incr 🎀

Rate conversion increment — yes, that's the whole line, short and slay 💅

🎀 len 🎀

Length of the original audio buffer in bytes 📏

🎀 len_cvt 🎀

Length of converted audio buffer in bytes (calculated) ✨

🎀 len_mult 🎀

buf must be len*len_mult bytes in size (calculated) — size your buf accordingly, no cap 🫶

🎀 len_ratio 🎀

Final audio size is len*len_ratio 🔥

---

👑 AUTHORS 👑

See AUTHORS in SDL.

---

That's the page, bestie 💖✨ — brought to you by perl v5.42.3, dated 2026-08-19. mwah 💋