-
SDL3_API分类参考_摇杆（CategoryJoystick）
摇杆子系统（CategoryJoystick）SDL提供的底层摇杆设备处理模块，适用于需要精细控制摇杆硬件的场景。如果只需简单的、按键功能标准化的控制器交互，建议使用游戏手柄（Gamepad）API而非本模块。核心概念说明instance_id（实例ID）：系统中摇杆设备的当前实例标识。摇杆拔插后会生成新的instance_id，该ID是单调递增的数值。player_index（玩家索引）：分配给… -
SDL3_API分类参考_鼠标（CategoryMouse）
鼠标子系统（CategoryMouse）所有图形界面（GUI）应用都需要处理鼠标交互，SDL提供了一套完整的函数集，用于管理鼠标输入、控制光标显示形态等核心功能。核心交互方式事件驱动：鼠标操作主要通过事件子系统传递（如移动触发SDL_EVENT_MOUSE_MOTION、按键按下触发SDL_EVENT_MOUSE_BUTTON_DOWN）；状态查询：也可通过SDL_GetMouseState()随… -
SDL3_API分类参考_扫描码（CategoryScancode）
扫描码子系统（CategoryScancode）该模块定义了键盘扫描码（Scancode）的核心枚举类型，扫描码用于标识键盘上物理按键的位置，而非按键上的符号。关于扫描码的具体含义和最佳使用方式，请参考官方键盘使用最佳实践文档：https://wiki.libsdl.org/SDL3/BestKeyboardPractices函数（无）数据类型（无）结构体（无）枚举SDL_Scancode：键盘扫… -
SDL3_API分类参考_按键码（CategoryKeycode）
按键码子系统（CategoryKeycode）该模块定义了用于标识键盘按键和修饰键的核心常量，是SDL键盘输入处理的基础数据类型定义模块。函数（无）数据类型SDL_Keycode：按键码类型（用于标识键盘上的「符号键」，如SDLK_a代表字母A、SDLK_ESCAPE代表ESC键，与键盘布局相关）SDL_Keymod：修饰键状态类型（用于标识Shift/Ctrl/Alt/GUI等修饰键的按下状态，… -
SDL3_API分类参考_键盘（CategoryKeyboard）
键盘子系统（CategoryKeyboard）SDL提供的键盘管理功能集，用于处理键盘设备检测、按键状态查询、文本输入等核心键盘交互逻辑。关于不同类型程序中键盘输入的最佳实践，可参考官方文档：https://wiki.libsdl.org/SDL3/BestKeyboardPractices函数SDL_ClearComposition：清空当前的输入法候选文本（适用于中文/日文等输入法的组合输入状… -
SDL3_API分类参考_事件（CategoryEvents）
事件子系统（CategoryEvents）SDL事件队列的管理核心模块，是应用与「外部交互」的核心通道——几乎所有和现实世界的交互信息（用户操作、硬件插拔、系统状态变化等）都会流经事件队列。核心使用方式应用通常在「新帧开始」时处理事件队列：最常用：循环调用SDL_PollEvent()直到返回false（无事件），逐个处理或忽略事件；回调模式：若使用主回调函数，事件会在SDL_AppIterate… -
SDL3_API分类参考_摄像头（CategoryCamera）
摄像头子系统（CategoryCamera）SDL库提供的视频采集功能，专门用于读取摄像头（如网络摄像头）等视频源的输入数据。通过这组API，应用可实现以下功能：枚举、查询系统中的摄像头设备；打开摄像头并获取逐帧视频数据（以SDL_Surface形式返回）；将视频帧上传至SDL_Texture渲染，或直接处理内存中的像素数据。权限说明多数平台会对摄像头访问做权限管控：应用首次访问摄像头时，系统会弹… -
SDL3_API分类参考_Metal 支持（CategoryMetal）
Metal适配子系统（CategoryMetal）SDL提供一套专门用于在SDL窗口上创建Metal图层（Layer）和视图（View）的函数集，仅适用于Apple平台（macOS/iOS）。这组接口主要用于平台级别的「粘合层」开发：多数macOS/iOS应用使用SDL时无需调用这些函数；仅在需要与系统级Metal渲染深度集成（如自定义渲染管线、原生Metal视图交互）时，这组API才会发挥作用。… -
SDL3_API分类参考_Vulkan 支持（CategoryVulkan）
Vulkan适配子系统（CategoryVulkan）SDL提供一套专门用于在SDL窗口上创建Vulkan渲染表面（Surface）的函数集。Vulkan大部分功能可脱离SDL独立运行，但在初始化阶段需要SDL提供少量关键支持：调用SDL_Vulkan_GetInstanceExtensions()获取创建VkInstance所需的平台相关扩展；调用SDL_Vulkan_GetVkGetInsta… -
SDL3_API分类参考_剪贴板（CategoryClipboard）
剪贴板子系统（CategoryClipboard）SDL提供对系统剪贴板的完整访问能力，既能读取其他进程写入的剪贴板内容，也能将自身数据发布到剪贴板中。SDL剪贴板不仅支持文本，还能按MIME类型访问和发布任意格式的数据。基础用法（文本）获取/发布纯文本到系统剪贴板非常简单，只需分别调用SDL_GetClipboardText()和SDL_SetClipboardText()：处理的是UTF-8编…