内容能力示例
这一页不是教程,是验收页:下面每个块都对应一项已接入的渲染能力。写文档时照抄结构即可,不需要改任何配置。
提示框
用途
提示框用于给结论加限定条件(「以当前版本源码为准」这类),不要用它承载正文主线。
不要叠加
同一个位置连续放两个提示框会打断阅读节奏;需要并列说明时用列表。
代码块:行高亮与行号
void FSceneRenderer::PrepareView()
{
// 高亮行用来指出「要盯住的那几行」,不是整段都重要
for (FViewInfo& View : Views)
{
View.ViewFrustum = BuildFrustum(View);
View.PrimitiveVisibilityMap.Reset();
}
VisibilityFlags.SetNumZeroed(Primitives.Num());
ParallelFor(Primitives.Num(), [&](int32 Index) {
VisibilityFlags[Index] = TestFrustum(Primitives[Index]) ? 1 : 0;
});
}
Tabs:同一件事的两种视角
- 渲染线程
- RHI 线程
可见性判定在渲染线程完成,结果写进按视图索引的标记数组。这里只做判定,不产生绘制命令。
绘制命令由后续阶段生成,再交给 RHI 线程提交。两个线程之间靠命令列表交接,不共享可变状态。
Mermaid:流程图
KaTeX:公式
行内公式用来写判据,例如「点在视锥内」可以写成 ;独立公式用于推导:
公式与代码块一样,属于结论的支撑,不要用来代替解释。
宽表格
横向滚动由样式兜底,表格再宽也不会把整页撑出横向滚动条:
| 阶段 | 输入 | 输出 | 所在线程 | 典型耗时来源 | 可否并行 | 调试入口 |
|---|---|---|---|---|---|---|
| 视图准备 | FSceneView / FViewInfo | 视锥平面、裁剪矩阵、遮挡查询历史 | 渲染线程 | 视图数量与遮挡查询回读 | 否(依赖前置结果) | FSceneRenderer::PrepareView |
| 视锥剔除 | Primitive 集合 + 包围盒 | 通过 / 拒绝的位标记 | 渲染线程 | Primitive 数量 × 包围盒测试成本 | 是(按索引区间切分) | VisibilityFlags 槽位 |
| 相关性计算 | 通过剔除的 Primitive | 每视图可见性标记、静态网格批次 | 渲染线程 | 材质与 LOD 相关性判定 | 是(局部缓冲 + 归并) | ComputeRelevance |
| 命令生成 | 可见集合 | FMeshDrawCommand | 渲染线程 → RHI | 绘制状态排序与缓存命中 | 部分 | MeshPassProcessor |