DirectX 11实例化绘制2D瓦片图形黑屏问题排查及问询

实例化绘制黑屏问题排查 #

针对单个实例正常、多实例黑屏的情况，优先排查以下几个关键点：

1. 绘制参数校验 #

检查DrawIndexedInstanced的参数是否正确：

// 示例：绘制2个实例，单个四边形用6个索引
pContext->DrawIndexedInstanced(6, 2, 0, 0, 0);

注意第二个参数是实例数量，别和索引数搞混；起始实例偏移设为0确保从第一个实例开始绘制。

2. 实例缓冲配置检查 #

确保实例缓冲的创建参数符合要求：

D3D11_BUFFER_DESC instBufDesc = {};
instBufDesc.Usage = D3D11_USAGE_DYNAMIC; // 动态更新用DYNAMIC，静态用DEFAULT
instBufDesc.ByteWidth = sizeof(InstanceData) * maxInstanceCount;
instBufDesc.BindFlags = D3D11_BIND_VERTEX_BUFFER;
instBufDesc.CPUAccessFlags = D3D11_CPU_ACCESS_WRITE; // 动态缓冲需要CPU写权限

如果是静态实例数据，Usage设为D3D11_USAGE_DEFAULT，CPUAccessFlags设为0。

3. 输入布局（Input Layout）正确性 #

实例化相关的输入元素必须配置为每实例数据：

D3D11_INPUT_ELEMENT_DESC inputLayout[] = {
    // 顶点数据（每顶点更新）
    {"POSITION", 0, DXGI_FORMAT_R32G32B32_FLOAT, 0, 0, D3D11_INPUT_PER_VERTEX_DATA, 0},
    {"TEXCOORD", 0, DXGI_FORMAT_R32G32_FLOAT, 0, 12, D3D11_INPUT_PER_VERTEX_DATA, 0},
    // 实例数据（每实例更新）
    {"INSTANCE_POS", 0, DXGI_FORMAT_R32G32_FLOAT, 1, 0, D3D11_INPUT_PER_INSTANCE_DATA, 1}
};

注意实例数据的InputSlotClass为D3D11_INPUT_PER_INSTANCE_DATA，InstanceDataStepRate设为1；顶点数据用D3D11_INPUT_PER_VERTEX_DATA，InstanceDataStepRate为0。

4. HLSL着色器数据接收 #

确保顶点着色器中正确接收实例化数据，且语义名称和输入布局完全一致：

struct VSInput {
    float3 pos : POSITION;
    float2 uv : TEXCOORD0;
    float2 instancePos : INSTANCE_POS; // 必须和输入布局的语义名完全匹配（含大小写）
};

float4 VS(VSInput input) : SV_POSITION {
    float4 worldPos = float4(input.pos.x + input.instancePos.x, input.pos.y + input.instancePos.y, 0.0f, 1.0f);
    return mul(worldPos, projectionMatrix);
}

5. 实例数据填充验证 #

如果是动态缓冲，检查Map/Unmap过程中数据是否正确写入：

D3D11_MAPPED_SUBRESOURCE mappedData;
pContext->Map(pInstanceBuffer, 0, D3D11_MAP_WRITE_DISCARD, 0, &mappedData);
InstanceData* pInstData = (InstanceData*)mappedData.pData;
// 填充两个实例的位置数据
pInstData[0] = {100.0f, 100.0f};
pInstData[1] = {200.0f, 200.0f};
pContext->Unmap(pInstanceBuffer, 0);

避免数据未初始化、越界写入的情况。

技术疑问解答 #

1. 每帧绑定资源是否高效？仅在资源变更时绑定是否可行？ #

每帧重复绑定相同资源会产生冗余开销，但D3D11驱动会对重复绑定做一定优化（直接忽略无意义的重复调用）。优先只在资源变更时绑定：

• 若只是缓冲数据更新（比如实例位置变化，但缓冲对象没换），只需更新缓冲数据，无需重新绑定；
• 若切换了不同的资源（比如换纹理、换顶点格式），再重新绑定对应资源；
• 输入布局、渲染目标等状态即使没变化，绘制前绑定也不会有太大问题，但尽量减少冗余操作更优。

2. 实例缓冲大小固定，如何处理数量动态变化的对象？重建缓冲开销如何？ #

推荐三种方案：

• 预分配足够大的缓冲：按最大可能的实例数创建缓冲，每帧仅更新需要的实例数据，绘制时传入实际实例数给DrawIndexedInstanced。这是性能最优的方案，避免重建开销。
• 动态缓冲更新：使用D3D11_USAGE_DYNAMIC类型的缓冲，每帧通过Map（用D3D11_MAP_WRITE_DISCARD或D3D11_MAP_WRITE_NO_OVERWRITE）写入当前帧的实例数据，无需重建缓冲，只要缓冲大小能容纳当前实例数即可。
• 动态重建缓冲：仅在实例数超出预分配缓冲大小的极端场景下使用。重建缓冲（销毁旧缓冲+创建新缓冲）会有明显开销，涉及GPU资源的分配与释放，频繁重建会严重影响性能，尽量避免。

3. HLSL中的语义名称是否大小写不敏感？ #

HLSL的语义名称是严格大小写敏感的。比如POSITION和position会被视为不同语义，输入布局中的语义名称必须和HLSL代码中的完全一致（包括大小写），否则会导致数据无法正确传递，这也是实例化绘制黑屏的常见诱因。

内容的提问来源于stack exchange，提问作者Theo