SDL 1 Tutorials - parallelrealities.co.uk

The defs.h file contains a new include, SDL/SDL_mixer.h. SDL is limited to playing WAV files so SDL_mixer allows us to also play music and use other sound types such as OGG. Like SDL_image, it is a very useful addition.

main.h introduces a new structure, Mix_Chunk, which we will use to store the sound that we wish to play.

main.c contains an additional function call, loadSound which is stored in audio.c.

In init.c we initialise SDL's audio system in addition to its video system.

SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO)

Once again, if this call fails then we cannot continue, so we would simply exit the program. Once the system is up and running, we attempt open the audio:

Mix_OpenAudio(22050, AUDIO_S16SYS, 2, 4096)

This call can fail for a valid reason, such as another process locking the audio or the system simply not having a sound card. Best practice would be to set a flag telling the program not to play any audio, but since this tutorial is reliant on it, we would exit if we couldn't play any sounds. The Mix_OpenAudio function takes 4 arguments, the frequency of the audio, the format of the audio, the channels (1 for mono, 2 for stereo) and the chunksize of the audio. 22050 is fairly standard for most games, it can be as high as 44100, which is CD quality, but this uses up a lot of CPU time so we leave it at 22050. AUDIO_S16SYS is standard 16 bit sound, there are other formats but some of them are not portable to other systems. 2 simply tells the audio to be played in stereo rather than mono (1). 4096 is a reasonable chunksize, if the chunksize is too big then there will be a delay between when the sound is told to play and when it actually does play. Conversely, if the chunksize is too small then the sound will stutter because of the constant filling and emptying.
Like SDL_Surfacess, Mix_Chunks must be freed when they are no longer needed. The function call

Mix_FreeChunk(dexterBark);

frees the chunk. The audio system must also be closed at the end of the program. So

Mix_CloseAudio();

is called before SDL_Quit.

input.c now calls the function playSound when Space is pressed. The function is stored in audio.c

graphics.c has not changed.

audio.c contains 2 function calls, loadSound and playSound. The loadSound function loads the audio file

Mix_Chunk *sfx = Mix_LoadWAV(name);

As with IMG_Load, there is no need to specify the file type as SDL_mixer will check the extension of the file. Mix_LoadWAV will return the loaded audio chunk or NULL if it fails.
playSound will play the specified audio file by calling

Mix_PlayChannel(-1, sfx, 0);

The first argument is the channel to play the sound on. You may wish to do this if you wanted to have, say, a person speaking and you wanted to have them interupted. Specifying -1 tells SDL to play the sound on the first free channel that it finds. The second argument is the sound chunk to play and the third argument is the additional number of times to play the sound, so 0 means to play it 0 additional times and 1 means to play it 1 additional time etc. Specifying -1 will loop the sound forever.

Conclusion

Now that we have dealt with opening windows, displaying images and playing sounds, we can start looking at intermediate topics such as input control and collision detection.

Downloads

Source Code


