如何在DX9 HLSL的GS中声明并实现Stream Output逻辑
DX9 环境下 HLSL 实现 Geometry Shader 阶段 Stream Output 逻辑编写指南
和DX10+的实现差异(DX9专属注意点)
- DX9没有独立的Stream Output着色器签名层,GS的输出语义顺序 就是写入SO缓冲的内存排布顺序,没有额外的元数据做格式转换,这是最容易踩坑的设计。
- 只有编译为
gs_4_0_level_9_3兼容目标的GS才支持DX9设备上的Stream Output特性,原生SM3.0的编译目标没有对应的流写入能力。 - GS里的流写入接口是内置的
inout流参数,不需要额外加标记告诉编译器哪个流要写SO,驱动会根据运行时的设备绑定状态,自动把对应流的数据写入匹配的SO缓冲。
标准代码实现流程
- 先对齐内存布局
先在C++侧确定SO缓冲的顶点元素排布顺序(比如 位置float3 -> 法线float3 -> 纹理坐标float2),再在HLSL里完全按照这个顺序定义GS的输出结构,不要随意调换语义顺序。 - 编写完整的GS逻辑
以下是和上述布局匹配的可直接运行的代码示例:
// GS输入:对应上游顶点着色器传递的图元顶点数据 struct VS2GS { float4 clipPos : SV_POSITION; float3 worldPos: POSITION; float3 normal : NORMAL; float2 uv : TEXCOORD0; }; // GS输出:顺序严格匹配SO缓冲的顶点布局 struct GS2SO { float3 outPos : POSITION; // 对应SO缓冲第0个元素:世界空间位置 float3 outNrm : NORMAL; // 对应SO缓冲第1个元素:顶点法线 float2 outUV : TEXCOORD0; // 对应SO缓冲第2个元素:纹理坐标 }; // 声明GS单次图元处理最大顶点输出数 [maxvertexcount(3)] void main( triangle VS2GS inputGeom[3], // 几何流参数,就是绑定SO缓冲的写入入口 inout TriangleStream<GS2SO> soStream ) { // 遍历输入图元的每个顶点,执行自定义GS处理逻辑 for (uint idx = 0; idx < 3; idx++) { GS2SO outputVert; // 替换为你自己的处理逻辑,比如顶点拆分、空间变换 outputVert.outPos = inputGeom[idx].worldPos; outputVert.outNrm = inputGeom[idx].normal; outputVert.outUV = inputGeom[idx].uv; // 把顶点追加到SO流,直接写入绑定的SO缓冲 soStream.Append(outputVert); } // 生成条带类图元时可调用该接口重启条带连接 soStream.RestartStrip(); }
常见实现坑点
- 不要往GS输出结构里加多余的语义:每加一个语义,驱动就会按照对应的精度类型往SO缓冲里写对应大小的数据,冗余字段会直接打乱预先分配的SO缓冲内存,造成越界写入。
- 不要把需要送光栅化的屏幕空间输出和SO输出混在同一个结构里:如果GS既要把数据写SO,又要直接送光栅化,需要分两个独立的流参数,不然写入SO的顶点数据会被当成光栅化输入,出现屏幕空间坐标错乱的问题。
- 编译GS的时候不要开启输出签名剥离:用
fxc编译时去掉反射信息会让驱动无法对齐SO缓冲的写入偏移,常见症状是SO缓冲里全是0或者随机内存值。 - 写入SO的顶点不需要带
SV_POSITION语义:这些顶点是给后续渲染阶段当输入顶点用的,不是直接送光栅化的屏幕空间坐标,用普通的POSITION语义即可,不会触发特殊的光栅化处理逻辑。 - 合理设置
maxvertexcount的数值:这个数值是驱动给流分配内存的上限,设置太大浪费显存,设置太小会截断写入的顶点数据。
内容的提问来源于stack exchange,提问作者H CHAITHANYA
相关产品推荐
相关产品推荐

