Neste primeiro tutorial sobre SDL publicado originalmente no site lazyfoo, iremos configurar a biblioteca e criar nossa primeira janela.

SDL é um biblioteca de ligação dinâmica; dessa forma ela possui três partes:

• Os arquivos de cabeçalho (*.h)
• Os arquivos da biblioteca (*.lib no Windows ou lib*.a nos *nix)
• Os arquivos binários (*.dll no Windows ou *.so nos *nix)

Seu compilador precisa ser capaz de encontrar os arquivos de cabeçalho ao compilar seu código para saber do que se trata SDL_Init() e outras funções e outras estruturas do SDL. Você pode tanto configurar seu compilador para procurar em um diretório adicional por esses arquivos, ou por esses arquivos no mesmo local dos outros arquivos de cabeçalho que seu compilador usa. Se o seu compilador reclamar que não consegue encontrar SDL.h, isso significa que os arquivos de cabeçalhos não estão em um local que o compilador possa acha-los.
Depois que o seu compilador compila todos o seu código, precisa liga-los todos juntos. Para que isso seja feito de forma adequada, precisam ser conhecidos os endereços de todas as funções, incluindo as do SDL. Para uma biblioteca de ligação dinâmica, esses endereços estão em um arquivo de biblioteca. Esse arquivo possui uma Import Address Table (Tabela de endereços para importação) de forma que seu programa possa importar essas funções durante a execução. Da mesma forma que com os arquivos de cabeçalho, você pode tanto configurar seu compilador para procurar as bibliotecas em um diretório específico ou por os arquivos junto com o restante dos arquivos de biblioteca que acompanham seu compilador. Você também precisa informar ao linker para fazer a ligação com o arquivo de biblioteca durante esse processo. Se o linker reclamar que não pode encontrar -lSDL ou SDL2.lib, isso significa que os arquivos não estão em um local que possam ser encontrados. Se o linker reclamar de uma referência não definida (undefined reference), isso significa que você não informou a ele para usar a ligação com a biblioteca.
Depois que seu programa é compilado e as ligações com as bibliotecas foram definidas, você precisa ser capaz de efetuar a ligação com as bibliotecas quando executa a aplicação. Para poder rodar um aplicação com ligações dinâmicas, você precisa ser capaz de importar os arquivos binários da biblioteca durante a execução. Seu sistema operacional precisa ser capaz de encontrar os arquivos binários ao executar seu programa. Você tanto pode por esses arquivos no mesmo diretório de seu executável, quando por eles em um diretório utilizado pelo sistema operacional para armazenar esses arquivos.

Windows

Uma observação importante para desenvolvedores Windows:
Como parte do processo de configuração, você irá ter que colocar os arquivos DLL em algum local que esteja acessível ao seu programa durante a execução. Você pode tanto por o arquivo no mesmo diretório de seu executável, quanto por o arquivo no diretório C:\WINDOWS\SYSTEM32 para sistemas de 32 bits ou no diretório C:\WINDOWS\SysWOW64 para sistemas 64 bits de aplicações 32 bits.
As vantagens de por o arquivo DLL no diretório do sistema são:

1. Seu sistema operacional sempre será capaz de encontrar a biblioteca em seu sistema, de forma que você poderá compilar e executar aplicações com ligações dinâmicas em qualquer lugar
2. Você não precisará incluir uma cópia do arquivo DLL com cada aplicação que você desenvolver

Tendo isso em mente, ao distribuir sua aplicação você nunca deve mexer com o diretório SYSTEM do usuário. Ele poderia ter aplicações que precisem da versão ABC do SDL em seu diretório SYSTEM e você sobrescrever ela com a versão XYZ. Sua distribuição deve por as arquivos DLL no mesmo diretório de seu executável.

Abra o arquivo gzip e dentro dele você verá um arquivo tar. Abra o arquivo tar e você verá um diretório com o nome SDL2-2.something.something. Dentro desse diretporio deve haver um punhado de arquivos e diretórios, sendo os mais importantes i686-w64-mingw32 que contém a versão 32 bits da biblioteca e x86_64-w64-mingw32 que contém a versão 64 bits da biblioteca.
Isso é importante: A maioria dos compiladores ainda gera binários de 32 bits para maximizar a compatibilidade. Usaremos os binários de 32 bits nesse tutorial. Não importa se você possuir um sistema operacional de 64 bits, já que criaremos arquivos binários de 32 bits iremos usar a biblioteca de 32 bits.
Dentro desse diretório estarão diretórios include, lib e bin que contém tudo que você precisa para compilar e executar aplicações SDL. Copie cada um desses diretórios para o local que você quiser. Eu recomendo por esses diretórios no local onde você instalou as bibliotecas de desenvolvimento do MinGW.
2) Em seguida iremos configurar o caminho para o MinGW de forma que possamos executar comandos dele em qualquer diretório. Abra o menu sistema seja por A) clique com o botão direito em Meu Computador e selecionando Propriedades ou B) indo ao Painel de controle e selecionando o menu sistema. Quando tiver feito isso, clique no link Configurações avançadas do sistema.

