SDL Wii/tutorial

From WiiBrew
< SDL Wii
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


First of all I want to thank everybody who made it possible to work with SDL on the Wii. I personally think SDL is one of the best libraries to begin with and that's why I want to write a simple tutorial. As is written on the main page of the SDL page, SDL is currently incomplete. If you try other things than written in this tutorial you may find bugs.

This tutorial is written by GabberNL. If you want to contact me, go to my talk page.


You have to download the latest version of the Wii SDL librarie in the SDL Wii SVN. The normal SDL Wii and the SDL Wii Dependencies. After that:

  • Copy all of the header files $DEVKITPRO/libogc/include/SDL/
  • Copy all of the *.a files to $DEVKITPRO/libogc/lib/wii/

You have to put the libs in the right order in your makefile:

LIBS := -lSDL_ttf -lSDL_gfx -lSDL_mixer -lSDL_image -lfreetype -ljpeg -lpng -lz -lSDL -lfat -lwiiuse -lbte -logc -lm

Lesson 1: Making a red background

// normal includes
#include <stdlib.h>
#include <time.h>
#include <gccore.h>
#include <wiiuse/wpad.h> 

// SDL includes
#include <SDL/sdl.h>
#include <SDL/sdl_image.h>

// screen surface, the place where everything will get print onto
SDL_Surface *screen = NULL;

void init(){
    // initialize SDL video. If there was an error SDL shows it on the screen
    if ( SDL_Init( SDL_INIT_VIDEO | SDL_INIT_AUDIO) < 0 )
        fprintf(stderr, "Unable to init SDL: %s\n", SDL_GetError() );
		SDL_Delay( 5000 );
    // button initialization
    // make sure SDL cleans up before exit
    // create a new window
    screen = SDL_SetVideoMode(640, 480, 16, SDL_DOUBLEBUF);
    if ( !screen )
        fprintf(stderr, "Unable to set video: %s\n", SDL_GetError());
		SDL_Delay( 5000 );

void apply_surface ( int x, int y, SDL_Surface* source, SDL_Surface* destination ){
     // make a temporary rectangle to hold the offsets
     SDL_Rect offset;
     // give the offsets to the rectangle
     offset.x = x;
     offset.y = y;
     // blit the surface
     SDL_BlitSurface( source, NULL, destination, &offset );

void cleanup(){
     // we have to quit SDL

int main(int argc, char** argv){
	// main function. Always starts first
	// to stop the while loop
	bool done = false;
	// start init() function
	// this will make the red background
	// the first argument says it must be placed on the screen
	// the third argument gives the color in RGB format. You can change it if you want
	SDL_FillRect(screen, 0, SDL_MapRGB(screen->format, 255, 0, 0));
	// this is the endless while loop until someone presses the home button on the wiimote
	while (!done)
		// scans if a button was pressed
		u32 held = WPAD_ButtonsHeld(0);
		// if the homebutton is pressed it will set done = true and it will fill the screen
		// with a black background
		if(held & WPAD_BUTTON_HOME){
			SDL_FillRect(screen, 0, SDL_MapRGB(screen->format, 0, 0, 0));
		// SDL_Flip refreshes the screen so it will show the updated screen
	// start cleanup() function
    return 0;

Lesson 2: Showing a image as a background

I'll make lesson 2 a.s.a.p.

P.S. Because I'm dutch my english may be not so good. Feel free to correct my english.