SDL::AudioCVT

Section: User Contributed Perl Documentation (3)
Updated: 2019-07-26
Page Index
 

NAME

SDL::AudioCVT -- Audio Conversion Structure  

CATEGORY

Core, Audio, Structure  

SYNOPSIS

 

DESCRIPTION

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

 

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"  

AUTHORS

See ``AUTHORS'' in SDL.


 

Index

NAME
CATEGORY
SYNOPSIS
DESCRIPTION
METHODS
new
build
needed
src_format
dest_format
rate_incr
len
len_cvt
len_mult
len_ratio
AUTHORS
LinuxReviews : manual page archive : man3pm