Index


NAME

Top

SDL::AudioCVT -- Audio Conversion Structure

CATEGORY

Top

Core, Audio, Structure

SYNOPSIS

Top

DESCRIPTION

Top

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.

METHODS

Top

new

This constructor returns an empty SDL::AudioCVT structure.

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.

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.

needed

Set to one if the conversion is possible

src_format

Audio format of the source

dest_format

Audio format of the destination

rate_incr

Rate conversion increment

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)

len_ratio

Final audio size is len*len_ratio

AUTHOR

Top

Tobias Leich