渲染库是什么玄铁渲染库是官方桌面 2D 渲染库基于 raylib 桥接渲染桥渲染桥.c封装平台窗口系统函数以R.前缀调用。raylib 本身是跨平台库Windows /macOS/ Linux 均支持玄铁渲染库在其上提供中文 API。Windows 侧渲染桥走 Win32 / GDImacOS / Linux 侧走 raylib 原生 API。快速上手引 渲染 予 R 设 窗口宽 800 设 窗口高 600 R.初始化窗口(窗口宽, 窗口高, 示例窗口) R.设ESC关闭(真) 当 非 R.窗口应关闭?() { R.开始绘图() R.清背景(...) R.结束绘图() } R.关闭窗口()窗口与绘图 API函数说明R.初始化窗口(宽, 高, 标题)创建窗口必须在其他渲染调用前执行R.设ESC关闭(真)按 ESC 是否退出主循环R.窗口应关闭?()主循环退出条件判断R.开始绘图()/R.结束绘图()一帧绘制的开始 / 结束R.清背景(颜色)清屏填充背景R.截图(路径)保存当前画面为图片R.关闭窗口()关闭窗口并释放资源字体系统玄铁渲染库的字体加载分三条路径加载方式用法说明默认字体直接用R.绘文字(文本, 位置, 字号, 颜色)raylib 内置位图字体仅拉丁字符无中文加载系统字体R.加载系统字体(字体名, 字号)Windows 走系统字体直取macOS 已适配 Apple TTC 字体容器宋体 / 楷体等中文渲染正常加载字体文件R.加载字体(路径, 字号)直接加载 ttf /ttc 字体文件支持中文加载字体精准R.加载字体精准(路径, 字号, 参考文本)按参考文本裁剪字形加载更精确实测要点中文显示依赖字体文件或系统字体通道默认字体不含中文字形画中文显示方块。macOS 侧加载系统字体如「宋体」「楷体」已修复Apple TTC 字体容器重组、伪成功消除中文渲染正常。字体加载必须在R.初始化窗口之后GPU 上下文就绪开窗前加载中文画不出来。字体池有上限实测为 8 个句柄超限返回空句柄。图片纹理格式支持状态macOS 实测PNG支持BMP支持GIF支持JPG不支持解码缺失需转 PNGTGA不支持纹理操作R.加载纹理(路径)、R.量纹理宽/高(句柄)判断加载成败解码失败时句柄语义需按「纹理尺寸为 0」判断已知问题上游处理中。音效与音乐R.加载音效(路径)、R.加载音乐流(路径)加载音频资源wav 等返回句柄播放 / 停止 / 释放。音频句柄按槽位池管理与纹理、字体一致不返回裸指针。平台适配现状平台状态Windows主力平台完整支持Win32 / GDImacOS arm64已适配渲染桥平台分支、字体 TTC 中文通道、关窗语义对齐Linux走 raylib 原生路径随跨平台适配同步已知问题渲染库链接在 macOS 需手动指定 raylib 与系统框架Cocoa / OpenGL / IOKit / CoreVideo工具链侧有抓取中间产物 手动链接的绕行方案。声明式 UI 库玄铁在渲染库上层提供声明式 UI 库桌面组件按钮、布局等。已知事实UI 默认主题支持按钮三态普通 / 悬浮 / 按下、圆角 8px内置鸿蒙字体实现零配置中文显示。UI 层 API 细节请查阅官方文档仓库 GUIDE/ 目录的渲染库与 UI 编程指南本篇未展开。参考官方 GitHub 仓库https://github.com/MARKJY-China/XuanTie-Lang渲染库仓库https://atomgit.com/MARKJY/XuanTieRendering官方文档仓库 GUIDE/ 目录09_渲染库编程指南