pods::...udioCVT(3pm)

📦 version 2.548, in opensuse-leap 16.0

pods::...udioCVT(3pm) · User Contributed Perl Documentation

🎀 NAME 🎀

SDL::AudioCVT -- Audio Conversion Structure. That's the whole name, bestie. 💖

🏷️ CATEGORY 🏷️

Core, Audio, Structure — yes, it's giving core audio structure realness. ✨

🫥 SYNOPSIS 🫥

This section is literally empty in the original page — no synopsis lines, no code, just a cute little blank space. 🎀

💬 DESCRIPTION 💬

Okay so SDL::AudioCVT is the structure you use to convert audio data between different formats. It's not the converter itself — it's the little info packet that tells the conversion what's up. 🦋

You create a SDL::AudioCVT structure with the SDL::AudioCVT->build function, and then the actual conversion is done by the SDL::Audio::convert_audio function. Teamwork, fr fr — iykyk. 💅

🌸 METHODS 🌸

💅 new

This constructor returns an empty SDL::AudioCVT structure. Fresh out the box, no settings, just potential. ✨

🛠️ build

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

Before a SDL::AudioCVT structure can be used to convert audio data, it must be initialized with source and destination information. No initialization? No conversion. Periodt. 💀

  • src_format and dst_format — the source and destination format of the conversion. For info on audio formats, see SDL::AudioSpec. 👀
  • src_channels and dst_channels — the number of channels in the source and destination formats. Channel count matters, bestie. 🎚️
  • src_rate and dst_rate — the frequency or samples-per-second of the source and destination formats. Once again, see SDL::AudioSpec. 🎵
⚠️ Caveat time: currently (SDL-1.2.11) only rate conversions of 2x and (1/2)x with x > 0 are done, nearing the requested rate conversion. So it's not out here doing every rate under the sun — set your expectations accordingly. 🌈

See SDL::Audio::convert_audio. 🫶

🧮 needed

Set to one if the conversion is possible. That's it — one little flag, big main character energy. 👑

🎚️ src_format

Audio format of the source. Easy. 💖

🎯 dest_format

Audio format of the destination. Also easy. ✨

📈 rate_incr

Rate conversion increment. Increment-y. 📊

📏 len

Length of the original audio buffer in bytes. Byte count, no cap. 🧮

🔁 len_cvt

Length of converted audio buffer in bytes (calculated). The math is mathing. 🧠

🧺 len_mult

buf must be len*len_mult bytes in size (calculated). Important sizing tea right here. 🫖

🪞 len_ratio

Final audio size is len*len_ratio. That's the ratio, bestie. 💅

👑 AUTHORS 👑

See "AUTHORS" in SDL. That's where the credit lives. 🫶

That's the whole page, bestie! 💖 This gem is from perl v5.42.0, dated 2024-05-01, and filed under pods::...udioCVT(3pm) — mwah! 💋✨

📦 where this page comes from