diff --git a/docs/api/XCEngine/Rendering/RenderMaterialUtility/BuiltinForwardMaterialData.md b/docs/api/XCEngine/Rendering/RenderMaterialUtility/BuiltinForwardMaterialData.md index 2eae09fb..cb03aee2 100644 --- a/docs/api/XCEngine/Rendering/RenderMaterialUtility/BuiltinForwardMaterialData.md +++ b/docs/api/XCEngine/Rendering/RenderMaterialUtility/BuiltinForwardMaterialData.md @@ -10,10 +10,10 @@ ## 概述 -`BuiltinForwardMaterialData` 不是通用 `Material` 常量缓冲格式。 +`BuiltinForwardMaterialData` 不是通用 `Material` 常量缓冲格式。 它当前只描述 builtin forward 兼容路径里最小的一份逐材质数据:`baseColorFactor`。 -[BuildBuiltinForwardMaterialData](BuildBuiltinForwardMaterialData.md) 负责生成它。 +[BuildBuiltinForwardMaterialData](BuildBuiltinForwardMaterialData.md) 负责生成它。 按当前 `BuiltinForwardPipeline` 实现,只有当 [ResolveSchemaMaterialConstantPayload](ResolveSchemaMaterialConstantPayload.md) 返回无效 view 时, 管线才会把这份数据拷贝进内部 `FallbackPerMaterialConstants`,再写入 `Material` 语义的 constant buffer。 diff --git a/docs/api/XCEngine/Rendering/RenderMaterialUtility/MaterialConstantPayloadView.md b/docs/api/XCEngine/Rendering/RenderMaterialUtility/MaterialConstantPayloadView.md index 8bf22c4a..5129cec9 100644 --- a/docs/api/XCEngine/Rendering/RenderMaterialUtility/MaterialConstantPayloadView.md +++ b/docs/api/XCEngine/Rendering/RenderMaterialUtility/MaterialConstantPayloadView.md @@ -10,7 +10,7 @@ ## 概述 -`MaterialConstantPayloadView` 只是一个轻量视图,不负责构造、复制或持有常量缓冲。 +`MaterialConstantPayloadView` 只是一个轻量视图,不负责构造、复制或持有常量缓冲。 按当前实现,它通常由 [ResolveSchemaMaterialConstantPayload](ResolveSchemaMaterialConstantPayload.md) 返回, 直接指向 `Material` 内部的 `constantBufferData` 数组。 @@ -38,7 +38,7 @@ constant buffer 的 set 上调用 `WriteConstant(binding, data, size)` 写入 de ## 测试覆盖 -`tests/Rendering/unit/test_render_scene_extractor.cpp` 当前验证了: +`tests/Rendering/unit/test_render_scene_extractor.cpp` 当前验证了: 当 `Material` 绑定 shader 并生成 `_BaseColor` 常量时, [ResolveSchemaMaterialConstantPayload](ResolveSchemaMaterialConstantPayload.md) 会返回有效的 `16` 字节 payload view。