欢迎来到 Fgui（Fair GUI Library for SDL3）的文档中心！
Fgui 是一个基于 SDL3 的轻量级 GUI 库，内置脏区重绘优化、丰富的控件集、可自定义配色与自定义控件能力，专为快速开发 SDL3 游戏/工具界面而设计。
注意：以下文档均以库当前源码（
include/Fgui/）为准，与你工作区中的代码一一对应。
- 00 - 快速开始 —— 5 分钟跑通第一个 Fgui 窗口
- 01 - 构建与项目结构 —— CMake 构建、目录结构、依赖与包含顺序
- 02 - 核心架构 ——
Fgui_Control基类、渲染/事件/定时器三套机制、脏区重绘原理 - 03 - ControlBox 与布局 —— 容器、子控件管理、自动滚动与滚动条、平滑滚动
- 04 - 控件参考（上）：基础控件 ——
StaticText/PushButton/LinkText/CheckBox/ToggleButton/RadioButton/PictureBox/Slider - 05 - 控件参考（下）：复杂控件 ——
ScrollBar/InputBox/ComboBox/ProgressBar/TabControl/QRCodeBox
- 06 - 图形绘制 API —— 文本、圆形/圆角矩形、渐变、气泡、3D 表面等绘制函数
- 07 - 配色与主题 ——
Fgui_ColorKit与内置配色预设 - 08 - 自定义控件 —— 继承
Fgui_Control实现自己的控件 - 09 - 示例教程：文本编辑器 —— 基于示例
001_TextEditor.cpp的完整实战 - 10 - 常见问题与陷阱 —— 坐标约定、包含顺序、性能等常见坑
| 你想做什么 | 看这里 |
|---|---|
| 跑通示例 | 快速开始 |
| 编译项目 | 构建与项目结构 |
| 理解渲染机制 | 核心架构 |
| 用某个控件 | 控件参考（上） / 控件参考（下） |
| 画圆角/渐变/文本 | 图形绘制 API |
| 换主题 | 配色与主题 |
| 写新控件 | 自定义控件 |
| 踩到坑了 | 常见问题与陷阱 |