docs: rebuild Rendering API content
This commit is contained in:
@@ -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)
|
||||
Reference in New Issue
Block a user