SDL2.0例子代码分析-----CheckKeys Project

woaidaima2016

SDL简介SDL（Simple DirectMedia Layer）是一套开放源代码的跨平台多媒体开发库，使用C语言写成。SDL提供了数种控制图像、声音、输出入的函数，让开发者只要用相同或是相似的代码就可以开发出跨多个平台（Linux、Windows、Mac OS X等）的应用软件。目前SDL多用于开发游戏、模拟器、媒体播放器等多媒体应用领域。
SDL1.2和SDL2的差别
SDK1.2和SDL2.1系列的API接口变动的不小,当然功能也大大增强,支持多线程窗口。
下面是 SDL2.0 例子代码的 事件CheckKeys代码的分析 +注释
SDK2.0例子代码分析-检测键盘按下状态

1. 
   
2. /* 监听键盘按下次数
   
3. 你需要调用  SDL_PollEvent() or SDL_WaitEvent() to
   
4.    推动事件循环和 监视
   
5.    */
   
6. 
   
7. #include <stdio.h>
   
8. #include <stdlib.h>
   
9. #include <string.h>
   
10. 
    
11. #include "SDL.h"
    
12. 
    
13. /*退出程序之前先清理 SDL subsystem */
    
14. static void
    
15. quit(int rc)
    
16. {  
    
17.     SDL_Quit();
    
18.     exit(rc);
    
19. }
    
20. 
    
21. //格式化 可变参数 到 buffer
    
22. static void
    
23. print_string(char **text, size_t *maxlen, const char *fmt, ...)
    
24. {
    
25.     int len;
    
26.     //定义可变参数列表
    
27.     va_list ap;
    
28.     ///初始化可变参数列表
    
29.     va_start(ap, fmt);
    
30.     //格式化所有参数到text二维数组 并且返回字符长度
    
31.     len = SDL_vsnprintf(*text, *maxlen, fmt, ap);
    
32.     //如果返回>0 字符指针后移
    
33.     if (len > 0) {
    
34.         //
    
35.         *text += len;
    
36.         //如果len<最大尺寸那么 减少最大尺寸  否则置零
    
37.         if (((size_t)len) < *maxlen) {
    
38.             *maxlen -= (size_t)len;
    
39.         }
    
40.         else {
    
41.             *maxlen = 0;
    
42.         }
    
43.     }
    
44.     va_end(ap);
    
45. }
    
46. 
    
47. static void
    
48. print_modifiers(char **text, size_t *maxlen)
    
49. {
    
50.     int mod;
    
51.     print_string(text, maxlen, " modifiers:");
    
52.     //获取当前键盘状态判断 SHIFT等是否按下
    
53.     mod = SDL_GetModState();
    
54.     if (!mod) {
    
55.         print_string(text, maxlen, " (none)");
    
56.         return;
    
57.     }
    
58.     if (mod & KMOD_LSHIFT)
    
59.         print_string(text, maxlen, " LSHIFT");
    
60.     if (mod & KMOD_RSHIFT)
    
61.         print_string(text, maxlen, " RSHIFT");
    
62.     if (mod & KMOD_LCTRL)
    
63.         print_string(text, maxlen, " LCTRL");
    
64.     if (mod & KMOD_RCTRL)
    
65.         print_string(text, maxlen, " RCTRL");
    
66.     if (mod & KMOD_LALT)
    
67.         print_string(text, maxlen, " LALT");
    
68.     if (mod & KMOD_RALT)
    
69.         print_string(text, maxlen, " RALT");
    
70.     if (mod & KMOD_LGUI)
    
71.         print_string(text, maxlen, " LGUI");
    
72.     if (mod & KMOD_RGUI)
    
73.         print_string(text, maxlen, " RGUI");
    
74.     if (mod & KMOD_NUM)
    
75.         print_string(text, maxlen, " NUM");
    
76.     if (mod & KMOD_CAPS)
    
77.         print_string(text, maxlen, " CAPS");
    
78.     if (mod & KMOD_MODE)
    
79.         print_string(text, maxlen, " MODE");
    
80. }
    
81. 
    
82. static void
    
83. //SDL_Keysym系统键 被SDL_EVENT所使用
    
84. PrintKey(SDL_Keysym * sym, SDL_bool pressed, SDL_bool repeat)
    
