madebr / SDL_gesture

SDL2's gesture API split out into a single-header library.

SDL_gesture

SDL3 is removing the Gesture API that was available in SDL2, so as a migration path, we are providing an equivalent as a single-header library that you can drop into your SDL3-based project.

We do not make formal releases of this code; just grab the latest and drop it into your project!

To use:

• Copy SDL_gesture.h into your project.

• Wherever you need access to this functionality, #include the header, after including SDL.h.

• In ONLY ONE PLACE in your project, make sure you've #defined SDL_GESTURE_IMPLEMENTATION before including the header:

  #define SDL_GESTURE_IMPLEMENTATION 1
  #include "SDL_gesture.h"

  This will make the header include not just function declarations and such but also its implementation code.

• To use the API, call this somewhere near startup, after SDL_Init:

  Gesture_Init();

  and then, before you call SDL_Quit at the end of your program:

  Gesture_Quit();

  Now you will get Gesture events from the SDL event queue.

• SDL_RecordGesture, SDL_SaveAllDollarTemplates, SDL_SaveDollarTemplate, and SDL_LoadDollarTemplates work as before, they are just prefixed with "Gesture_" instead of "SDL_". Same with event types.

• It is safe to add this to SDL2-based projects, as it will just use SDL2's existing API under the hood.