Wiki Enseignement

User Tools

Site Tools

Trace:
projtec:sdl2

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
projtec:sdl2 [2017/02/08 21:12] – orelprojtec:sdl2 [2024/03/18 15:06] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== SDL2 ====== ====== SDL2 ======
  
-==== Une petite coquille pour bien débuter ====+SDL2 est un blibliothèque qui permet de développer des applications graphiques, comme de jeux 2D. Un des points fort de SDL2 est incontestablement sa simplicité et sa portabilité sous Android !
  
-Notre coquille contient la boucle d'évènements principale dans la fonction //main()// et s'appuie sur quatre fonctions spécifiques :+  * https://wiki.libsdl.org/ 
 +  * https://www.libsdl.org/projects/SDL_ttf/ 
 +  * https://www.libsdl.org/projects/SDL_image/
  
-  * init() : ... +Voici quelques tuoriels utiles pour bien commençer :
-  * render() : ... +
-  * process() : ... +
-  * clean() : ...+
  
-Voici le code de cette coquille :+  * http://lazyfoo.net/tutorials/SDL/
  
-<code C demo.c> +Nous proposons ici un modèle de programme avec SDL2, et une petit exemple d'utilisation de ce modèle. La démo montre diverses possibilités de SDL2, comme le texte TTF, les textures transparentes en PNG, ... Vous trouverez tout cela dans l'archive : {{:projtec:sdl2-demo.zip}}. Lire le README.txt pour démarrer.
-// SDL2 Demo by aurelien.esnard@u-bordeaux.fr+
  
-#include <SDL2/SDL.h> 
-#include <SDL2/SDL_image.h>           // required to load transparent texture from PNG 
-#include <SDL2/SDL_ttf.h>             // required to use TTF fonts 
  
 +{{ :projtec:sdl2-demo.png?direct&200 |}}
 +
 +
 +==== Un Modèle de Programme SDL2 ====
 +
 +Notre modèle se compose de trois fichiers : //main.c//, //model.h// et //model.c//. Le fichier //main.c// contient le programme principal avec la boucle d'évènements. Il s'appuie sur les quatre fonctions declarées dans //model.h// et qu'il faut ensuite implanter dans //model.c//.
 +
 +  * La fonction //init()// permet l'initialisation de la structure Env qui contient toutes les variables utiles à votre programme, comme par exemple les textures SDL.
 +  * La fonction //clean()// permet principalement de terminer votre programme, en libérant les allocations mémoire effectuées dans la phase d'initialisation.
 +  * La fonction //process()// est appelée dans la boucle principale de votre programme, afin de traiter tous les èvenements SDL2 (souris, clavier, ...).
 +  * La fonction //render()// est appelée dans la boucle principale de votre programme, afin d’effectuer le rendu graphique des différents éléments (textures, ...).
 +
 +Voici la déclaration des fonctions utiles à notre modèle :
 +
 +<code C model.h>
 +// SDL2 Model by aurelien.esnard@u-bordeaux.fr
 +
 +#ifndef MODEL_H
 +#define MODEL_H
 +
 +#include <SDL2/SDL.h>
 #include <stdio.h> #include <stdio.h>
 #include <stdbool.h> #include <stdbool.h>
 +
 +typedef struct Env_t Env;
  
 /* **************************************************************** */ /* **************************************************************** */
 +     
 +#define APP_NAME "Hello World!"
 +#define SCREEN_WIDTH 600
 +#define SCREEN_HEIGHT 600
  
 +/* **************************************************************** */
 +    
 #ifdef __ANDROID__  #ifdef __ANDROID__ 
 #define PRINT(STR, ...) do { SDL_Log(STR, ##__VA_ARGS__);  } while(0) #define PRINT(STR, ...) do { SDL_Log(STR, ##__VA_ARGS__);  } while(0)
 #define ERROR(STR, ...) do { SDL_Log(STR, ##__VA_ARGS__); exit(EXIT_FAILURE); } while(0)  #define ERROR(STR, ...) do { SDL_Log(STR, ##__VA_ARGS__); exit(EXIT_FAILURE); } while(0) 
-// #define LOG(TAG, STR, ...) __android_log_print(ANDROID_LOG_VERBOSE, TAG ,STR, ##__VA_ARGS__) 
 # else # else
 #define PRINT(STR, ...) do { printf(STR, ##__VA_ARGS__); } while(0) #define PRINT(STR, ...) do { printf(STR, ##__VA_ARGS__); } while(0)
Line 35: Line 58:
 /* **************************************************************** */ /* **************************************************************** */
  
