-
SDL3_API分类参考_互斥锁（CategoryMutex）
互斥锁子系统（CategoryMutex）SDL提供了多种线程同步原语，用于保障多线程程序的线程安全。本文档无法全面覆盖线程安全这一复杂主题，但理解这些同步原语的用途、价值和正确用法，是编写正确且安全的多线程程序的关键。SDL提供的核心同步原语包括：互斥锁（Mutexes）：SDL_CreateMutex()——独占式资源访问控制读写锁（Read/Writelocks）：SDL_CreateRWL… -
SDL3_API分类参考_线程（CategoryThread）
线程子系统（CategoryThread）SDL提供了跨平台的线程管理功能，主要用于线程的创建、优先级设置和终止处理。此外，SDL还支持线程本地存储（ThreadLocalStorage,TLS）——即每个线程拥有唯一的专属数据，但可通过同一个键值访问这些数据。平台兼容性说明在不支持线程的平台上（例如未启用pthreads的Emscripten环境），这些函数依然存在，但SDL_CreateThr… -
SDL3_API分类参考_GPU（CategoryGPU）
GPU子系统（CategoryGPU）SDLGPUAPI提供了跨平台的现代图形硬件交互方式，支持3D图形渲染和计算功能，设计风格对标Metal、Vulkan和Direct3D12。基础工作流程设备初始化：应用通过SDL_CreateGPUDevice()创建GPU设备，并使用SDL_ClaimWindowForGPUDevice()将设备关联到窗口（也可完全离屏渲染，如仅做图像处理）；静态资源准备… -
SDL3_API分类参考_音频（CategoryAudio）
音频子系统（CategoryAudio）SDL库的音频功能模块，SDL3中所有音频相关操作均围绕SDL_AudioStream（音频流）展开。无论是播放/录制音频、格式转换、流式传输、数据缓冲还是混音，都需要通过音频流来处理。音频流核心特性音频流具备高度灵活性：可随时接收任意数量的音频数据，支持所有SDL兼容格式；可按需输出任意目标格式的音频数据，即使在处理过程中输入/输出格式发生变化；应用程序可… -
SDL3_API分类参考_触觉反馈（CategoryHaptic）
触觉反馈子系统（CategoryHaptic）SDL触觉反馈（Haptic）子系统用于管理力反馈（forcefeedback）设备，如带震动功能的游戏手柄、方向盘、力反馈鼠标等，可实现震动、力反馈等触觉效果。基础使用流程初始化子系统（传入SDL_INIT_HAPTIC标志）；打开触觉反馈设备：通过索引打开：SDL_OpenHaptic()；从已打开的游戏手柄打开：SDL_OpenHapticFro… -
SDL3_API分类参考_HIDAPI （CategoryHIDAPI）
HIDAPI子系统（CategoryHIDAPI）SDLHIDAPI功能的头文件封装模块，适配了AlanOtt开发的原生HIDAPI接口，其源代码遵循以下许可协议：HIDAPI-用于与HID设备通信的跨平台库版权所有2009，AlanOtt，Signal11Software。保留所有权利。只要源文件中的版权声明保持完整，任何人可出于任何原因使用本软件。注：该许可协议与SDLzlib许可协议的第三条… -
SDL3_API分类参考_传感器（CategorySensor）
传感器子系统（CategorySensor）SDL提供的传感器管理模块，可访问不同平台设备上的陀螺仪、加速度计等传感器硬件，获取设备的运动、姿态等物理数据。基础使用前提调用SDL_Init()初始化时必须传入SDL_INIT_SENSOR标志，SDL会扫描系统中的传感器设备并加载对应的驱动程序，之后才能正常使用传感器相关接口。函数SDL_CloseSensor：关闭已打开的传感器设备（释放传感器资… -
SDL3_API分类参考_手写笔（CategoryPen）
手写笔子系统（CategoryPen）SDL提供的压感手写笔（触控笔/橡皮擦）事件处理模块，适用于绘图板、配备手写笔的移动设备/平板等场景的精准输入处理。核心事件类型要处理手写笔输入，只需监听以下核心事件：SDL_EVENT_PEN_PROXIMITY_IN/SDL_EVENT_PEN_PROXIMITY_OUT：手写笔进入/离开感应范围事件（SDL_PenProximityEvent）；SDL_… -
SDL3_API分类参考_触摸输入（CategoryTouch）
触摸输入子系统（CategoryTouch）SDL在支持触摸功能的平台上提供了完整的触摸输入处理能力，可管理多个触摸设备，并追踪每个设备上的多点触控（多手指触摸）操作。核心交互方式触摸操作主要通过事件系统传递：SDL_EVENT_FINGER_DOWN：手指按下事件；SDL_EVENT_FINGER_MOTION：手指移动事件；SDL_EVENT_FINGER_UP：手指抬起事件。同时也提供了查询… -
SDL3_API分类参考_游戏手柄（CategoryGamepad）
游戏手柄子系统（CategoryGamepad）SDL提供了底层的摇杆API，该API仅将摇杆视为一堆无规则的按键、轴和方向键。如果你计划自行开发控制配置界面，这个底层API能提供极高的灵活性，但开发成本也很高——而如今我们所说的「摇杆」大多是主机风格的标准化游戏手柄。因此SDL在底层摇杆功能之上，封装了更易用的游戏手柄（Gamepad）API。摇杆vs游戏手柄核心区别摇杆（Joystick）：用…