85. {   
    
86.     //存放消息
    
87.     char message[512];
    
88.     //指向message的指针
    
89.     char *spot;
    
90.     size_t left;
    
91. 
    
92.     spot = message;
    
93.     //left初始化=512
    
94.     left = sizeof(message);
    
95. 
    
96.     /*打印键盘码  状态  名字 */
    
97.     if (sym->sym) {
    
98.         print_string(&spot, &left,
    
99.             "Key %s:  scancode %d = %s, keycode 0x%08X = %s ",
    
100.             pressed ? "pressed " : "released",
     
101.            ///扫描码
     
102.             sym->scancode,
     
103.             //获取扫描码名字
     
104.             SDL_GetScancodeName(sym->scancode),
     
105.              //获取key name
     
106.             sym->sym, SDL_GetKeyName(sym->sym));
     
107.     }
     
108.     else {
     
109.         print_string(&spot, &left,
     
110.             "Unknown Key (scancode %d = %s) %s ",
     
111.             sym->scancode,
     
112.             //获取键盘扫描码名字
     
113.             SDL_GetScancodeName(sym->scancode),
     
114.             pressed ? "pressed " : "released");
     
115.     }
     
116.     //打印当前键盘是否有系统键被按下
     
117.     print_modifiers(&spot, &left);
     
118.     if (repeat) {
     
119.         //如果重复按下 那么格式化字符串到 buffer  message
     
120.         print_string(&spot, &left, " (repeat)");
     
121.     }
     
122.     SDL_Log("%s\n", message);
     
123. }
     
124. 
     
125. //
     
126. static void
     
127. PrintText(char *text)
     
128. {
     
129.     char *spot, expanded[1024];
     
130. 
     
131.     expanded[0] = '\0';
     
132.     for (spot = text; *spot; ++spot)
     
133.     {
     
134.         //格式化
     
135.         size_t length = SDL_strlen(expanded);
     
136.         //将字符串格式化到buffer
     
137.         SDL_snprintf(expanded + length, sizeof(expanded) - length, "\\x%.2x", (unsigned char)*spot);
     
138.     }
     
139.     //打印日志
     
140.     SDL_Log("Text (%s): \"%s%s\"\n", expanded, *text == '"' ? "\\" : "", text);
     
141. }
     
142. 
     
143. int
     
144. main(int argc, char *argv[])
     
145. {
     
146.     //创建SDLwindow
     
147.     SDL_Window *window;
     
148. 
     
149.     //sdl事件处理
     
150.     SDL_Event event;
     
151.     int done;
     
152. 
     
153.     /* 设置应用程序日志级别*/
     
154.     SDL_LogSetPriority(SDL_LOG_CATEGORY_APPLICATION, SDL_LOG_PRIORITY_INFO);
     
155. 
     
156.     /* 初始化SDL子系统*/
     
157.     if (SDL_Init(SDL_INIT_VIDEO) < 0) {
     
158.         SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Couldn't initialize SDL: %s\n", SDL_GetError());
     
159.         return (1);
     
160.     }
     
161. 
     
162.     /* 创建SDL 2d渲染窗口 */
     
163.     window = SDL_CreateWindow("CheckKeys Test",
     
164.         SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,
     
165. 
     
166.         640, 480, 0);
     
167.     //sdl 2d渲染窗口创建失败
     
168.     if (!window) {
     
169.         SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Couldn't create 640x480 window: %s\n",
     
170.             SDL_GetError());
     
171.         quit(2);
     
172.     }
     
173. 
     
174.     //如果是IPHONE下创建一个OpenGL渲染上下文并使其成为当前窗口
     
175. #if __IPHONEOS__
     
176.     SDL_GL_CreateContext(window);
     
177. #endif
     
178.     //开始接受Unicode文本输入事件  如果支持的话将会显示屏幕键盘
     
179.     SDL_StartTextInput();
     
180. 
     
181.     /* 监视键盘点击次数*/
     
182.     done = 0;
     
183.     //类似与 windows 消息循环 实际上底层在windows平台也是封装的 windows消息循环机制
     
184.     while (!done)
     
185.     {
     
186.         /* 事件监测循环检测 事件 */
     
187.         SDL_WaitEvent(&event);
     
188.         //event.type存储了当前的事件类型
     
189.         //如果无键盘鼠标 触摸点击 那么 默认是 0x200
     
190.         switch (event.type)
     
191.         {
     
192.         case SDL_KEYDOWN:
     
193.         case SDL_KEYUP:
     
194.             //打印系统键信息
     
195.             PrintKey(&event.key.keysym, (event.key.state == SDL_PRESSED) ? SDL_TRUE : SDL_FALSE, (event.key.repeat) ? SDL_TRUE : SDL_FALSE);
     
196.             break;
     
197.         case SDL_TEXTINPUT:
     
198.             //如果是文本输入 输出文本
     
199.             PrintText(event.text.text);
     
200.             break;
     
201.         case SDL_MOUSEBUTTONDOWN:
     
202.             /* 如果有任何鼠标点击消息 或者SDL_QUIT消息 那么将退出窗口 */
     
203.         case SDL_QUIT:
     
204.             done = 1;
     
205.             break;
     
206.         default:
     
207.             break;
     
208.         }
     
209.     }
     
210.     //清除已经初始化的子系统 你应该在程序退出的时候调用
     
211.     SDL_Quit();
     
212.     return (0);
     
213. }

复制代码