引入 Gfx::DrawContext 统一绘制入口，封装FrameBuffer/DepthBuffer/Rasterizer/角形光栅化；main.cpp 改用 DrawContext；同步更新文档路径

docs/APP_AND_GFX_ARCHITECTURE.md

@@ -10,15 +10,20 @@
 IMX6U-Game/
 ├─ src/
 │  ├─ Gfx/                 # 底层图形库：可复用、无具体游戏规则
-│  │  ├─ Core/             # FrameBuffer、DepthBuffer、RendererContext
-│  │  ├─ Draw2D/           # rect、quad、line、sprite、tile 等基础绘制
-│  │  ├─ Math/             # 定点数、向量、矩阵、几何工具
-│  │  ├─ RenderData/       # Color、Rect、Quad、Texture、Vertex 等数据结构
-│  │  └─ Platform/         # SDL2 / fb0 / input / timer 的平台适配
+│  │  ├─ Draw2D/           # DrawContext 统一绘制入口（✅ 已实现）
+│  │  ├─ Core/             # FrameBuffer、DepthBuffer（✅ 已实现）
+│  │  ├─ Math/             # 向量、矩阵、数学工具（✅ 已实现）
+│  │  ├─ Rasterizer/       # 线段、三角形光栅化（✅ 已实现）
+│  │  ├─ RenderData/       # Color、Triangle 等数据结构（✅ 已实现）
+│  │  ├─ Scene/            # Camera、Transform（✅ 已实现）
+│  │  ├─ Shading/          # 着色器（预留）
+│  │  ├─ Platform/         # SDL2 / fb0 平台适配（✅ 已实现）
+│  │  └─ Asset/            # 资源加载（✅ 已实现）
 │  ├─ Apps/
-│  │  ├─ Launcher/         # 启动器应用
-│  │  ├─ GameA/            # 第一个游戏
-│  │  └─ GameB/            # 第二个游戏
+│  │  ├─ Demo/             # 当前 3D 立方体 demo（✅ 已实现）
+│  │  ├─ Launcher/         # 启动器应用（待实现）
+│  │  ├─ GameA/            # 第一个游戏（待实现）
+│  │  └─ GameB/            # 第二个游戏（待实现）
 │  └─ Shared/              # 可选：应用层共享但不属于 Gfx 的东西
 │     ├─ Save/             # 存档格式、配置读写
 │     ├─ UI/               # 启动器和游戏共用 UI 组件