-#define SCREEN_WIDTH 640 +Env * init(SDL_Window* win, SDL_Renderer* ren, int argc, char* argv[]); 
-#define SCREEN_HEIGHT 480+void render(SDL_Window* win, SDL_Renderer* ren, Env * env); 
 +void clean(SDL_Window* win, SDL_Renderer* ren, Env * env); 
 +bool process(SDL_Window* win, SDL_Renderer* ren, Env * env, SDL_Event * e);
  
 /* **************************************************************** */ /* **************************************************************** */
  
-/* your main environment structure */ +#endif 
-typedef struct  { +</code>
-  /* PUT YOUR VARIABLES HERE */ +
-} Env; +
  
-/* **************************************************************** */ 
  
-void init(SDL_Window* win, SDL_Renderer* ren, Env * env) +Voici le code du programme principal :
-{   +
-  /* PUT YOUR CODE HERE TO INIT TEXTURES, ... */ +
-}+
  
 +<code C main.c>
 +// SDL2 Demo by aurelien.esnard@u-bordeaux.fr
 +     
 +#include <SDL.h>
 +#include <SDL_image.h>  // required to load transparent texture from PNG
 +#include <SDL_ttf.h>    // required to use TTF fonts     
 +#include <stdio.h>
 +#include <stdbool.h>
 +#include "model.h"
 +         
 /* **************************************************************** */ /* **************************************************************** */
