【FFmpeg】SDL 音视频开发 ③ ( SDL 事件处理 | SDL_Event 数据结构分析 | 事件处理流程 | SDL 事件获取函数 | SDL_WaitEvent 函数 )

韩曙亮

发布于 2024-06-21 13:44:08

790

发布于 2024-06-21 13:44:08

文章被收录于专栏：韩曙亮的移动开发专栏韩曙亮的移动开发专栏

博客源码下载 : https://download.csdn.net/download/han1202012/89432451

SDL 事件处理代码执行效果如下 :

一、SDL 事件处理简介

1、SDL 事件处理引入

SDL , Simple DirectMedia Layer , 是跨平台的多媒体开发库 , 用于开发跨平台的多媒体应用程序 , 可开发 WIndows / Linux / MacOS 多媒体应用 , 编写一次代码 , 可以在多个平台运行 ;

使用 SDL 多媒体库开发的应用有如下功能 :

窗口创建
图像绘制
视频播放
音频播放
事件处理

其中的事件处理 , 就是处理外设 ( 键盘 / 鼠标 ) 传入的事件 , 如鼠标移动 , 鼠标点击 , 键盘按键等事件 ;

2、SDL 事件处理步骤

SDL 事件处理步骤 :

首先 , 调用 SDL_Init 函数 , 初始化 SDL 环境 , 设置要开发的子系统 ;

然后 , 调用 SDL_CreateWindow 函数创建窗口 ;

再后 , 处理事件 , 开启一个事件循环 , 不断调用 SDL_PollEvent 函数 , 获取是否有事件发生 , 如果获取到了键盘/鼠标事件 , 则执行对应的操作 ;

最后 , 用户触发退出操作 , 则退出事件循环 , 并调用 SDL_Quit 函数 , 释放 SDL 资源并退出 ;

代码示例 :

执行结果 : 运行程序后 , 弹出窗口 ,

此时开启循环 , 监听事件 , 每次循环时有事件发生 , 就会进入 if (event.type == SDL_QUIT) 分支语句 ,

点击窗口中右上角的 x 关闭按钮 , 会触发 SDL_QUIT 事件 , 此时退出事件循环 ,

继续执行代码就会关闭窗口 , 释放 SDL 资源 , 程序运行结束 ;

运行程序后弹出事件窗口 :

点击窗口中的关闭按钮 , 就会触发 SDL_QUIT 事件 ;

二、SDL 事件数据结构分析

1、SDL_Event 事件 - union 联合体

SDL_Event 用于存储各种事件 , 事件有如下类型 :

键盘事件
鼠标事件
手柄事件
窗口事件
手势事件
传感器事件

具体类型 , 在下面的 SDL_Event 联合体的代码注释中有详细说明 ;

SDL_Event 是一个联合体定义在 SDL_event.h 头文件中 , 该 SDL_Event 联合体是一种特殊的数据结构 , 允许在相同的内存位置存储不同类型的数据 ;

完整的 SDL_Event 联合体 union 内容如下 :

代码位置 :

2、SDL_Event 事件处理流程

SDL_Event 联合体设计很巧妙 , 其第一个类型成员 Uint32 type 与其它 25 个结构体类型成员共同占用同一个内存空间 , 这 25 个结构体的第一个参数也都是 Uint32 type 成员 ;

因此 , 不管是什么类型的事件 , 都可以通过获取 Uint32 type 成员 , 获得该成员的类型 , 然后根据该类型 , 就知道这是什么事件 , 直接调用该事件对应的结构体即可 ;

举例说明 : 获取的 SDL_Event 事件对象的 Uint32 type 类型是键盘事件 SDL_KEYDOWN , 那么就使用 SDL_KeyboardEvent 结构体的数据格式访问该 SDL_Event 事件 ;

SDL_KeyboardEvent 结构体内容如下 :

解析键盘事件的代码示例如下 : 调用 SDL_WaitEvent 函数 , 阻塞等待事件到来 , 事件到来后 ,

首先 , 获取事件的类型 , event.type , 先看是哪种类型的事件 , 选择使用哪种结构体数据格式访问改事件数据 ;
然后 , 如果获取的事件是 SDL_KEYDOWN 键盘事件 , 则使用 SDL_KeyboardEvent 结构体的数据格式访问 SDL_Event 事件对象 ;
最后 , 通过访问 SDL_KeyboardEvent 结构体的 event.key.keysym.sym 成员 , 获取按下的是哪个按键 , 根据不同的按键 , 进行不同的操作 ;

三、SDL 事件函数

1、SDL_PollEvent 函数

在上面的示例中 , 使用了 SDL_PollEvent 函数 , 检测是否有事件发生 ,

如果有事件发生 , 则通过参数中的 SDL_Event 指针返回该事件 , 函数返回值 1 ;
如果没有事件发生 , 函数返回 0 , SDL_Event 指针参数不变 ;

SDL_PollEvent 函数是非阻塞函数 , 如果没有事件发生 , 则立刻返回 , 不会阻塞程序执行 ; 与之相对的是 SDL_WaitEvent 函数 , 该函数会阻塞程序 , 等待事件发生 ;

SDL_PollEvent 函数原型如下 :

event 参数 : 指向 SDL_Event 对象的指针 , 如果有事件 , 则通过该参数获取事件 ;
int 返回值 : 如果获取事件成功 , 则返回 1 ; 如果获取事件失败 , 返回 0 ;

代码示例 : 使用 SDL_PollEvent 函数时 ,

首先 , 声明 SDL_Event 变量 ;
然后 , 将 SDL_Event 变量地址传入 SDL_PollEvent 函数 ;
最后 , 根据 SDL_PollEvent 函数的返回值 , 决定是否处理事件 ;
- 如果返回 1 , 则处理事件 ;
- 如果返回 0 , 则不处理事件 ;