@@ -31,7 +36,9 @@ IMX6U-Game/
 └─ docs/
 ```
 
-当前项目已有 `Core/Math/Platform/Rasterizer/RenderData/Scene` 等目录，短期不必一次性搬迁；但新增代码应按上面的边界收敛。等功能稳定后，再把现有底层代码整体移动到 `src/Gfx/`。
+~~当前项目已有 `Core/Math/Platform/Rasterizer/RenderData/Scene` 等目录，短期不必一次性搬迁；但新增代码应按上面的边界收敛。等功能稳定后，再把现有底层代码整体移动到 `src/Gfx/`。~~
+
+**已完成**：底层代码已整体迁移到 `src/Gfx/`，包括 Core、Math、Rasterizer、RenderData、Scene、Shading、Platform、Asset 和新增的 Draw2D。Demo 入口位于 `src/Apps/Demo/`。
 
 ## 2. 四个层级的职责
 
@@ -201,13 +208,14 @@ namespace Gfx
 
 ## 7. 推荐演进顺序
 
-1. 先抽出统一 `IApp` 和 `AppManager`，让当前 demo 成为一个 app。
-2. 把 SDL2 初始化、输入、present 固定在平台层，应用层不直接碰 SDL。
-3. 建立 `Gfx::DrawContext`，先封装 clear、pixel、line、rect、quad。
-4. 新增 Launcher app，只做最小菜单和应用切换。
-5. 新增 GameA/GameB 空壳，验证三应用切换。
-6. 再逐步把现有 3D demo 或 2D 游戏逻辑迁入对应 Game 目录。
-7. 最后重构 CMake，按 `imx6u_gfx` + 应用 target 拆分。
+1. ~~先抽出统一 `IApp` 和 `AppManager`，让当前 demo 成为一个 app。~~
+2. ~~把 SDL2 初始化、输入、present 固定在平台层，应用层不直接碰 SDL。~~
+3. ~~建立 `Gfx::DrawContext`，先封装 clear、pixel、line、rect、quad。~~ **已完成**（`Gfx::DrawContext` 封装了 clear、draw_line、draw_triangle、present）
+4. ~~底层代码迁移到 `src/Gfx/`，Demo 入口迁移到 `src/Apps/Demo/`。~~ **已完成**
+5. 新增 Launcher app，只做最小菜单和应用切换。
+6. 新增 GameA/GameB 空壳，验证三应用切换。
+7. 再逐步把现有 3D demo 或 2D 游戏逻辑迁入对应 Game 目录。
+8. 最后重构 CMake，按 `imx6u_gfx` + 应用 target 拆分。
 
 ## 8. 性能注意事项
 

docs/DEVELOPMENT_GUIDELINES.md

@@ -9,7 +9,7 @@
 - **先按 IMX6U 运行时成本设计，再按 PC 调试便利包装。** Windows/Linux SDL 版本只是验证与调试入口，不代表最终性能预算。
 - **热路径默认禁止隐式高成本操作。** 每帧、每对象、每顶点、每像素级代码必须避免动态分配、浮点、虚函数链、复杂 STL 算法和异常控制流。
 - **核心逻辑保持 C++11 兼容。** 不引入需要新工具链或重型运行时支持的语言/库特性。
-- **优先复用已有类型与缓冲。** 新增抽象前先确认 `src/Core`、`src/Math`、`src/RenderData` 中是否已有可复用能力。
+- **优先复用已有类型与缓冲。** 新增抽象前先确认 `src/Gfx/Core`、`src/Gfx/Math`、`src/Gfx/RenderData` 中是否已有可复用能力。
 - **性能相关例外必须写明边界。** 如果必须违反本文红线，需要在代码附近注释说明原因、调用频率、数据规模和替代方案。
 
 ## 2. 数值计算规范
@@ -124,13 +124,13 @@
 - [ ] 是否把平台/显示层 API 类型泄漏进核心逻辑？
 - [ ] 是否能在 PC 调试版和 ARM release 版分别关闭调试开销？
 - [ ] 是否保留 C++11 兼容？
-- [ ] 是否需要同步更新 `src/CONVENTIONS.md` 中的坐标/矩阵/深度等约定？
+- [ ] 是否需要同步更新 `docs/CONVENTIONS.md` 中的坐标/矩阵/深度等约定？
 
 ## 9. 推荐的代码结构方向
 
 后续如果继续推进性能优化，优先建立这些基础设施：
 
-1. 统一定点数类型与转换工具，集中放在 `src/Math/`。
+1. 统一定点数类型与转换工具，集中放在 `src/Gfx/Math/`。
 2. 帧级临时缓冲/工作区，集中管理可复用数组和 scratch memory。
 3. 渲染数据的运行时紧凑格式，区分“加载期模型数据”和“运行时渲染数据”。
 4. ARM release 配置下的性能开关，关闭日志、调试绘制和昂贵检查。
@@ -150,8 +150,8 @@
 
 ### 11.1 SDL2 边界
 
-- SDL2 类型和调用只允许出现在 `src/Platform/` 以及明确的平台适配层中。
-- `src/Core`、`src/Math`、`src/Rasterizer`、`src/RenderData`、`src/Scene` 不应直接包含 `SDL.h`。
+- SDL2 类型和调用只允许出现在 `src/Gfx/Platform/` 以及明确的平台适配层中。
+- `src/Gfx/Core`、`src/Gfx/Math`、`src/Gfx/Rasterizer`、`src/Gfx/RenderData`、`src/Gfx/Scene`、`src/Gfx/Draw2D` 不应直接包含 `SDL.h`。
 - 游戏逻辑不直接处理 `SDL_Event`，应转换为项目自己的输入状态结构。
 - 时间源可以来自 SDL，但核心逻辑使用整数 tick / fixed timestep，不直接依赖 float 秒数。