docs: expand rendering core docs

docs/api/XCEngine/Rendering/RenderMaterialUtility/BuildBuiltinForwardMaterialData.md

@@ -0,0 +1,44 @@
+# BuildBuiltinForwardMaterialData
+
+**命名空间**: `XCEngine::Rendering`
+
+**类型**: `function`
+
+**头文件**: `XCEngine/Rendering/RenderMaterialUtility.h`
+
+## 签名
+
+```cpp
+BuiltinForwardMaterialData BuildBuiltinForwardMaterialData(const Resources::Material* material);
+```
+
+## 作用
+
+把 builtin forward 当前真正消费的材质常量打包成 `BuiltinForwardMaterialData`。
+
+## 当前实现行为
+
+当前实现非常窄，只做一件事：
+
+1. 构造默认的 `BuiltinForwardMaterialData`
+2. 用 [ResolveBuiltinBaseColorFactor](ResolveBuiltinBaseColorFactor.md) 填充 `baseColorFactor`
+3. 返回结果
+
+也就是说，当前 builtin forward 材质常量块里只公开收口了颜色因子，没有把纹理、采样器或其它材质属性打进这个 struct。
+
+## 当前语义边界
+
+- 这是 builtin forward 私有契约的一部分，不是通用材质序列化格式。
+- 贴图绑定不在这里返回；调用方仍需单独用 [ResolveBuiltinBaseColorTexture](ResolveBuiltinBaseColorTexture.md) 解析。
+- 如果未来 builtin forward 的 per-material 常量扩展，这个 helper 和 `BuiltinForwardMaterialData` 也会一起扩展。
+
+## 测试覆盖
+
+`tests/Rendering/unit/test_render_scene_extractor.cpp` 当前验证了它会按 canonical 名称和别名路径正确写入 `baseColorFactor`。
+
+## 相关文档
+
+- [ResolveBuiltinBaseColorFactor](ResolveBuiltinBaseColorFactor.md)
+- [ResolveBuiltinBaseColorTexture](ResolveBuiltinBaseColorTexture.md)
+- [BuiltinForwardPipeline](../Pipelines/BuiltinForwardPipeline/BuiltinForwardPipeline.md)
+- [RenderMaterialUtility](RenderMaterialUtility.md)