SDL2.0例子代码分析—–CheckKeys Project

SDL（Simple DirectMedia Layer）是一套开放源代码的跨平台多媒体开发库，使用C语言写成。SDL提供了数种控制图像、声音、输出入的函数，让开发者只要用相同或是相似的代码就可以开发出跨多个平台（Linux、Windows、Mac OS X等）的应用软件。目前SDL多用于开发游戏、模拟器、媒体播放器等多媒体应用领域。

SDL1.2和SDL2的差别

SDK1.2和SDL2.1系列的API接口变动的不小,当然功能也大大增强,支持多线程窗口。

具体的change 请看

https://blog.csdn.net/yue7603835/article/details/42030667  我转载的 官方的 文章。

下面是 SDL2.0 例子代码的 事件CheckKeys代码的分析 +注释

SDK2.0例子代码分析-检测键盘按下状态

/* 监听键盘按下次数 你需要调用  SDL_PollEvent() or SDL_WaitEvent() to    推动事件循环和 监视    */  #include <stdio.h> #include <stdlib.h> #include <string.h>  #include "SDL.h"  /*退出程序之前先清理 SDL subsystem */ static void quit(int rc) {    SDL_Quit();  exit(rc); }  //格式化 可变参数 到 buffer static void print_string(char **text, size_t *maxlen, const char *fmt, ...) {  int len;  //定义可变参数列表   va_list ap;  ///初始化可变参数列表   va_start(ap, fmt);  //格式化所有参数到text二维数组 并且返回字符长度  len = SDL_vsnprintf(*text, *maxlen, fmt, ap);  //如果返回>0 字符指针后移  if (len > 0) {   //   *text += len;   //如果len<最大尺寸那么 减少最大尺寸  否则置零   if (((size_t)len) < *maxlen) {    *maxlen -= (size_t)len;   }   else {    *maxlen = 0;   }  }  va_end(ap); }  static void print_modifiers(char **text, size_t *maxlen) {  int mod;  print_string(text, maxlen, " modifiers:");   //获取当前键盘状态判断 SHIFT等是否按下   mod = SDL_GetModState();  if (!mod) {   print_string(text, maxlen, " (none)");   return;  }  if (mod & KMOD_LSHIFT)   print_string(text, maxlen, " LSHIFT");  if (mod & KMOD_RSHIFT)   print_string(text, maxlen, " RSHIFT");  if (mod & KMOD_LCTRL)   print_string(text, maxlen, " LCTRL");  if (mod & KMOD_RCTRL)   print_string(text, maxlen, " RCTRL");  if (mod & KMOD_LALT)   print_string(text, maxlen, " LALT");  if (mod & KMOD_RALT)   print_string(text, maxlen, " RALT");  if (mod & KMOD_LGUI)   print_string(text, maxlen, " LGUI");  if (mod & KMOD_RGUI)   print_string(text, maxlen, " RGUI");  if (mod & KMOD_NUM)   print_string(text, maxlen, " NUM");  if (mod & KMOD_CAPS)   print_string(text, maxlen, " CAPS");  if (mod & KMOD_MODE)   print_string(text, maxlen, " MODE"); }  static void //SDL_Keysym系统键 被SDL_EVENT所使用 PrintKey(SDL_Keysym * sym, SDL_bool pressed, SDL_bool repeat) {     //存放消息  char message[512];   //指向message的指针  char *spot;  size_t left;   spot = message;  //left初始化=512  left = sizeof(message);   /*打印键盘码  状态  名字 */  if (sym->sym) {   print_string(&spot, &left,    "Key %s:  scancode %d = %s, keycode 0x%08X = %s ",    pressed ? "pressed " : "released",            ///扫描码    sym->scancode,    //获取扫描码名字     SDL_GetScancodeName(sym->scancode),      //获取key name    sym->sym, SDL_GetKeyName(sym->sym));  }  else {   print_string(&spot, &left,    "Unknown Key (scancode %d = %s) %s ",    sym->scancode,    //获取键盘扫描码名字    SDL_GetScancodeName(sym->scancode),    pressed ? "pressed " : "released");  }  //打印当前键盘是否有系统键被按下  print_modifiers(&spot, &left);  if (repeat) {   //如果重复按下 那么格式化字符串到 buffer  message   print_string(&spot, &left, " (repeat)");  }  SDL_Log("%s/n", message); }  // static void PrintText(char *text) {  char *spot, expanded[1024];   expanded[0] = '/0';  for (spot = text; *spot; ++spot)  {    //格式化   size_t length = SDL_strlen(expanded);   //将字符串格式化到buffer   SDL_snprintf(expanded + length, sizeof(expanded) - length, "//x%.2x", (unsigned char)*spot);  }  //打印日志   SDL_Log("Text (%s): /"%s%s/"/n", expanded, *text == '"' ? "//" : "", text); }  int main(int argc, char *argv[]) {  //创建SDLwindow  SDL_Window *window;   //sdl事件处理  SDL_Event event;  int done;   /* 设置应用程序日志级别*/  SDL_LogSetPriority(SDL_LOG_CATEGORY_APPLICATION, SDL_LOG_PRIORITY_INFO);   /* 初始化SDL子系统*/  if (SDL_Init(SDL_INIT_VIDEO) < 0) {   SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Couldn't initialize SDL: %s/n", SDL_GetError());   return (1);  }   /* 创建SDL 2d渲染窗口 */  window = SDL_CreateWindow("CheckKeys Test",   SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,    640, 480, 0);  //sdl 2d渲染窗口创建失败  if (!window) {   SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Couldn't create 640x480 window: %s/n",    SDL_GetError());   quit(2);  }   //如果是IPHONE下创建一个OpenGL渲染上下文并使其成为当前窗口 #if __IPHONEOS__  SDL_GL_CreateContext(window); #endif  //开始接受Unicode文本输入事件  如果支持的话将会显示屏幕键盘  SDL_StartTextInput();   /* 监视键盘点击次数*/  done = 0;  //类似与 windows 消息循环 实际上底层在windows平台也是封装的 windows消息循环机制  while (!done)  {   /* 事件监测循环检测 事件 */   SDL_WaitEvent(&event);   //event.type存储了当前的事件类型   //如果无键盘鼠标 触摸点击 那么 默认是 0x200    switch (event.type)   {   case SDL_KEYDOWN:   case SDL_KEYUP:    //打印系统键信息    PrintKey(&event.key.keysym, (event.key.state == SDL_PRESSED) ? SDL_TRUE : SDL_FALSE, (event.key.repeat) ? SDL_TRUE : SDL_FALSE);    break;   case SDL_TEXTINPUT:    //如果是文本输入 输出文本    PrintText(event.text.text);    break;   case SDL_MOUSEBUTTONDOWN:    /* 如果有任何鼠标点击消息 或者SDL_QUIT消息 那么将退出窗口 */   case SDL_QUIT:    done = 1;    break;   default:    break;   }  }  //清除已经初始化的子系统 你应该在程序退出的时候调用  SDL_Quit();  return (0); }