What's New ● Games ● Tutorials ● Features ● About
PC Games • Orb • Lasagne Monsters • Three Guys Apocalypse • Water Closet • Blob Wars : Attrition • The Legend of Edgar • TBFTSS: The Pandoran War • Three Guys • Blob Wars : Blob and Conquer • Blob Wars : Metal Blob Solid • Project: Starfighter • TANX Squadron Android Games • DDDDD • Number Blocks • Match 3 Warriors Tutorials • 2D shoot 'em up • 2D top-down shooter • 2D platform game • Sprite atlas tutorial • Working with TTF fonts • 2D adventure game • Widget tutorial • 2D shoot 'em up sequel • 2D run and gun • Roguelike • Medals (Achievements) • 2D turn-based strategy game • 2D isometric game • 2D map editor • 2D mission-based shoot 'em up • 2D Santa game • 2D split screen game • SDL 1 tutorials (outdated) Latest Updates SDL2 Versus game tutorial Wed, 20th March 2024 Download keys for SDL2 tutorials on itch.io Sat, 16th March 2024 The Legend of Edgar 1.37 Mon, 1st January 2024 SDL2 Santa game tutorial 🎅 Thu, 23rd November 2023 SDL2 Shooter 3 tutorial Wed, 15th February 2023 All Updates » Tags • android (3) • battle-for-the-solar-system (10) • blob-wars (10) • brexit (1) • code (6) • edgar (9) • games (43) • lasagne-monsters (1) • making-of (5) • match3 (1) • numberblocksonline (1) • orb (2) • site (1) • tanx (4) • three-guys (3) • three-guys-apocalypse (3) • tutorials (17) • water-closet (4) Books The Red Road For Joe Crosthwaite, surviving school was about to become more than just a case of passing his exams ... Click here to learn more and read an extract!	Basic Tutorials Basic Game Tutorial #3 - Images and sound Introduction This third tutorial deals with playing sound in SDL. Compile and run tutorial03. By pressing Space, you can play a sound clip. Pressing Escape or closing the window will exit. An in-depth look Two new files are introduced audio.c and audio.h. The defs.h file contains a new include, SDL/SDL_mixer.h. SDL is limited to playing WAV files so SDL_mixer allows us to also play music and use other sound types such as OGG. Like SDL_image, it is a very useful addition. main.h introduces a new structure, Mix_Chunk, which we will use to store the sound that we wish to play. main.c contains an additional function call, loadSound which is stored in audio.c. In init.c we initialise SDL's audio system in addition to its video system. SDL_Init(SDL_INIT_VIDEO\|SDL_INIT_AUDIO) Once again, if this call fails then we cannot continue, so we would simply exit the program. Once the system is up and running, we attempt open the audio: Mix_OpenAudio(22050, AUDIO_S16SYS, 2, 4096) This call can fail for a valid reason, such as another process locking the audio or the system simply not having a sound card. Best practice would be to set a flag telling the program not to play any audio, but since this tutorial is reliant on it, we would exit if we couldn't play any sounds. The Mix_OpenAudio function takes 4 arguments, the frequency of the audio, the format of the audio, the channels (1 for mono, 2 for stereo) and the chunksize of the audio. 22050 is fairly standard for most games, it can be as high as 44100, which is CD quality, but this uses up a lot of CPU time so we leave it at 22050. AUDIO_S16SYS is standard 16 bit sound, there are other formats but some of them are not portable to other systems. 2 simply tells the audio to be played in stereo rather than mono (1). 4096 is a reasonable chunksize, if the chunksize is too big then there will be a delay between when the sound is told to play and when it actually does play. Conversely, if the chunksize is too small then the sound will stutter because of the constant filling and emptying. Like SDL_Surfacess, Mix_Chunks must be freed when they are no longer needed. The function call Mix_FreeChunk(dexterBark); frees the chunk. The audio system must also be closed at the end of the program. So Mix_CloseAudio(); is called before SDL_Quit. input.c now calls the function playSound when Space is pressed. The function is stored in audio.c graphics.c has not changed. audio.c contains 2 function calls, loadSound and playSound. The loadSound function loads the audio file Mix_Chunk *sfx = Mix_LoadWAV(name); As with IMG_Load, there is no need to specify the file type as SDL_mixer will check the extension of the file. Mix_LoadWAV will return the loaded audio chunk or NULL if it fails. playSound will play the specified audio file by calling Mix_PlayChannel(-1, sfx, 0); The first argument is the channel to play the sound on. You may wish to do this if you wanted to have, say, a person speaking and you wanted to have them interupted. Specifying -1 tells SDL to play the sound on the first free channel that it finds. The second argument is the sound chunk to play and the third argument is the additional number of times to play the sound, so 0 means to play it 0 additional times and 1 means to play it 1 additional time etc. Specifying -1 will loop the sound forever. Conclusion Now that we have dealt with opening windows, displaying images and playing sounds, we can start looking at intermediate topics such as input control and collision detection. Downloads Source Code
Copyright © Parallel Realities, 2001 - 2024. All Rights Reserved. Last Updated: 27th March 2024