Files
renderdoc/util/test/demos/d3d12/d3d12_subgroup_zoo.cpp
T
baldurk 856c838def Update copyright years to 2026 and fix copyright ranges
* In a previous update in 2021 many copyright ranges were truncated
  accidentally, and some files have been copy-pasted with wrong years. These
  dates have been fixed based on git history and original copyright messages.
2026-01-05 14:17:28 +00:00

673 lines
19 KiB
C++

/******************************************************************************
* The MIT License (MIT)
*
* Copyright (c) 2025-2026 Baldur Karlsson
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
******************************************************************************/
#include "3rdparty/fmt/core.h"
#include "d3d12_test.h"
RD_TEST(D3D12_Subgroup_Zoo, D3D12GraphicsTest)
{
static constexpr const char *Description =
"Test of behaviour around subgroup operations in shaders.";
const std::string common = R"EOSHADER(
cbuffer rootconsts : register(b0)
{
uint root_test;
}
#define IsTest(x) (root_test == x)
)EOSHADER";
const std::string pixelCommon = common + R"EOSHADER(
struct IN
{
float4 pos : SV_Position;
float4 data : DATA;
};
)EOSHADER";
const std::string compCommon = common + R"EOSHADER(
RWStructuredBuffer<float4> outbuf : register(u0);
static uint3 tid;
void SetOutput(float4 val)
{
outbuf[root_test * 1024 + tid.y * GROUP_SIZE_X + tid.x] = val;
}
)EOSHADER";
const std::string vertex = common + R"EOSHADER(
struct OUT
{
float4 pos : SV_Position;
float4 data : DATA;
};
OUT main(uint vert : SV_VertexID)
{
OUT ret = (OUT)0;
float2 positions[] = {
float2(-1.0f, 1.0f),
float2( 1.0f, 1.0f),
float2(-1.0f, -1.0f),
float2( 1.0f, -1.0f),
};
float scale = 1.0f;
if(IsTest(2))
scale = 0.2f;
ret.pos = float4(positions[vert]*float2(scale,scale), 0, 1);
ret.data = 0.0f.xxxx;
uint wave = WaveGetLaneIndex();
if(IsTest(0))
ret.data = float4(wave, 0, 0, 1);
else if(IsTest(3))
ret.data = float4(WaveActiveSum(wave), 0, 0, 0);
return ret;
}
)EOSHADER";
const std::string pixel = pixelCommon + R"EOSHADER(
float4 main(IN input) : SV_Target0
{
uint subgroupId = WaveGetLaneIndex();
float4 pixdata = 0.0f.xxxx;
if(IsTest(1) || IsTest(2))
{
pixdata = float4(subgroupId, 0, 0, 1);
}
else if(IsTest(4))
{
pixdata = float4(WaveActiveSum(subgroupId), 0, 0, 0);
}
else if(IsTest(5))
{
// QuadReadLaneAt : unit tests
pixdata.x = float(QuadReadLaneAt(subgroupId, 0));
pixdata.y = float(QuadReadLaneAt(subgroupId, 1));
pixdata.z = float(QuadReadLaneAt(subgroupId, 2));
pixdata.w = float(QuadReadLaneAt(subgroupId, 3));
}
else if(IsTest(6))
{
// QuadReadAcrossDiagonal, QuadReadAcrossX, QuadReadAcrossY: unit tests
pixdata.x = float(QuadReadAcrossDiagonal(subgroupId));
pixdata.y = float(QuadReadAcrossX(subgroupId));
pixdata.z = float(QuadReadAcrossY(subgroupId));
pixdata.w = QuadReadLaneAt(pixdata.x, 2);
}
else if(IsTest(7))
{
// QuadAny, QuadAll: unit tests
pixdata.x = float(QuadAny(subgroupId > 2));
pixdata.y = float(QuadAll(subgroupId < 10));
pixdata.z = float(QuadAny(pixdata.x == 0.0f));
pixdata.w = float(QuadAll(pixdata.x == 0.0f));
}
return input.data + pixdata;
}
)EOSHADER";
const std::string pixel67 = pixelCommon + R"EOSHADER(
float4 main(IN input) : SV_Target0
{
uint subgroupId = WaveGetLaneIndex();
float4 pixdata = 0.0f.xxxx;
if(IsTest(0))
{
// QuadAny, QuadAll: unit tests
pixdata.x = float(QuadAny(subgroupId > 2));
pixdata.y = float(QuadAll(subgroupId < 10));
pixdata.z = float(QuadAny(pixdata.x == 0.0f));
pixdata.w = float(QuadAll(pixdata.x == 0.0f));
}
return pixdata;
}
)EOSHADER";
const std::string comp = compCommon + R"EOSHADER(
[numthreads(GROUP_SIZE_X, GROUP_SIZE_Y, 1)]
void main(uint3 inTid : SV_DispatchThreadID)
{
float4 testResult = 0.0f.xxxx;
tid = inTid;
uint id = WaveGetLaneIndex();
SetOutput(id);
if(IsTest(0))
{
// Query functions : unit tests
testResult.x = float(WaveGetLaneCount());
testResult.y = float(WaveGetLaneIndex());
testResult.z = float(WaveIsFirstLane());
}
else if(IsTest(1))
{
// Vote functions : unit tests
testResult.x = float(WaveActiveAnyTrue(id*2 > id+10));
testResult.y = float(WaveActiveAllTrue(id < WaveGetLaneCount()));
if (id > 10)
{
testResult.z = float(WaveActiveAllTrue(id > 10));
uint4 ballot = WaveActiveBallot(id > 20);
testResult.w = countbits(ballot.x) + countbits(ballot.y) + countbits(ballot.z) + countbits(ballot.w);
}
else
{
testResult.z = float(WaveActiveAllTrue(id > 3));
uint4 ballot = WaveActiveBallot(id > 4);
testResult.w = countbits(ballot.x) + countbits(ballot.y) + countbits(ballot.z) + countbits(ballot.w);
}
}
else if(IsTest(2))
{
// Broadcast functions : unit tests
if (id >= 2 && id <= 20)
{
testResult.x = WaveReadLaneFirst(id);
testResult.y = WaveReadLaneAt(id, 5);
testResult.z = WaveReadLaneAt(id, id);
testResult.w = WaveReadLaneAt(testResult.x, 2+id%3);
}
}
else if(IsTest(3))
{
// Scan and Prefix functions : unit tests
if (id >= 2 && id <= 20)
{
testResult.x = WavePrefixCountBits(id > 4);
testResult.y = WavePrefixCountBits(id > 10);
testResult.z = WavePrefixSum(testResult.x);
testResult.w = WavePrefixProduct(1 + testResult.y);
}
else
{
testResult.x = WavePrefixCountBits(id > 23);
testResult.y = WavePrefixCountBits(id < 1);
testResult.z = WavePrefixSum(testResult.x);
testResult.w = WavePrefixSum(testResult.y);
}
}
else if(IsTest(4))
{
// Reduction functions : unit tests
if (id >= 2 && id <= 20)
{
testResult.x = float(WaveActiveMax(id));
testResult.y = float(WaveActiveMin(id));
testResult.z = float(WaveActiveProduct(id));
testResult.w = float(WaveActiveSum(id));
}
}
else if(IsTest(5))
{
// Reduction functions : unit tests
if (id >= 2 && id <= 20)
{
testResult.x = float(WaveActiveCountBits(id > 23));
testResult.y = float(WaveActiveBitAnd(id));
testResult.z = float(WaveActiveBitOr(id));
testResult.w = float(WaveActiveBitXor(id));
}
}
else if(IsTest(6))
{
// Reduction functions : unit tests
if (id > 13)
{
bool test1 = (id > 15).x;
bool2 test2 = bool2(test1, (id < 23));
bool3 test3 = bool3(test1, (id < 23), (id >= 25));
bool4 test4 = bool4(test1, (id < 23), (id >= 25), (id >= 28));
testResult.x = float(WaveActiveAllEqual(test1).x);
testResult.y = float(WaveActiveAllEqual(test2).y);
testResult.z = float(WaveActiveAllEqual(test3).z);
testResult.w = float(WaveActiveAllEqual(test4).w);
}
}
SetOutput(testResult);
}
)EOSHADER";
const std::string comp66 = compCommon + R"EOSHADER(
[numthreads(GROUP_SIZE_X, GROUP_SIZE_Y, 1)]
void main(uint3 inTid : SV_DispatchThreadID)
{
float4 testResult = 0.0f.xxxx;
tid = inTid;
uint id = WaveGetLaneIndex();
SetOutput(id);
if(IsTest(0))
{
// SM6.5 functions : unit tests
uint4 mask = WaveMatch(id);
testResult.x = countbits(mask.x) + countbits(mask.y) + countbits(mask.z) + countbits(mask.w);
mask = WaveMatch(id%3 == 1);
testResult.y = countbits(mask.x) + countbits(mask.y) + countbits(mask.z) + countbits(mask.w);
mask = WaveMatch(id%5 == 1);
testResult.z = WaveMultiPrefixSum(id, mask);
testResult.w = WaveMultiPrefixProduct(id, mask);
}
if(IsTest(1))
{
// SM6.5 functions : unit tests
uint4 mask = WaveMatch(id%7 == 1);
testResult.x = WaveMultiPrefixCountBits(id, mask);
testResult.y = WaveMultiPrefixBitAnd((id+7)*3, mask);
testResult.z = WaveMultiPrefixBitOr(id, mask);
testResult.w = WaveMultiPrefixBitXor(id, mask);
}
if(IsTest(2))
{
// QuadReadLaneAt: unit tests
testResult.x = float(QuadReadLaneAt(id, 0));
testResult.y = float(QuadReadLaneAt(id, 1));
testResult.z = float(QuadReadLaneAt(id, 2));
testResult.w = float(QuadReadLaneAt(id, 3));
}
if(IsTest(3))
{
// QuadReadAcrossDiagonal, QuadReadAcrossX, QuadReadAcrossY: unit tests
testResult.x = float(QuadReadAcrossDiagonal(id));
testResult.y = float(QuadReadAcrossX(id));
testResult.z = float(QuadReadAcrossY(id));
testResult.w = QuadReadLaneAt(testResult.x, 2);
}
if(IsTest(4))
{
// QuadAny, QuadAll: unit tests
testResult.x = float(QuadAny(id > 2));
testResult.y = float(QuadAll(id < 10));
testResult.z = float(QuadAny(testResult.x == 0.0f));
testResult.w = float(QuadAll(testResult.x == 0.0f));
}
SetOutput(testResult);
}
)EOSHADER";
const std::string comp67 = compCommon + R"EOSHADER(
[numthreads(GROUP_SIZE_X, GROUP_SIZE_Y, 1)]
void main(uint3 inTid : SV_DispatchThreadID)
{
float4 testResult = 0.0f.xxxx;
tid = inTid;
uint id = WaveGetLaneIndex();
SetOutput(id);
if(IsTest(0))
{
// SM6.7 functions : QuadAny, QuadAll: unit tests
testResult.x = float(QuadAny(id > 2));
testResult.y = float(QuadAll(id < 10));
testResult.z = float(QuadAny(testResult.x == 0.0f));
testResult.w = float(QuadAll(testResult.x == 0.0f));
}
SetOutput(testResult);
}
)EOSHADER";
void Prepare(int argc, char **argv)
{
D3D12GraphicsTest::Prepare(argc, argv);
if(opts1.WaveLaneCountMax < 16)
Avail = "Subgroup size is less than 16";
bool supportSM60 = (m_HighestShaderModel >= D3D_SHADER_MODEL_6_0) && m_DXILSupport;
if(!supportSM60)
Avail = "SM 6.0 not supported";
}
int main()
{
// initialise, create window, create device, etc
if(!Init())
return 3;
ID3D12RootSignaturePtr sig = MakeSig({constParam(D3D12_SHADER_VISIBILITY_ALL, 0, 0, 1),
uavParam(D3D12_SHADER_VISIBILITY_ALL, 0, 0)});
const uint32_t imgDim = 128;
ID3D12ResourcePtr fltTex = MakeTexture(DXGI_FORMAT_R32G32B32A32_FLOAT, imgDim, imgDim)
.RTV()
.InitialState(D3D12_RESOURCE_STATE_RENDER_TARGET);
fltTex->SetName(L"fltTex");
D3D12_CPU_DESCRIPTOR_HANDLE fltRTV = MakeRTV(fltTex).CreateCPU(0);
D3D12_GPU_DESCRIPTOR_HANDLE fltSRV = MakeSRV(fltTex).CreateGPU(8);
int vertTests = 0;
int numPixelTests60 = 0;
int numPixelTests67 = 0;
int numCompTests60 = 0;
int numCompTests66 = 0;
int numCompTests67 = 0;
{
size_t pos = 0;
while(pos != std::string::npos)
{
pos = pixel.find("IsTest(", pos);
if(pos == std::string::npos)
break;
pos += sizeof("IsTest(") - 1;
numPixelTests60 = std::max(numPixelTests60, atoi(pixel.c_str() + pos) + 1);
}
pos = 0;
while(pos != std::string::npos)
{
pos = pixel67.find("IsTest(", pos);
if(pos == std::string::npos)
break;
pos += sizeof("IsTest(") - 1;
numPixelTests67 = std::max(numPixelTests67, atoi(pixel67.c_str() + pos) + 1);
}
pos = 0;
while(pos != std::string::npos)
{
pos = vertex.find("IsTest(", pos);
if(pos == std::string::npos)
break;
pos += sizeof("IsTest(") - 1;
vertTests = std::max(vertTests, atoi(vertex.c_str() + pos) + 1);
}
pos = 0;
while(pos != std::string::npos)
{
pos = comp.find("IsTest(", pos);
if(pos == std::string::npos)
break;
pos += sizeof("IsTest(") - 1;
numCompTests60 = std::max(numCompTests60, atoi(comp.c_str() + pos) + 1);
}
pos = 0;
while(pos != std::string::npos)
{
pos = comp66.find("IsTest(", pos);
if(pos == std::string::npos)
break;
pos += sizeof("IsTest(") - 1;
numCompTests66 = std::max(numCompTests66, atoi(comp66.c_str() + pos) + 1);
}
pos = 0;
while(pos != std::string::npos)
{
pos = comp67.find("IsTest(", pos);
if(pos == std::string::npos)
break;
pos += sizeof("IsTest(") - 1;
numCompTests67 = std::max(numCompTests67, atoi(comp67.c_str() + pos) + 1);
}
}
const uint32_t numGraphicsTests60 = std::max(vertTests, numPixelTests60);
const uint32_t numGraphicsTests67 = numPixelTests67;
const uint32_t numCompTests = std::max(std::max(numCompTests60, numCompTests66), numCompTests67);
struct
{
int x, y;
} compsize[] = {
{256, 1},
{128, 2},
{8, 128},
{152, 1},
};
std::string comppipe_name[ARRAY_COUNT(compsize)];
ID3D12PipelineStatePtr comppipe[ARRAY_COUNT(compsize)];
ID3D12PipelineStatePtr comppipe66[ARRAY_COUNT(compsize)];
ID3D12PipelineStatePtr comppipe67[ARRAY_COUNT(compsize)];
std::string defines60;
std::string defines66;
std::string defines67;
bool supportSM66 = (m_HighestShaderModel >= D3D_SHADER_MODEL_6_6) && m_DXILSupport;
bool supportSM67 = (m_HighestShaderModel >= D3D_SHADER_MODEL_6_7) && m_DXILSupport;
ID3D12PipelineStatePtr graphics60 = MakePSO()
.RootSig(sig)
.VS(Compile(defines60 + vertex, "main", "vs_6_0"))
.PS(Compile(defines60 + pixel, "main", "ps_6_0"))
.RTVs({DXGI_FORMAT_R32G32B32A32_FLOAT});
ID3D12PipelineStatePtr graphics67;
if(supportSM67)
graphics67 = MakePSO()
.RootSig(sig)
.VS(Compile(defines60 + vertex, "main", "vs_6_0"))
.PS(Compile(defines60 + pixel67, "main", "ps_6_7"))
.RTVs({DXGI_FORMAT_R32G32B32A32_FLOAT});
for(int i = 0; i < ARRAY_COUNT(comppipe); i++)
{
std::string sizedefine;
sizedefine = fmt::format("#define GROUP_SIZE_X {}\n#define GROUP_SIZE_Y {}\n", compsize[i].x,
compsize[i].y);
comppipe_name[i] = fmt::format("{}x{}", compsize[i].x, compsize[i].y);
comppipe[i] =
MakePSO().RootSig(sig).CS(Compile(defines60 + sizedefine + comp, "main", "cs_6_0"));
comppipe[i]->SetName(UTF82Wide(comppipe_name[i]).c_str());
if(supportSM66)
{
comppipe66[i] =
MakePSO().RootSig(sig).CS(Compile(defines66 + sizedefine + comp66, "main", "cs_6_6"));
comppipe66[i]->SetName(UTF82Wide(comppipe_name[i]).c_str());
}
if(supportSM67)
{
comppipe67[i] =
MakePSO().RootSig(sig).CS(Compile(defines67 + sizedefine + comp67, "main", "cs_6_7"));
comppipe67[i]->SetName(UTF82Wide(comppipe_name[i]).c_str());
}
}
ID3D12ResourcePtr bufOut = MakeBuffer().Size(sizeof(Vec4f) * 1024 * numCompTests).UAV();
D3D12ViewCreator uavView =
MakeUAV(bufOut).Format(DXGI_FORMAT_R32_UINT).NumElements(4 * 1024 * numCompTests);
D3D12_CPU_DESCRIPTOR_HANDLE uavcpu = uavView.CreateClearCPU(10);
D3D12_GPU_DESCRIPTOR_HANDLE uavgpu = uavView.CreateGPU(10);
bufOut->SetName(L"bufOut");
while(Running())
{
ID3D12GraphicsCommandListPtr cmd = GetCommandBuffer();
Reset(cmd);
cmd->SetDescriptorHeaps(1, &m_CBVUAVSRV.GetInterfacePtr());
ID3D12ResourcePtr bb = StartUsingBackbuffer(cmd, D3D12_RESOURCE_STATE_RENDER_TARGET);
ClearRenderTargetView(cmd, BBRTV, {0.2f, 0.2f, 0.2f, 1.0f});
cmd->IASetPrimitiveTopology(D3D_PRIMITIVE_TOPOLOGY_TRIANGLESTRIP);
RSSetViewport(cmd, {0.0f, 0.0f, (float)imgDim, (float)imgDim, 0.0f, 1.0f});
RSSetScissorRect(cmd, {0, 0, imgDim, imgDim});
pushMarker(cmd, "Graphics Tests");
cmd->SetPipelineState(graphics60);
cmd->SetGraphicsRootSignature(sig);
for(uint32_t i = 0; i < numGraphicsTests60; i++)
{
ResourceBarrier(cmd);
OMSetRenderTargets(cmd, {fltRTV}, {});
ClearRenderTargetView(cmd, fltRTV, {123456.0f, 789.0f, 101112.0f, 0.0f});
cmd->SetGraphicsRoot32BitConstant(0, i, 0);
cmd->DrawInstanced(4, 1, 0, 0);
}
if(supportSM67)
{
cmd->SetPipelineState(graphics67);
cmd->SetGraphicsRootSignature(sig);
for(uint32_t i = 0; i < numGraphicsTests67; i++)
{
ResourceBarrier(cmd);
OMSetRenderTargets(cmd, {fltRTV}, {});
ClearRenderTargetView(cmd, fltRTV, {123456.0f, 789.0f, 101112.0f, 0.0f});
cmd->SetGraphicsRoot32BitConstant(0, i, 0);
cmd->DrawInstanced(4, 1, 0, 0);
}
}
popMarker(cmd);
pushMarker(cmd, "Compute Tests");
for(size_t p = 0; p < ARRAY_COUNT(comppipe); p++)
{
ResourceBarrier(cmd);
UINT zero[4] = {};
cmd->ClearUnorderedAccessViewUint(uavgpu, uavcpu, bufOut, zero, 0, NULL);
ResourceBarrier(cmd);
pushMarker(cmd, comppipe_name[p]);
cmd->SetPipelineState(comppipe[p]);
cmd->SetComputeRootSignature(sig);
cmd->SetComputeRootUnorderedAccessView(1, bufOut->GetGPUVirtualAddress());
for(int i = 0; i < numCompTests60; i++)
{
cmd->SetComputeRoot32BitConstant(0, i, 0);
cmd->Dispatch(1, 1, 1);
}
popMarker(cmd);
}
for(size_t p = 0; p < ARRAY_COUNT(comppipe66); p++)
{
ResourceBarrier(cmd);
UINT zero[4] = {};
cmd->ClearUnorderedAccessViewUint(uavgpu, uavcpu, bufOut, zero, 0, NULL);
ResourceBarrier(cmd);
pushMarker(cmd, comppipe_name[p]);
cmd->SetPipelineState(comppipe66[p]);
cmd->SetComputeRootSignature(sig);
cmd->SetComputeRootUnorderedAccessView(1, bufOut->GetGPUVirtualAddress());
for(int i = 0; i < numCompTests66; i++)
{
cmd->SetComputeRoot32BitConstant(0, i, 0);
cmd->Dispatch(1, 1, 1);
}
popMarker(cmd);
}
for(size_t p = 0; p < ARRAY_COUNT(comppipe67); p++)
{
ResourceBarrier(cmd);
UINT zero[4] = {};
cmd->ClearUnorderedAccessViewUint(uavgpu, uavcpu, bufOut, zero, 0, NULL);
ResourceBarrier(cmd);
pushMarker(cmd, comppipe_name[p]);
cmd->SetPipelineState(comppipe67[p]);
cmd->SetComputeRootSignature(sig);
cmd->SetComputeRootUnorderedAccessView(1, bufOut->GetGPUVirtualAddress());
for(int i = 0; i < numCompTests67; i++)
{
cmd->SetComputeRoot32BitConstant(0, i, 0);
cmd->Dispatch(1, 1, 1);
}
popMarker(cmd);
}
popMarker(cmd);
FinishUsingBackbuffer(cmd, D3D12_RESOURCE_STATE_RENDER_TARGET);
cmd->Close();
SubmitAndPresent({cmd});
}
return 0;
}
};
REGISTER_TEST();