pods::SDL::AudioCVT(3pm) User Contributed Perl Documentation pods::SDL::AudioCVT(3pm)

SDL::AudioCVT -- Audio Conversion Structure

Core, Audio, Structure

The "SDL::AudioCVT" is 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.

This constructor returns an empty "SDL::AudioCVT" structure.

 $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.

"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".

Currently (SDL-1.2.11) only rate conversions of 2x and (1/2)x with x > 0 are done, nearing the requested rate conversion.

See "SDL::Audio::convert_audio".

Set to one if the conversion is possible

Audio format of the source

Audio format of the destination

Rate conversion increment

Length of the original audio buffer in bytes

Length of converted audio buffer in bytes (calculated)

"buf" must be "len*len_mult" bytes in size (calculated)

Final audio size is "len*len_ratio"

See "AUTHORS" in SDL.

2024-03-31 perl v5.38.2