- +     
-void render(SDL_Window* win, SDL_Renderer* ren, Env * env) +
-{ +
-  /* PUT YOUR CODE HERE TO RENDER TEXTURES, ... */ +
-} +
- +
-/* **************************************************************** */ +
- +
-void clean(SDL_Window* win, SDL_Renderer* ren, Env * env) +
-{ +
-  /* PUT YOUR CODE HERE TO CLEAN MEMORY */ +
-} +
- +
-/* **************************************************************** */ +
- +
-bool process(SDL_Window* win, SDL_Renderer* ren, Env * env, SDL_Event * e) +
-{      +
-  if (e->type == SDL_QUIT) { +
-    return true; +
-  } +
- +
-  /* PUT YOUR CODE HERE TO PROCESS EVENTS */ +
-   +
-  return false;  +
-} +
- +
-/* **************************************************************** */ +
 int main(int argc, char * argv[]) int main(int argc, char * argv[])
 {  { 
   /* initialize SDL2 and some extensions */   /* initialize SDL2 and some extensions */
-  if(SDL_Init(SDL_INIT_VIDEO) != 0) ERROR("SDL_Init VIDEO");  +  if(SDL_Init(SDL_INIT_VIDEO) != 0) ERROR("Error: SDL_Init VIDEO (%s)", SDL_GetError());   
-  if(IMG_Init(IMG_INIT_PNG & IMG_INIT_PNG) != IMG_INIT_PNG) ERROR("IMG_Init PNG"); +  if(IMG_Init(IMG_INIT_PNG & IMG_INIT_PNG) != IMG_INIT_PNG) ERROR("Error: IMG_Init PNG (%s)", SDL_GetError());   
-  if(TTF_Init() != 0) ERROR("TTF_Init");   +  if(TTF_Init() != 0) ERROR("Error: TTF_Init (%s)", SDL_GetError());   
 +     
   /* create window and renderer */   /* create window and renderer */
-  SDL_Window * win = SDL_CreateWindow("Hello World!", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, +  SDL_Window * win = SDL_CreateWindow(APP_NAME, SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, 
-       SCREEN_WIDTH, SCREEN_HEIGHT, SDL_WINDOW_SHOWN | SDL_WINDOW_RESIZABLE); +           SCREEN_WIDTH, SCREEN_HEIGHT, SDL_WINDOW_SHOWN | SDL_WINDOW_RESIZABLE); 
-  if(!win) ERROR("SDL_CreateWindow");  +  if(!win) ERROR("Error: SDL_CreateWindow (%s)", SDL_GetError());  
   SDL_Renderer * ren = SDL_CreateRenderer(win, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);   SDL_Renderer * ren = SDL_CreateRenderer(win, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
-  if(!ren) ERROR("SDL_CreateWindow");     +  if(!ren) ERROR("Error: SDL_CreateRenderer (%s)", SDL_GetError());   
 +     
   /* initialize your environment */   /* initialize your environment */
-  Env env; +  Env * env = init(win, ren, argc, argv); 
-  init(win, ren, &env); +     
-  +
   /* main render loop */   /* main render loop */
   bool quit = false;   bool quit = false;
   while (!quit) {   while (!quit) {
 +     
     /* manage events */     /* manage events */
     SDL_Event e;     SDL_Event e;
     while (SDL_PollEvent(&e)) {     while (SDL_PollEvent(&e)) {
       /* process your events */       /* process your events */
-      quit = process(win, ren, &env, &e);+      quit = process(win, ren, env, &e);
       if(quit) break;       if(quit) break;
     }     }
-    +     
     /* background in gray */     /* background in gray */
     SDL_SetRenderDrawColor(ren, 0xA0, 0xA0, 0xA0, 0xFF);      SDL_SetRenderDrawColor(ren, 0xA0, 0xA0, 0xA0, 0xFF); 
     SDL_RenderClear(ren);     SDL_RenderClear(ren);
 +     
     /* render all what you want */         /* render all what you want */    
-    render(win, ren, &env); +    render(win, ren, env); 
     SDL_RenderPresent(ren);     SDL_RenderPresent(ren);
     SDL_Delay(10);     SDL_Delay(10);
   }   }
-  +     
   /* clean your environment */   /* clean your environment */
-  clean(win, ren, &env);+  clean(win, ren, env);
      
   SDL_DestroyRenderer(ren);   SDL_DestroyRenderer(ren);
Line 129: Line 130:
   TTF_Quit();     TTF_Quit();  
   SDL_Quit();   SDL_Quit();
 +     
   return EXIT_SUCCESS;   return EXIT_SUCCESS;
 } }
Line 135: Line 136:
  
  
-==== Petite Démo ====+Et voici une coquille vide pour implanter les fonctions de notre modèle :
  
-Pour illustrer notre petite coquille, voici une petite démo qui montre les différentes possibilités de SDL2 (texte TTF, texture transparente PNG, ...). Vous trouverez dans l'archive {{:projtec:sdl2-demo.zip}} les fichiers suivants :+<code C model.c> 
 +// SDL2 Demo by aurelien.esnard@u-bordeaux.fr
  
-<code> +#include <SDL.h> 
-├── Arial.ttf +#include <SDL_image.h>  // required to load transparent texture from PNG 
-├── background.png +#include <SDL_ttf.h>    // required to use TTF fonts     
-├── bomb.png +
-├── demo.c +
-├── Makefile +
-├── mario.png +
-└── README.txt +
-</code>+
  
-Pour compiler :+#include <stdio.h> 
 +#include <stdlib.h> 
 +#include <stdbool.h> 
 +#include "model.h"
  
-  gcc -std=c99 -O3 -Wall -c -o demo.o demo.c +/* **************************************************************** */ 
-  gcc -rdynamic -lm -lSDL2 -lSDL2_ttf -lSDL2_image demo.o -o demo+      
 +struct Env_t {  
  
-Attention, vous devez satisfaire quelques dépendances. Sous Debian :+  /* PUT YOUR VARIABLES HERE */ 
 + 
 +};  
 +      
 +/* **************************************************************** */ 
 +      
 +Env * init(SDL_Window* win, SDL_Renderer* ren, int argc, char* argv[]) 
 +{   
 +  Env * env = malloc(sizeof(struct Env_t)); 
 + 
 +  /* PUT YOUR CODE HERE TO INIT TEXTURES, ... */ 
 + 
 +  return env; 
 +} 
 +      
 +/* **************************************************************** */ 
 +      
 +void render(SDL_Window* win, SDL_Renderer* ren, Env * env) 
 +{ 
 +  /* PUT YOUR CODE HERE TO RENDER TEXTURES, ... */ 
 +} 
 +      
 +/* **************************************************************** */ 
 +      
 +      
 +bool process(SDL_Window* win, SDL_Renderer* ren, Env * env, SDL_Event * e) 
 +{      
 + 
 +  if (e->type == SDL_QUIT) { 
 +    return true; 
 +  } 
 + 
 +  /* PUT YOUR CODE HERE TO PROCESS EVENTS */ 
 +   
 +  return false;  
 +} 
 + 
 +/* **************************************************************** */ 
 + 
 +void clean(SDL_Window* win, SDL_Renderer* ren, Env * env) 
 +{ 
 +  /* PUT YOUR CODE HERE TO CLEAN MEMORY */ 
 + 
 +  free(env); 
 +} 
 +</code>
  
-  sudo apt-get install libsdl2-dev libsdl2-image-dev  libsdl2-ttf-dev 
  
 ==== Portage sous Android  ==== ==== Portage sous Android  ====
  
-//coming soon!//+Le code proposé ci-dessus est 100% portable sous Android : [[projtec:android|c'est ici !]]
  
projtec/sdl2.1486588345.txt.gz · Last modified: 2024/03/18 15:05 (external edit)