首页教程和帮助列表
  • SDL3_API分类参考_混合模式(CategoryBlendmode)

    混合模式子系统(CategoryBlendmode)混合模式用于定义两种颜色的混合规则:SDL既提供满足基础需求的标准混合模式,也支持创建自定义混合模式(可指定对颜色分量执行的数学运算规则)。函数SDL_ComposeCustomBlendMode:组合自定义混合模式(指定源因子、目标因子、混合运算,生成自定义SDL_BlendMode)数据类型SDL_BlendMode:混合模式类型(包含标准模…
  • SDL3_API分类参考_像素管理(CategoryPixels)

    像素管理子系统(CategoryPixels)SDL提供一套完整的像素管理工具集,核心聚焦于像素格式的处理——即解析一组二进制位具体代表的颜色含义。如果你仅需将像素理解为红、绿、蓝(RGB)及透明度(Alpha)的组合,相关操作会非常直观,且这种程度的认知足以满足多数游戏开发需求。但像素的实际定义远比这复杂:颜色空间:像素是特定颜色空间中颜色的表示形式,SDL主要支持两种颜色类型:RGB:由红、绿…
  • SDL3_API分类参考_2D渲染(CategoryRender)

    2D渲染子系统(CategoryRender)SDL2D渲染功能的头文件,该API专为简化2D图形绘制设计,核心特性如下:支持绘制基础图元:单点像素、单像素线条、填充矩形、纹理图像、2D多边形;图元绘制模式:不透明、混合、叠加(加法)模式;纹理绘制能力:支持不透明/混合/叠加模式,可添加颜色色调、透明度调制,也支持线性插值拉伸;设计目标:专注加速简单2D操作;若需3D多边形、粒子特效等高级功能,建…
  • SDL3_API分类参考_版本(CategoryVersion)

    版本子系统(CategoryVersion)用于查询SDL版本信息的功能集,可分别获取应用编译时依赖的头文件版本和运行时链接的库文件版本。函数SDL_GetRevision:获取SDL库的版本修订号(字符串形式,如git提交哈希)SDL_GetVersion:获取运行时链接的SDL库的版本号(填充SDL_version结构体,包含主/次/微版本)数据类型(无)结构体(无)枚举(无)宏SDL_MAJ…
  • SDL3_API分类参考_断言(CategoryAssert)

    断言子系统(CategoryAssert)SDL提供的增强型断言宏,功能远超常规的assert宏,核心特性如下:利用sizeof运算符特性:禁用的断言会从编译代码中完全移除,且仅在断言中引用的变量不会触发“未使用变量”的编译器警告;避免悬空else问题:支持if(x)SDL_assert(y);elsedo_something();这类写法,行为稳定;跨平台一致性:不依赖各平台编译器/C运行时的实…
  • SDL3_API分类参考_日志(CategoryLog)

    日志(CategoryLog)SDL提供的轻量级日志系统,支持为日志消息设置优先级和分类:日志的SDL_LogPriority(日志优先级)用于标识消息的重要程度;日志的SDL_LogCategory(日志分类)用于标识消息所属的功能域。每个日志分类都有预设的最低优先级阈值:只有当消息的优先级大于或等于该阈值时,这条日志才会被实际输出。SDL自身的日志默认输出优先级低于默认阈值,因此默认情况下不会…
  • SDL3_API分类参考_错误处理(CategoryError)

    错误处理(CategoryError)SDL提供的轻量级错误消息处理函数集。绝大多数应用程序只会通过一个核心函数与这些API交互:当几乎所有SDL函数调用返回失败时,你可以通过SDL_GetError()获取该错误对应的人类可读字符串描述。这些错误字符串是按线程独立维护的,应用程序也可以自定义错误信息(这在基于SDL构建供其他应用使用的库时非常常用),只需调用SDL_SetError()即可设置自…
  • SDL3_API分类参考_对象属性(CategoryProperties)

    对象属性(CategoryProperties)属性(Property)是一种可以在运行时通过名称创建和获取的变量。所有属性都属于一个属性组(属性组ID:SDL_PropertiesID)。属性组可通过SDL_CreateProperties函数创建,通过SDL_DestroyProperties函数销毁。可通过以下函数向属性组添加/获取属性:SDL_SetPointerProperty/SDL_…
  • SDL3_API分类参考_配置变量(CategoryHints)

    配置变量(CategoryHints)本文件包含用于设置和获取配置提示(Hint)的函数,并按字母顺序列出所有提示项。提示的命名规范为SDL_HINT_X,其中SDL_X是可用于覆盖默认值的环境变量名。通常来说,这些提示仅作参考——在特定平台上可能被支持也可能不适用,但它们为应用程序或用户提供了一种向库告知期望运行方式的途径。函数SDL_AddHintCallback-为指定提示添加值变更时的回调…
  • SDL3_API分类参考_初始化与退出(CategoryInit)

    初始化与退出(CategoryInit)所有SDL程序在开始使用该库之前都需要先初始化它。几乎所有程序都可以在启动时简单调用SDL_Init()函数,并通过少量标志位指定要启用的子系统。这些标志位的作用是确保SDL不会尝试去访问你并不打算使用的操作系统底层组件。例如,你可能使用SDL处理视频和输入,但选择第三方库处理音频,这种情况下只需省略SDL_INIT_AUDIO标志位,就能确保第三方音频库获…