-
SDL3_API分类参考_系统适配（CategorySystem）
系统适配子系统（CategorySystem）SDL提供的平台专属API集合，这类函数用于处理特定操作系统的个性化需求——由于其功能高度依赖平台特性，无法抽象为跨平台通用接口。大多数应用无需使用这些函数即可正常运行，但在以下场景中能发挥关键作用：与特定系统的其他组件集成（如Android的JNI、Windows的消息钩子）；为应用添加平台专属的体验优化（如iOS动画回调、Android吐司提示）；… -
SDL3_API分类参考_区域设置（CategoryLocale）
区域设置子系统（CategoryLocale）SDL提供了轻量的区域设置服务，核心能力是获取用户的首选区域列表（由「语言+国家/地区」组成）。该子系统仅包含一个核心函数：SDL_GetPreferredLocales()，它会自动处理不同系统、不同配置方式下的语言设置解析，兼容各类复杂的用户语言配置场景（如多语言优先级、地区变体等）。这一功能是实现应用多语言适配的基础——通过获取用户的首选语言，应… -
SDL3_API分类参考_系统托盘（CategoryTray）
系统托盘子系统（CategoryTray）SDL提供了系统托盘（Windows中更准确的称呼是「通知区域」）操作接口，在支持该功能的平台上（Windows/macOS/Linux主流桌面环境），SDL应用可创建托盘图标、添加子菜单、复选框、可点击菜单项，并注册回调函数响应用户的点击操作。系统托盘功能让应用在后台运行时仍能与用户交互，是桌面应用的常用特性（如后台服务、工具类软件）。函数SDL_Cre… -
SDL3_API分类参考_文件对话框（CategoryDialog）
文件对话框子系统（CategoryDialog）SDL提供了文件对话框相关接口，允许应用通过系统原生的图形界面让用户选择文件/文件夹——支持「打开文件」「保存文件」「选择文件夹」三种核心场景，还可控制文件过滤规则、是否允许多选等细节。重要特性对话框基于系统原生GUI实现，视觉风格与操作系统保持一致；显示对话框是非阻塞操作：调用后立即返回控制权给应用，用户完成选择后（确认/取消），SDL会调用预设的… -
SDL3_API分类参考_消息框（CategoryMessagebox）
消息框子系统（CategoryMessagebox）SDL提供了一套简洁的消息框API，适用于展示轻量提示信息——比如程序启动时发生致命错误（无需搭建完整UI即可告知用户），或在自定义UI加载完成前向用户展示关键提示。这些消息框会尽可能使用系统原生对话框样式，保证与操作系统的视觉一致性。SDL提供两种消息框接口：自定义消息框（SDL_ShowMessageBox()）：支持丰富的配置选项（如多按钮… -
SDL3_API分类参考_电源管理（CategoryPower）
电源管理子系统（CategoryPower）SDL提供了轻量的电源管理接口，核心功能是获取设备的电源状态信息，尤其适用于移动设备（如笔记本、平板、手机）上的游戏/应用开发。该子系统仅包含一个核心函数：SDL_GetPowerInfo()。典型应用场景检测设备是否使用电池供电，若电池电量低，可降低游戏帧率、关闭特效以减少功耗，延长续航；全屏运行时显示电池电量指示器；电量极低时提醒用户保存游戏进度，避… -
SDL3_API分类参考_进程控制（CategoryProcess）
进程控制子系统（CategoryProcess）SDL提供了一套跨平台的进程控制接口，用于创建、管理和销毁操作系统级别的子进程，无需适配不同系统的原生进程API（如Windows的CreateProcess、Linux的fork/exec）。核心使用流程创建进程：通过SDL_CreateProcess()创建基础子进程，或通过SDL_CreateProcessWithProperties()创建带… -
SDL3_API分类参考_共享对象（CategorySharedObject）
共享对象子系统（CategorySharedObject）SDL提供了一套与系统无关的共享库加载接口，用于在运行时动态加载可执行代码模块——这类模块在不同系统中有不同的称呼：Windows下称为「DLL」，Linux下称为「共享库（.so）」，macOS下称为「动态库（.dylib）」等。使用流程：编译生成共享库文件；调用SDL_LoadObject()加载该共享库；通过SDL_LoadFunct… -
SDL3_API分类参考_位操作（CategoryBits）
位操作子系统（CategoryBits）SDL提供了用于操作二进制位和位掩码的工具函数，简化常见的位运算逻辑实现。函数SDL_HasExactlyOneBitSet32：检测32位无符号整数中是否恰好只有1个位被置1（返回非0表示是，0表示否；0值返回0）SDL_MostSignificantBitIndex32：获取32位无符号整数中最高有效位（最左侧置1的位）的索引（如0x80000000返回… -
SDL3_API分类参考_字节序（CategoryEndian）
字节序子系统（CategoryEndian）SDL提供了用于转换特定字节序数值的函数，可实现不同字节序（大小端）之间的转换。这些函数分为两类：无条件字节序交换（SDL_Swap16、SDL_Swap32、SDL_Swap64、SDL_SwapFloat）：无论当前系统字节序如何，始终反转数值的字节顺序；与系统原生字节序互转（SDL_Swap16LE/SDL_Swap16BE、SDL_Swap32L…