BsD3D11HLSLParamParser.cpp 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458
  1. //********************************** Banshee Engine (www.banshee3d.com) **************************************************//
  2. //**************** Copyright (c) 2016 Marko Pintera ([email protected]). All rights reserved. **********************//
  3. #include "BsD3D11HLSLParamParser.h"
  4. #include "BsD3D11Mappings.h"
  5. #include "RenderAPI/BsGpuParamDesc.h"
  6. #include "Error/BsException.h"
  7. #include "Debug/BsDebug.h"
  8. #include "Math/BsMath.h"
  9. namespace bs { namespace ct
  10. {
  11. void D3D11HLSLParamParser::parse(ID3DBlob* microcode, GpuProgramType type, GpuParamDesc& desc,
  12. List<VertexElement>* inputParams)
  13. {
  14. const char* commentString = nullptr;
  15. ID3DBlob* pIDisassembly = nullptr;
  16. char* pDisassembly = nullptr;
  17. HRESULT hr = D3DDisassemble((UINT*)microcode->GetBufferPointer(),
  18. microcode->GetBufferSize(), D3D_DISASM_ENABLE_COLOR_CODE, commentString, &pIDisassembly);
  19. const char* assemblyCode = static_cast<const char*>(pIDisassembly->GetBufferPointer());
  20. if (FAILED(hr))
  21. BS_EXCEPT(RenderingAPIException, "Unable to disassemble shader.");
  22. ID3D11ShaderReflection* shaderReflection;
  23. hr = D3DReflect((void*)microcode->GetBufferPointer(), microcode->GetBufferSize(),
  24. IID_ID3D11ShaderReflection, (void**)&shaderReflection);
  25. if (FAILED(hr))
  26. BS_EXCEPT(RenderingAPIException, "Cannot reflect D3D11 high-level shader.");
  27. D3D11_SHADER_DESC shaderDesc;
  28. hr = shaderReflection->GetDesc(&shaderDesc);
  29. if (FAILED(hr))
  30. BS_EXCEPT(RenderingAPIException, "Cannot reflect D3D11 high-level shader.");
  31. if (inputParams != nullptr)
  32. {
  33. D3D11_SIGNATURE_PARAMETER_DESC inputParamDesc;
  34. for (UINT32 i = 0; i < shaderDesc.InputParameters; i++)
  35. {
  36. hr = shaderReflection->GetInputParameterDesc(i, &inputParamDesc);
  37. if (FAILED(hr))
  38. BS_EXCEPT(RenderingAPIException, "Cannot get input param desc with index: " + toString(i));
  39. // We don't care about system value semantics
  40. if (StringUtil::startsWith(String(inputParamDesc.SemanticName), "sv_"))
  41. continue;
  42. inputParams->push_back(VertexElement(inputParamDesc.Stream, inputParamDesc.Register,
  43. D3D11Mappings::getInputType(inputParamDesc.ComponentType), D3D11Mappings::get(inputParamDesc.SemanticName), inputParamDesc.SemanticIndex));
  44. }
  45. }
  46. for(UINT32 i = 0; i < shaderDesc.BoundResources; i++)
  47. {
  48. D3D11_SHADER_INPUT_BIND_DESC bindingDesc;
  49. hr = shaderReflection->GetResourceBindingDesc(i, &bindingDesc);
  50. if (FAILED(hr))
  51. BS_EXCEPT(RenderingAPIException, "Cannot get resource binding desc with index: " + toString(i));
  52. parseResource(bindingDesc, type, desc);
  53. }
  54. for(UINT32 i = 0; i < shaderDesc.ConstantBuffers; i++)
  55. {
  56. ID3D11ShaderReflectionConstantBuffer* shaderReflectionConstantBuffer;
  57. shaderReflectionConstantBuffer = shaderReflection->GetConstantBufferByIndex(i);
  58. parseBuffer(shaderReflectionConstantBuffer, desc);
  59. }
  60. shaderReflection->Release();
  61. }
  62. void D3D11HLSLParamParser::parseResource(D3D11_SHADER_INPUT_BIND_DESC& resourceDesc, GpuProgramType type,
  63. GpuParamDesc& desc)
  64. {
  65. for(UINT32 i = 0; i < resourceDesc.BindCount; i++)
  66. {
  67. if(resourceDesc.Type == D3D_SIT_CBUFFER || resourceDesc.Type == D3D_SIT_TBUFFER)
  68. {
  69. GpuParamBlockDesc blockDesc;
  70. blockDesc.name = resourceDesc.Name;
  71. blockDesc.slot = resourceDesc.BindPoint + i;
  72. blockDesc.set = mapParameterToSet(type, ParamType::ConstantBuffer);
  73. blockDesc.blockSize = 0; // Calculated manually as we add parameters
  74. if(strcmp(resourceDesc.Name, "$Globals") == 0 || strcmp(resourceDesc.Name, "$Param") == 0) // Special buffers, as defined by DX11 docs
  75. blockDesc.isShareable = false;
  76. else
  77. blockDesc.isShareable = true;
  78. desc.paramBlocks.insert(std::make_pair(blockDesc.name, blockDesc));
  79. }
  80. else
  81. {
  82. GpuParamObjectDesc memberDesc;
  83. memberDesc.name = resourceDesc.Name;
  84. memberDesc.slot = resourceDesc.BindPoint + i;
  85. memberDesc.type = GPOT_UNKNOWN;
  86. switch(resourceDesc.Type)
  87. {
  88. case D3D_SIT_SAMPLER:
  89. memberDesc.type = GPOT_SAMPLER2D; // Actual dimension of the sampler doesn't matter
  90. memberDesc.set = mapParameterToSet(type, ParamType::Sampler);
  91. desc.samplers.insert(std::make_pair(memberDesc.name, memberDesc));
  92. break;
  93. case D3D_SIT_TEXTURE:
  94. {
  95. bool isTexture = true;
  96. switch (resourceDesc.Dimension)
  97. {
  98. case D3D_SRV_DIMENSION_TEXTURE1D:
  99. memberDesc.type = GPOT_TEXTURE1D;
  100. break;
  101. case D3D_SRV_DIMENSION_TEXTURE1DARRAY:
  102. memberDesc.type = GPOT_TEXTURE1DARRAY;
  103. break;
  104. case D3D_SRV_DIMENSION_TEXTURE2D:
  105. memberDesc.type = GPOT_TEXTURE2D;
  106. break;
  107. case D3D_SRV_DIMENSION_TEXTURE2DARRAY:
  108. memberDesc.type = GPOT_TEXTURE2DARRAY;
  109. break;
  110. case D3D_SRV_DIMENSION_TEXTURE3D:
  111. memberDesc.type = GPOT_TEXTURE3D;
  112. break;
  113. case D3D_SRV_DIMENSION_TEXTURECUBE:
  114. memberDesc.type = GPOT_TEXTURECUBE;
  115. break;
  116. case D3D_SRV_DIMENSION_TEXTURECUBEARRAY:
  117. memberDesc.type = GPOT_TEXTURECUBEARRAY;
  118. break;
  119. case D3D_SRV_DIMENSION_TEXTURE2DMS:
  120. memberDesc.type = GPOT_TEXTURE2DMS;
  121. break;
  122. case D3D_SRV_DIMENSION_TEXTURE2DMSARRAY:
  123. memberDesc.type = GPOT_TEXTURE2DMSARRAY;
  124. break;
  125. case D3D_SRV_DIMENSION_BUFFER:
  126. memberDesc.type = GPOT_BYTE_BUFFER;
  127. isTexture = false;
  128. break;
  129. default:
  130. LOGWRN("Skipping texture because it has unsupported dimension: " + toString(resourceDesc.Dimension));
  131. }
  132. if (memberDesc.type != GPOT_UNKNOWN)
  133. {
  134. memberDesc.set = mapParameterToSet(type, ParamType::Texture);
  135. if (isTexture)
  136. desc.textures.insert(std::make_pair(memberDesc.name, memberDesc));
  137. else
  138. desc.buffers.insert(std::make_pair(memberDesc.name, memberDesc));
  139. }
  140. }
  141. break;
  142. case D3D_SIT_STRUCTURED:
  143. memberDesc.type = GPOT_STRUCTURED_BUFFER;
  144. memberDesc.set = mapParameterToSet(type, ParamType::Texture);
  145. desc.buffers.insert(std::make_pair(memberDesc.name, memberDesc));
  146. break;
  147. case D3D_SIT_BYTEADDRESS:
  148. memberDesc.type = GPOT_BYTE_BUFFER;
  149. memberDesc.set = mapParameterToSet(type, ParamType::Texture);
  150. desc.buffers.insert(std::make_pair(memberDesc.name, memberDesc));
  151. break;
  152. case D3D11_SIT_UAV_RWTYPED:
  153. {
  154. memberDesc.set = mapParameterToSet(type, ParamType::UAV);
  155. switch (resourceDesc.Dimension)
  156. {
  157. case D3D_SRV_DIMENSION_TEXTURE1D:
  158. memberDesc.type = GPOT_RWTEXTURE1D;
  159. desc.loadStoreTextures.insert(std::make_pair(memberDesc.name, memberDesc));
  160. break;
  161. case D3D_SRV_DIMENSION_TEXTURE1DARRAY:
  162. memberDesc.type = GPOT_RWTEXTURE1DARRAY;
  163. desc.loadStoreTextures.insert(std::make_pair(memberDesc.name, memberDesc));
  164. break;
  165. case D3D_SRV_DIMENSION_TEXTURE2D:
  166. memberDesc.type = GPOT_RWTEXTURE2D;
  167. desc.loadStoreTextures.insert(std::make_pair(memberDesc.name, memberDesc));
  168. break;
  169. case D3D_SRV_DIMENSION_TEXTURE2DARRAY:
  170. memberDesc.type = GPOT_RWTEXTURE2DARRAY;
  171. desc.loadStoreTextures.insert(std::make_pair(memberDesc.name, memberDesc));
  172. break;
  173. case D3D_SRV_DIMENSION_TEXTURE3D:
  174. memberDesc.type = GPOT_RWTEXTURE3D;
  175. desc.loadStoreTextures.insert(std::make_pair(memberDesc.name, memberDesc));
  176. break;
  177. case D3D_SRV_DIMENSION_TEXTURE2DMS:
  178. memberDesc.type = GPOT_RWTEXTURE2DMS;
  179. desc.loadStoreTextures.insert(std::make_pair(memberDesc.name, memberDesc));
  180. break;
  181. case D3D_SRV_DIMENSION_TEXTURE2DMSARRAY:
  182. memberDesc.type = GPOT_RWTEXTURE2DMSARRAY;
  183. desc.loadStoreTextures.insert(std::make_pair(memberDesc.name, memberDesc));
  184. break;
  185. case D3D_SRV_DIMENSION_BUFFER:
  186. memberDesc.type = GPOT_RWTYPED_BUFFER;
  187. desc.buffers.insert(std::make_pair(memberDesc.name, memberDesc));
  188. break;
  189. default:
  190. LOGWRN("Skipping typed UAV because it has unsupported dimension: " + toString(resourceDesc.Dimension));
  191. }
  192. break;
  193. }
  194. case D3D11_SIT_UAV_RWSTRUCTURED:
  195. memberDesc.type = GPOT_RWSTRUCTURED_BUFFER;
  196. memberDesc.set = mapParameterToSet(type, ParamType::UAV);
  197. desc.buffers.insert(std::make_pair(memberDesc.name, memberDesc));
  198. break;
  199. case D3D11_SIT_UAV_RWBYTEADDRESS:
  200. memberDesc.type = GPOT_RWBYTE_BUFFER;
  201. memberDesc.set = mapParameterToSet(type, ParamType::UAV);
  202. desc.buffers.insert(std::make_pair(memberDesc.name, memberDesc));
  203. break;
  204. case D3D_SIT_UAV_APPEND_STRUCTURED:
  205. memberDesc.type = GPOT_RWAPPEND_BUFFER;
  206. memberDesc.set = mapParameterToSet(type, ParamType::UAV);
  207. desc.buffers.insert(std::make_pair(memberDesc.name, memberDesc));
  208. break;
  209. case D3D_SIT_UAV_CONSUME_STRUCTURED:
  210. memberDesc.type = GPOT_RWCONSUME_BUFFER;
  211. memberDesc.set = mapParameterToSet(type, ParamType::UAV);
  212. desc.buffers.insert(std::make_pair(memberDesc.name, memberDesc));
  213. break;
  214. case D3D_SIT_UAV_RWSTRUCTURED_WITH_COUNTER:
  215. memberDesc.type = GPOT_RWSTRUCTURED_BUFFER_WITH_COUNTER;
  216. memberDesc.set = mapParameterToSet(type, ParamType::UAV);
  217. desc.buffers.insert(std::make_pair(memberDesc.name, memberDesc));
  218. break;
  219. default:
  220. LOGWRN("Skipping resource because it has unsupported type: " + toString(resourceDesc.Type));
  221. }
  222. }
  223. }
  224. }
  225. void D3D11HLSLParamParser::parseBuffer(ID3D11ShaderReflectionConstantBuffer* bufferReflection,
  226. GpuParamDesc& desc)
  227. {
  228. D3D11_SHADER_BUFFER_DESC constantBufferDesc;
  229. HRESULT hr = bufferReflection->GetDesc(&constantBufferDesc);
  230. if (FAILED(hr))
  231. BS_EXCEPT(RenderingAPIException, "Failed to retrieve HLSL constant buffer description.");
  232. if(constantBufferDesc.Type != D3D_CT_CBUFFER && constantBufferDesc.Type != D3D_CT_TBUFFER)
  233. {
  234. // Not supported (most likely a constant buffer used internally by DX)
  235. return;
  236. }
  237. GpuParamBlockDesc& blockDesc = desc.paramBlocks[constantBufferDesc.Name];
  238. for(UINT32 j = 0; j < constantBufferDesc.Variables; j++)
  239. {
  240. ID3D11ShaderReflectionVariable* varRef = bufferReflection->GetVariableByIndex(j);
  241. D3D11_SHADER_VARIABLE_DESC varDesc;
  242. hr = varRef->GetDesc(&varDesc);
  243. if (FAILED(hr))
  244. BS_EXCEPT(RenderingAPIException, "Failed to retrieve HLSL constant buffer variable description.");
  245. ID3D11ShaderReflectionType* varRefType = varRef->GetType();
  246. D3D11_SHADER_TYPE_DESC varTypeDesc;
  247. varRefType->GetDesc(&varTypeDesc);
  248. parseVariable(varTypeDesc, varDesc, desc, blockDesc);
  249. }
  250. blockDesc.blockSize = constantBufferDesc.Size / 4;
  251. }
  252. void D3D11HLSLParamParser::parseVariable(D3D11_SHADER_TYPE_DESC& varTypeDesc, D3D11_SHADER_VARIABLE_DESC& varDesc,
  253. GpuParamDesc& desc, GpuParamBlockDesc& paramBlock)
  254. {
  255. GpuParamDataDesc memberDesc;
  256. memberDesc.name = varDesc.Name;
  257. memberDesc.paramBlockSlot = paramBlock.slot;
  258. memberDesc.paramBlockSet = paramBlock.set;
  259. memberDesc.arraySize = varTypeDesc.Elements == 0 ? 1 : varTypeDesc.Elements;
  260. memberDesc.gpuMemOffset = varDesc.StartOffset / 4;
  261. memberDesc.cpuMemOffset = varDesc.StartOffset / 4;
  262. // Determine individual element size in the array
  263. if(memberDesc.arraySize > 1)
  264. {
  265. // Find array element size (reported size is total size of array, minus unused register slots)
  266. int totalArraySize = (varDesc.Size / 4);
  267. int totalSlotsUsedByArray = Math::divideAndRoundUp(totalArraySize, 4) * 4;
  268. int unusedSlotsInArray = totalSlotsUsedByArray - totalArraySize;
  269. memberDesc.arrayElementStride = totalSlotsUsedByArray / memberDesc.arraySize;
  270. memberDesc.elementSize = memberDesc.arrayElementStride - unusedSlotsInArray;
  271. }
  272. else
  273. {
  274. memberDesc.elementSize = varDesc.Size / 4; // Stored in multiples of 4
  275. memberDesc.arrayElementStride = memberDesc.elementSize;
  276. }
  277. switch(varTypeDesc.Class)
  278. {
  279. case D3D_SVC_SCALAR:
  280. {
  281. switch(varTypeDesc.Type)
  282. {
  283. case D3D_SVT_BOOL:
  284. memberDesc.type = GPDT_BOOL;
  285. break;
  286. case D3D_SVT_INT:
  287. case D3D_SVT_UINT:
  288. memberDesc.type = GPDT_INT1;
  289. break;
  290. case D3D_SVT_FLOAT:
  291. memberDesc.type = GPDT_FLOAT1;
  292. break;
  293. default:
  294. LOGWRN("Skipping variable because it has unsupported type: " + toString(varTypeDesc.Type));
  295. }
  296. }
  297. break;
  298. case D3D_SVC_VECTOR:
  299. {
  300. switch(varTypeDesc.Type)
  301. {
  302. case D3D_SVT_UINT:
  303. case D3D_SVT_INT:
  304. {
  305. switch(varTypeDesc.Columns)
  306. {
  307. case 1:
  308. memberDesc.type = GPDT_INT1;
  309. break;
  310. case 2:
  311. memberDesc.type = GPDT_INT2;
  312. break;
  313. case 3:
  314. memberDesc.type = GPDT_INT3;
  315. break;
  316. case 4:
  317. memberDesc.type = GPDT_INT4;
  318. break;
  319. }
  320. }
  321. break;
  322. case D3D_SVT_FLOAT:
  323. {
  324. switch(varTypeDesc.Columns)
  325. {
  326. case 1:
  327. memberDesc.type = GPDT_FLOAT1;
  328. break;
  329. case 2:
  330. memberDesc.type = GPDT_FLOAT2;
  331. break;
  332. case 3:
  333. memberDesc.type = GPDT_FLOAT3;
  334. break;
  335. case 4:
  336. memberDesc.type = GPDT_FLOAT4;
  337. break;
  338. }
  339. }
  340. break;
  341. }
  342. }
  343. break;
  344. case D3D_SVC_MATRIX_COLUMNS:
  345. case D3D_SVC_MATRIX_ROWS:
  346. switch(varTypeDesc.Rows)
  347. {
  348. case 2:
  349. switch(varTypeDesc.Columns)
  350. {
  351. case 2:
  352. memberDesc.type = GPDT_MATRIX_2X2;
  353. break;
  354. case 3:
  355. memberDesc.type = GPDT_MATRIX_2X3;
  356. break;
  357. case 4:
  358. memberDesc.type = GPDT_MATRIX_2X4;
  359. break;
  360. }
  361. break;
  362. case 3:
  363. switch(varTypeDesc.Columns)
  364. {
  365. case 2:
  366. memberDesc.type = GPDT_MATRIX_3X2;
  367. break;
  368. case 3:
  369. memberDesc.type = GPDT_MATRIX_3X3;
  370. break;
  371. case 4:
  372. memberDesc.type = GPDT_MATRIX_3X4;
  373. break;
  374. }
  375. break;
  376. case 4:
  377. switch(varTypeDesc.Columns)
  378. {
  379. case 2:
  380. memberDesc.type = GPDT_MATRIX_4X2;
  381. break;
  382. case 3:
  383. memberDesc.type = GPDT_MATRIX_4X3;
  384. break;
  385. case 4:
  386. memberDesc.type = GPDT_MATRIX_4X4;
  387. break;
  388. }
  389. break;
  390. }
  391. break;
  392. case D3D_SVC_STRUCT:
  393. memberDesc.type = GPDT_STRUCT;
  394. break;
  395. default:
  396. LOGWRN("Skipping variable because it has unsupported class: " + toString(varTypeDesc.Class));
  397. }
  398. desc.params.insert(std::make_pair(memberDesc.name, memberDesc));
  399. }
  400. UINT32 D3D11HLSLParamParser::mapParameterToSet(GpuProgramType progType, ParamType paramType)
  401. {
  402. UINT32 progTypeIdx = (UINT32)progType;
  403. UINT32 paramTypeIdx = (UINT32)paramType;
  404. return progTypeIdx * (UINT32)ParamType::Count + paramTypeIdx;
  405. }
  406. }}