# 玄铁渲染库

> 详细教程、完整 API 参考与示例代码请参阅：[09_渲染库编程指南.md](../09_渲染库编程指南.md)
>
> 底层基于 raylib 6.0，专注桌面 2D 渲染。引入方式：`引 "../lib/渲染/渲染.xt" 予 R`

## 核心 API 概览

| 类别 | 代表性 API |
|------|-----------|
| 窗口 | `R.初始化窗口(宽, 高, "标题")`、`R.窗口应关闭?()`、`R.关闭窗口()` |
| 帧控制 | `R.开始绘图()`、`R.结束绘图()`、`R.清背景(r, g, b, a)` |
| 形状 | `R.绘直线`、`R.绘矩形`、`R.绘圆`、`R.绘椭圆`、`R.绘三角`、`R.绘多边形` |
| 文字 | `R.绘文字`、`R.绘帧率`、`R.量文字` |
| 字体 | `R.加载字体`、`R.加载字体精准`、`R.绘字体文字`、`R.量字体文字`、`R.释字体` |
| 纹理 | `R.加载纹理`、`R.绘纹理`、`R.绘纹理Ex`、`R.释纹理` |
| 输入 | `R.键按下?`、`R.键刚按下?`、`R.鼠标按下?`、`R.鼠X/Y` |
| 音频 | `R.加载音效`、`R.播音效`、`R.加载音乐流`、`R.播音乐流` |
| 工具 | `R.取随机数`、`R.取运行时间`、`R.暂停` |

## 字体模式选择

| 模式 | API | 纹理 | 适用场景 |
|------|-----|------|---------|
| 全范围 | `加载字体(路径, 字号)` | ~8192×4096 | 任意中文，不预知字符集 |
| 精准 | `加载字体精准(路径, 字号, "参考文本")` | ~256×256 | 已知渲染内容，追求清晰与轻量 |

**注意**：支持 `.ttf`/`.otf`/`.ttc`（`.ttc` 取容器内第 1 个 face）。

## 快速示例

```xuantie
引 "../lib/渲染/渲染.xt" 予 R

R.初始化窗口(800, 600, "示例")
设 字体 = R.加载字体精准("assets/font.ttf", 24, "你好世界")

当 非 R.窗口应关闭?() {
    R.开始绘图()
    R.清背景(20, 20, 40, 255)
    R.绘字体文字(字体, "你好世界", 100, 100, 24, 2, 255, 255, 255, 255)
    R.绘帧率(700, 20)
    R.结束绘图()
}

R.释字体(字体)
R.关闭窗口()
```