|
Size: 2990
Comment: update content - pointers, structs
|
Size: 2990
Comment: minor change
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 35: | Line 35: |
| <<Color2(purple,If audio format conversion is not supported this function returns -1.)>> |
|
| Line 47: | Line 49: |
| <<Color2(purple,If audio format conversion is not supported this function returns -1.)>> |
DRAFT |
SDL_BuildAudioCVT
Use this function to initialize an SDL_AudioCVT structure for conversion.
Contents
Syntax
int SDL_BuildAudioCVT(SDL_AudioCVT* cvt,
SDL_AudioFormat src_format,
Uint8 src_channels,
int src_rate,
SDL_AudioFormat dst_format,
Uint8 dst_channels,
int dst_rate)
Function Parameters
cvt |
an SDL_AudioCVT structure that is filled in with audio conversion information |
src_format |
the source format of the audio data; for more info see SDL_AudioFormat |
src_channels |
the number of channels in the source |
src_rate |
the frequency or samples-per-second of the source |
dst_format |
the destination format of the audio data; for more info see SDL_AudioFormat |
dst_channels |
the number of channels in the destination |
dst_rate |
the frequency or samples-per-second of the destination |
green
Return Value
Returns 1 if the audio filter is set up, 0 if there is no conversion needed, or a negative error code on failure; call SDL_GetError() for more information.
purple
Code Examples
You can add your code example here
Remarks
Before an SDL_AudioCVT structure can be used to convert audio data it must be initialized with source and destination information.
For information on audio formats see SDL_AudioSpec.
*
Currently only rate conversions of 2x and (1/2)x with x > 0 are done, nearing whichever most closely approximates the requested rate conversion.
*
green
You can call [[some function]]() to fill in an [[SDL_AudioCVT]] structure with the remaining information about the current audio converter. This structure will have the `needed` member/mask set to 1 if conversion is possible.
