跳到主要内容
版本:5.8

内容能力示例

这一页不是教程,是验收页:下面每个块都对应一项已接入的渲染能力。写文档时照抄结构即可,不需要改任何配置。

提示框​

用途

提示框用于给结论加限定条件(「以当前版本源码为准」这类),不要用它承载正文主线。

不要叠加

同一个位置连续放两个提示框会打断阅读节奏;需要并列说明时用列表。

代码块:行高亮与行号​

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:同一件事的两种视角​

可见性判定在渲染线程完成,结果写进按视图索引的标记数组。这里只做判定,不产生绘制命令。

Mermaid:流程图​

KaTeX:公式​

行内公式用来写判据,例如「点在视锥内」可以写成 n⋅p+d>0\mathbf{n}\cdot\mathbf{p} + d > 0;独立公式用于推导:

visible(p)=⋀i=16(ni⋅p+di≥0)\text{visible}(p) = \bigwedge_{i=1}^{6}\left(\mathbf{n}_i \cdot \mathbf{p} + d_i \ge 0\right)

公式与代码块一样,属于结论的支撑,不要用来代替解释。

宽表格​

横向滚动由样式兜底,表格再宽也不会把整页撑出横向滚动条:

阶段输入输出所在线程典型耗时来源可否并行调试入口
视图准备FSceneView / FViewInfo视锥平面、裁剪矩阵、遮挡查询历史渲染线程视图数量与遮挡查询回读否(依赖前置结果)FSceneRenderer::PrepareView
视锥剔除Primitive 集合 + 包围盒通过 / 拒绝的位标记渲染线程Primitive 数量 × 包围盒测试成本是(按索引区间切分)VisibilityFlags 槽位
相关性计算通过剔除的 Primitive每视图可见性标记、静态网格批次渲染线程材质与 LOD 相关性判定是(局部缓冲 + 归并)ComputeRelevance
命令生成可见集合FMeshDrawCommand渲染线程 → RHI绘制状态排序与缓存命中部分MeshPassProcessor