XCEngine/docs/api/XCEngine/Rendering/Pipelines/BuiltinForwardPipeline/BuildInputLayout.md

BuiltinForwardPipeline::BuildInputLayout

命名空间: XCEngine::Rendering::Pipelines

类型: method

头文件: XCEngine/Rendering/Pipelines/BuiltinForwardPipeline.h

返回这条前向管线当前硬编码使用的静态网格顶点布局。

static RHI::InputLayoutDesc BuildInputLayout();

当前实现返回值

当前固定返回 3 个顶点元素：

1. POSITION
   • 格式: R32G32B32_Float
   • semanticIndex = 0
   • inputSlot = 0
   • alignedByteOffset = 0
2. NORMAL
   • 格式: R32G32B32_Float
   • offset: offsetof(Resources::StaticMeshVertex, normal)
3. TEXCOORD
   • 格式: R32G32_Float
   • offset: offsetof(Resources::StaticMeshVertex, uv0)

最需要注意的一点是：

• 位置当前是 float3，不是旧实现或旧文档里写过的 float4

这已经由 tests/Rendering/unit/test_builtin_forward_pipeline.cpp 明确校验。

当前语义

这个方法定义的不是“通用顶点布局建议”，而是 BuiltinForwardPipeline 当前真正依赖的 mesh 输入契约。

换句话说：

• 只要你还在用这条 builtin forward pipeline，就必须保证顶点数据与 StaticMeshVertex 的布局兼容
• 如果你需要不同的顶点流或额外属性，更合理的做法通常是创建新的 pipeline，而不是继续复用这条 builtin 管线

返回值

• RHI::InputLayoutDesc - 可直接写入图形管线描述的输入布局

相关文档

• BuiltinForwardPipeline
• Render