docs: rebuild Rendering API content

This commit is contained in:
2026-03-26 21:32:43 +08:00
parent f6286d432c
commit 5c8042775c
81 changed files with 2350 additions and 27 deletions

View File

@@ -0,0 +1,38 @@
# RenderResourceCache::GetOrCreateMesh
获取或创建某个 `Mesh` 的 GPU 缓存。
```cpp
const CachedMesh* GetOrCreateMesh(RHI::RHIDevice* device, const Resources::Mesh* mesh);
```
## 行为说明
当前实现会:
1. 检查 `device``mesh``mesh->IsValid()`
2. 若缓存已存在,直接返回。
3. 否则上传顶点/索引数据并创建对应 view。
4. 把结果放入 `m_meshCache` 并返回。
## 参数
- `device` - 用于创建 GPU buffer 与 view 的设备。
- `mesh` - 要缓存的网格资源。
## 返回值
- 成功时返回 `CachedMesh*`
- 失败时返回 `nullptr`
## 当前实现限制
- 当前不会检测 mesh 数据后续是否被修改。
- 当前要求顶点数据非空、`vertexStride > 0`
- 若上传过程中途失败,会清理当前临时创建的资源,但不会记录失败原因。
## 相关文档
- [返回类型总览](RenderResourceCache.md)
- [GetOrCreateTexture](GetOrCreateTexture.md)
- [BuiltinForwardPipeline](../Pipelines/BuiltinForwardPipeline/BuiltinForwardPipeline.md)