g++ 01_hello_SDL.cpp -IC:\mingw_dev_lib\include\SDL2 -LC:\mingw_dev_lib\lib -w -Wl,-subsystem,windows -lmingw32 -lSDL2main -lSDL2 -o 01_hello_SDL

#OBJS specifies which files to compile as part of the project
OBJS = 01_hello_SDL.cpp
#OBJ_NAME specifies the name of our exectuable
OBJ_NAME = 01_hello_SDL
#This is the target that compiles our executable
all : $(OBJS)
   g++ $(OBJS) -IC:\mingw_dev_lib\include\SDL2 -LC:\mingw_dev_lib\lib -w -Wl,-subsystem,windows -lmingw32 -lSDL2main -lSDL2 -o $(OBJ_NAME)

#OBJS specifies which files to compile as part of the project
OBJS = 01_hello_SDL.cpp
#CC specifies which compiler we're using
CC = g++
#INCLUDE_PATHS specifies the additional include paths we'll need
INCLUDE_PATHS = -IC:\mingw_dev_lib\include\SDL2
#LIBRARY_PATHS specifies the additional library paths we'll need
LIBRARY_PATHS = -LC:\mingw_dev_lib\lib
#COMPILER_FLAGS specifies the additional compilation options we're using
# -w suppresses all warnings
# -Wl,-subsystem,windows gets rid of the console window
COMPILER_FLAGS = -w -Wl,-subsystem,windows
#LINKER_FLAGS specifies the libraries we're linking against
LINKER_FLAGS = -lmingw32 -lSDL2main -lSDL2
#OBJ_NAME specifies the name of our exectuable
OBJ_NAME = 01_hello_SDL
#This is the target that compiles our executable
all : $(OBJS)
 $(CC) $(OBJS) $(INCLUDE_PATHS) $(LIBRARY_PATHS) $(COMPILER_FLAGS) $(LINKER_FLAGS) -o $(OBJ_NAME)

Linux

MacOSX

1) A primeira coisa que precisa ser feito é baixar os arquivos de desenvolvimento para o OS X no website do SDL.

2) Em seguida abra o arquivo DMG e copie o SDL2.framework para o diretório /Library/Frameworks. Para ir diretamente ao caminho no Finder, pressione command+shift+g.

3) O framework pode precisar ser reassinado. Para fazer isso, abra uma janela de terminal no diretório /Library/Frameworks/sdl2.framework/ e assine o framework com o comando:

codesign -f -s – SDL2

4) Agora quer você instalou os arquivos da biblioteca, é hora de abrir seu IDE/Compilador favorito.

Sua primeira janela

//Using SDL and standard IO
#include <SDL.h>
#include <stdio.h>
//Screen dimension constants
const int SCREEN_WIDTH = 640;
const int SCREEN_HEIGHT = 480;

int main( int argc, char* args[] )
{
 //The window we'll be rendering to
 SDL_Window* window = NULL;
 //The surface contained by the window
 SDL_Surface* screenSurface = NULL;
 //Initialize SDL
 if( SDL_Init( SDL_INIT_VIDEO ) < 0 )
 {
 printf( "SDL could not initialize! SDL_Error: %s\n", SDL_GetError() );
 }

 else
 {
 //Create window
 window = SDL_CreateWindow( "SDL Tutorial", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, SCREEN_WIDTH, SCREEN_HEIGHT, SDL_WINDOW_SHOWN );
 if( window == NULL ) {
  printf( "Window could not be created! SDL_Error: %s\n", SDL_GetError() );
 }

 else
 {
 //Get window surface
 screenSurface = SDL_GetWindowSurface( window );
 //Fill the surface white
 SDL_FillRect( screenSurface, NULL, SDL_MapRGB( screenSurface->format, 0xFF, 0xFF, 0xFF ) );
 //Update the surface
 SDL_UpdateWindowSurface( window );
 //Wait two seconds
 SDL_Delay( 2000 );
 }
}

//Destroy window SDL_DestroyWindow( window ); //Quit SDL subsystems SDL_Quit(); return 0; }