ShaderProgramReflection.cpp 27 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028
  1. // Copyright (C) 2009-2021, Panagiotis Christopoulos Charitos and contributors.
  2. // All rights reserved.
  3. // Code licensed under the BSD License.
  4. // http://www.anki3d.org/LICENSE
  5. #include <AnKi/ShaderCompiler/ShaderProgramReflection.h>
  6. #include <AnKi/Gr/Utils/Functions.h>
  7. #include <SprivCross/spirv_glsl.hpp>
  8. namespace anki
  9. {
  10. static ShaderVariableDataType spirvcrossBaseTypeToAnki(spirv_cross::SPIRType::BaseType cross)
  11. {
  12. ShaderVariableDataType out = ShaderVariableDataType::NONE;
  13. switch(cross)
  14. {
  15. case spirv_cross::SPIRType::SByte:
  16. out = ShaderVariableDataType::I8;
  17. break;
  18. case spirv_cross::SPIRType::UByte:
  19. out = ShaderVariableDataType::U8;
  20. break;
  21. case spirv_cross::SPIRType::Short:
  22. out = ShaderVariableDataType::I16;
  23. break;
  24. case spirv_cross::SPIRType::UShort:
  25. out = ShaderVariableDataType::U16;
  26. break;
  27. case spirv_cross::SPIRType::Int:
  28. out = ShaderVariableDataType::I32;
  29. break;
  30. case spirv_cross::SPIRType::UInt:
  31. out = ShaderVariableDataType::U32;
  32. break;
  33. case spirv_cross::SPIRType::Int64:
  34. out = ShaderVariableDataType::I64;
  35. break;
  36. case spirv_cross::SPIRType::UInt64:
  37. out = ShaderVariableDataType::U64;
  38. break;
  39. case spirv_cross::SPIRType::Half:
  40. out = ShaderVariableDataType::F16;
  41. break;
  42. case spirv_cross::SPIRType::Float:
  43. out = ShaderVariableDataType::F32;
  44. break;
  45. default:
  46. break;
  47. }
  48. return out;
  49. }
  50. /// Populates the reflection info.
  51. class SpirvReflector : public spirv_cross::Compiler
  52. {
  53. public:
  54. SpirvReflector(const U32* ir, PtrSize wordCount, const GenericMemoryPoolAllocator<U8>& tmpAlloc,
  55. ShaderReflectionVisitorInterface* interface)
  56. : spirv_cross::Compiler(ir, wordCount)
  57. , m_alloc(tmpAlloc)
  58. , m_interface(interface)
  59. {
  60. }
  61. ANKI_USE_RESULT static Error performSpirvReflection(Array<ConstWeakArray<U8>, U32(ShaderType::COUNT)> spirv,
  62. GenericMemoryPoolAllocator<U8> tmpAlloc,
  63. ShaderReflectionVisitorInterface& interface);
  64. private:
  65. class Var
  66. {
  67. public:
  68. StringAuto m_name;
  69. ShaderVariableBlockInfo m_blockInfo;
  70. ShaderVariableDataType m_type = ShaderVariableDataType::NONE;
  71. Var(const GenericMemoryPoolAllocator<U8>& alloc)
  72. : m_name(alloc)
  73. {
  74. }
  75. };
  76. class Block
  77. {
  78. public:
  79. StringAuto m_name;
  80. DynamicArrayAuto<Var> m_vars;
  81. U32 m_binding = MAX_U32;
  82. U32 m_set = MAX_U32;
  83. U32 m_size = MAX_U32;
  84. Block(const GenericMemoryPoolAllocator<U8>& alloc)
  85. : m_name(alloc)
  86. , m_vars(alloc)
  87. {
  88. }
  89. };
  90. class Opaque
  91. {
  92. public:
  93. StringAuto m_name;
  94. ShaderVariableDataType m_type = ShaderVariableDataType::NONE;
  95. U32 m_binding = MAX_U32;
  96. U32 m_set = MAX_U32;
  97. U32 m_arraySize = MAX_U32;
  98. Opaque(const GenericMemoryPoolAllocator<U8>& alloc)
  99. : m_name(alloc)
  100. {
  101. }
  102. };
  103. class Const
  104. {
  105. public:
  106. StringAuto m_name;
  107. ShaderVariableDataType m_type = ShaderVariableDataType::NONE;
  108. U32 m_constantId = MAX_U32;
  109. Const(const GenericMemoryPoolAllocator<U8>& alloc)
  110. : m_name(alloc)
  111. {
  112. }
  113. };
  114. class StructMember
  115. {
  116. public:
  117. StringAuto m_name;
  118. ShaderVariableDataType m_type = ShaderVariableDataType::NONE;
  119. U32 m_structIndex = MAX_U32; ///< The member is actually a struct.
  120. U32 m_offset = MAX_U32;
  121. U32 m_arraySize = MAX_U32;
  122. StructMember(const GenericMemoryPoolAllocator<U8>& alloc)
  123. : m_name(alloc)
  124. {
  125. }
  126. };
  127. class Struct
  128. {
  129. public:
  130. StringAuto m_name;
  131. DynamicArrayAuto<StructMember> m_members;
  132. U32 m_size = 0;
  133. U32 m_alignment = 0;
  134. Struct(const GenericMemoryPoolAllocator<U8>& alloc)
  135. : m_name(alloc)
  136. , m_members(alloc)
  137. {
  138. }
  139. };
  140. GenericMemoryPoolAllocator<U8> m_alloc;
  141. ShaderReflectionVisitorInterface* m_interface = nullptr;
  142. ANKI_USE_RESULT Error spirvTypeToAnki(const spirv_cross::SPIRType& type, ShaderVariableDataType& out) const;
  143. ANKI_USE_RESULT Error blockReflection(const spirv_cross::Resource& res, Bool isStorage,
  144. DynamicArrayAuto<Block>& blocks) const;
  145. ANKI_USE_RESULT Error opaqueReflection(const spirv_cross::Resource& res, DynamicArrayAuto<Opaque>& opaques) const;
  146. ANKI_USE_RESULT Error constsReflection(DynamicArrayAuto<Const>& consts, ShaderType stage) const;
  147. ANKI_USE_RESULT Error blockVariablesReflection(spirv_cross::TypeID resourceId, DynamicArrayAuto<Var>& vars) const;
  148. ANKI_USE_RESULT Error blockVariableReflection(const spirv_cross::SPIRType& type, CString parentVariable,
  149. U32 baseOffset, DynamicArrayAuto<Var>& vars) const;
  150. ANKI_USE_RESULT Error workgroupSizes(U32& sizex, U32& sizey, U32& sizez, U32& specConstMask);
  151. ANKI_USE_RESULT Error structsReflection(DynamicArrayAuto<Struct>& structs) const;
  152. ANKI_USE_RESULT Error structReflection(uint32_t id, const spirv_cross::SPIRType& type, U32 depth, Bool& skipped,
  153. DynamicArrayAuto<Struct>& structs, U32& structIndexInStructsArr) const;
  154. };
  155. Error SpirvReflector::structsReflection(DynamicArrayAuto<Struct>& structs) const
  156. {
  157. Error err = Error::NONE;
  158. ir.for_each_typed_id<spirv_cross::SPIRType>([&err, &structs, this](uint32_t id, const spirv_cross::SPIRType& type) {
  159. if(err)
  160. {
  161. return;
  162. }
  163. if(type.basetype != spirv_cross::SPIRType::Struct || type.pointer || !type.array.empty()
  164. || has_decoration(type.self, spv::DecorationBlock))
  165. {
  166. return;
  167. }
  168. U32 idx;
  169. Bool skipped;
  170. err = structReflection(id, type, 0, skipped, structs, idx);
  171. });
  172. return err;
  173. }
  174. Error SpirvReflector::structReflection(uint32_t id, const spirv_cross::SPIRType& type, U32 depth, Bool& skipped,
  175. DynamicArrayAuto<Struct>& structs, U32& structIndexInStructsArr) const
  176. {
  177. skipped = false;
  178. // Name
  179. std::string name = to_name(id);
  180. // Skip GL builtins, SPIRV-Cross things and symbols that should be skipped
  181. if(CString(name.c_str()).find("gl_") == 0 || CString(name.c_str()).find("_") == 0
  182. || (depth == 0 && m_interface->skipSymbol(name.c_str())))
  183. {
  184. skipped = true;
  185. return Error::NONE;
  186. }
  187. // Check if the struct is already there
  188. structIndexInStructsArr = 0;
  189. for(const Struct& s : structs)
  190. {
  191. if(s.m_name == name.c_str())
  192. {
  193. return Error::NONE;
  194. }
  195. ++structIndexInStructsArr;
  196. }
  197. // Create new struct
  198. GenericMemoryPoolAllocator<U8> alloc = structs.getAllocator();
  199. Struct cstruct(alloc);
  200. cstruct.m_name = name.c_str();
  201. U32 membersOffset = 0;
  202. Bool aMemberWasSkipped = false;
  203. // Members
  204. for(U32 i = 0; i < type.member_types.size(); ++i)
  205. {
  206. StructMember& member = *cstruct.m_members.emplaceBack(alloc);
  207. const spirv_cross::SPIRType& memberType = get<spirv_cross::SPIRType>(type.member_types[i]);
  208. // Get name
  209. const spirv_cross::Meta* meta = ir.find_meta(type.self);
  210. ANKI_ASSERT(meta);
  211. ANKI_ASSERT(i < meta->members.size());
  212. ANKI_ASSERT(!meta->members[i].alias.empty());
  213. member.m_name = meta->members[i].alias.c_str();
  214. // Array size
  215. if(!memberType.array.empty())
  216. {
  217. if(memberType.array.size() > 1)
  218. {
  219. ANKI_SHADER_COMPILER_LOGE("Can't support multi-dimentional arrays at the moment");
  220. return Error::USER_DATA;
  221. }
  222. const Bool notSpecConstantArraySize = memberType.array_size_literal[0];
  223. if(notSpecConstantArraySize)
  224. {
  225. // Have a min to acount for unsized arrays of SSBOs
  226. member.m_arraySize = max(memberType.array[0], 1u);
  227. }
  228. else
  229. {
  230. ANKI_SHADER_COMPILER_LOGE("Arrays with spec constant size are not allowed: %s", member.m_name.cstr());
  231. return Error::FUNCTION_FAILED;
  232. }
  233. }
  234. else
  235. {
  236. member.m_arraySize = 1;
  237. }
  238. // Type
  239. const ShaderVariableDataType baseType = spirvcrossBaseTypeToAnki(memberType.basetype);
  240. const Bool isNumeric = baseType != ShaderVariableDataType::NONE;
  241. ShaderVariableDataType actualType = ShaderVariableDataType::NONE;
  242. U32 memberSize = 0;
  243. U32 memberAlignment = 0;
  244. if(isNumeric)
  245. {
  246. const Bool isMatrix = memberType.columns > 1;
  247. if(0)
  248. {
  249. }
  250. #define ANKI_SVDT_MACRO(capital, type, baseType_, rowCount, columnCount) \
  251. else if(ShaderVariableDataType::baseType_ == baseType && isMatrix && memberType.vecsize == columnCount \
  252. && memberType.columns == rowCount) \
  253. { \
  254. actualType = ShaderVariableDataType::capital; \
  255. memberSize = sizeof(type); \
  256. memberAlignment = alignof(baseType_); \
  257. } \
  258. else if(ShaderVariableDataType::baseType_ == baseType && !isMatrix && memberType.vecsize == rowCount) \
  259. { \
  260. actualType = ShaderVariableDataType::capital; \
  261. memberSize = sizeof(type); \
  262. memberAlignment = alignof(baseType_); \
  263. }
  264. #include <AnKi/Gr/ShaderVariableDataTypeDefs.h>
  265. #undef ANKI_SVDT_MACRO
  266. member.m_type = actualType;
  267. }
  268. else if(memberType.basetype == spirv_cross::SPIRType::Struct)
  269. {
  270. U32 idx = MAX_U32;
  271. Bool memberSkipped = false;
  272. ANKI_CHECK(structReflection(type.member_types[i], memberType, depth + 1, memberSkipped, structs, idx));
  273. if(memberSkipped)
  274. {
  275. aMemberWasSkipped = true;
  276. break;
  277. }
  278. else
  279. {
  280. ANKI_ASSERT(idx < structs.getSize());
  281. member.m_structIndex = idx;
  282. memberSize = structs[idx].m_size;
  283. memberAlignment = structs[idx].m_alignment;
  284. }
  285. }
  286. else
  287. {
  288. ANKI_SHADER_COMPILER_LOGE("Unhandled base type for member: %s", name.c_str());
  289. return Error::FUNCTION_FAILED;
  290. }
  291. // Update offsets and alignments
  292. memberSize *= member.m_arraySize;
  293. member.m_offset = getAlignedRoundUp(memberAlignment, membersOffset);
  294. cstruct.m_alignment = max(cstruct.m_alignment, memberAlignment);
  295. cstruct.m_size = member.m_offset + memberSize;
  296. membersOffset = member.m_offset + memberSize;
  297. }
  298. if(!aMemberWasSkipped)
  299. {
  300. // Now you can create the struct
  301. alignRoundUp(cstruct.m_alignment, cstruct.m_size);
  302. Struct& newStruct = *structs.emplaceBack(alloc);
  303. newStruct = std::move(cstruct);
  304. }
  305. else
  306. {
  307. skipped = true;
  308. }
  309. return Error::NONE;
  310. }
  311. Error SpirvReflector::blockVariablesReflection(spirv_cross::TypeID resourceId, DynamicArrayAuto<Var>& vars) const
  312. {
  313. Bool found = false;
  314. Error err = Error::NONE;
  315. ir.for_each_typed_id<spirv_cross::SPIRType>([&](uint32_t, const spirv_cross::SPIRType& type) {
  316. if(err)
  317. {
  318. return;
  319. }
  320. if(type.basetype == spirv_cross::SPIRType::Struct && !type.pointer && type.array.empty())
  321. {
  322. if(type.self == resourceId)
  323. {
  324. found = true;
  325. err = blockVariableReflection(type, CString(), 0, vars);
  326. }
  327. }
  328. });
  329. ANKI_CHECK(err);
  330. if(!found)
  331. {
  332. ANKI_SHADER_COMPILER_LOGE("Can't determine the type of a block");
  333. return Error::USER_DATA;
  334. }
  335. return Error::NONE;
  336. }
  337. Error SpirvReflector::blockVariableReflection(const spirv_cross::SPIRType& type, CString parentVariable, U32 baseOffset,
  338. DynamicArrayAuto<Var>& vars) const
  339. {
  340. ANKI_ASSERT(type.basetype == spirv_cross::SPIRType::Struct);
  341. for(U32 i = 0; i < type.member_types.size(); ++i)
  342. {
  343. Var var(m_alloc);
  344. const spirv_cross::SPIRType& memberType = get<spirv_cross::SPIRType>(type.member_types[i]);
  345. // Name
  346. {
  347. const spirv_cross::Meta* meta = ir.find_meta(type.self);
  348. ANKI_ASSERT(meta);
  349. ANKI_ASSERT(i < meta->members.size());
  350. ANKI_ASSERT(!meta->members[i].alias.empty());
  351. const std::string& name = meta->members[i].alias;
  352. if(parentVariable.isEmpty())
  353. {
  354. var.m_name.create(name.c_str());
  355. }
  356. else
  357. {
  358. var.m_name.sprintf("%s.%s", parentVariable.cstr(), name.c_str());
  359. }
  360. }
  361. // Offset
  362. {
  363. auto it = ir.meta.find(type.self);
  364. ANKI_ASSERT(it != ir.meta.end());
  365. const spirv_cross::Vector<spirv_cross::Meta::Decoration>& memb = it->second.members;
  366. ANKI_ASSERT(i < memb.size());
  367. const spirv_cross::Meta::Decoration& dec = memb[i];
  368. ANKI_ASSERT(dec.decoration_flags.get(spv::DecorationOffset));
  369. var.m_blockInfo.m_offset = I16(dec.offset + baseOffset);
  370. }
  371. // Array size
  372. Bool isArray = false;
  373. {
  374. if(!memberType.array.empty())
  375. {
  376. if(memberType.array.size() > 1)
  377. {
  378. ANKI_SHADER_COMPILER_LOGE("Can't support multi-dimentional arrays at the moment");
  379. return Error::USER_DATA;
  380. }
  381. const Bool notSpecConstantArraySize = memberType.array_size_literal[0];
  382. if(notSpecConstantArraySize)
  383. {
  384. // Have a min to acount for unsized arrays of SSBOs
  385. var.m_blockInfo.m_arraySize = max<I16>(I16(memberType.array[0]), 1);
  386. isArray = true;
  387. }
  388. else
  389. {
  390. var.m_blockInfo.m_arraySize = 1;
  391. isArray = true;
  392. }
  393. }
  394. else
  395. {
  396. var.m_blockInfo.m_arraySize = 1;
  397. }
  398. }
  399. // Array stride
  400. if(has_decoration(type.member_types[i], spv::DecorationArrayStride))
  401. {
  402. var.m_blockInfo.m_arrayStride = I16(get_decoration(type.member_types[i], spv::DecorationArrayStride));
  403. }
  404. const ShaderVariableDataType baseType = spirvcrossBaseTypeToAnki(memberType.basetype);
  405. const Bool isNumeric = baseType != ShaderVariableDataType::NONE;
  406. if(memberType.basetype == spirv_cross::SPIRType::Struct)
  407. {
  408. if(var.m_blockInfo.m_arraySize == 1 && !isArray)
  409. {
  410. ANKI_CHECK(blockVariableReflection(memberType, var.m_name, var.m_blockInfo.m_offset, vars));
  411. }
  412. else
  413. {
  414. for(U32 i = 0; i < U32(var.m_blockInfo.m_arraySize); ++i)
  415. {
  416. StringAuto newName(m_alloc);
  417. newName.sprintf("%s[%u]", var.m_name.getBegin(), i);
  418. ANKI_CHECK(blockVariableReflection(
  419. memberType, newName, var.m_blockInfo.m_offset + var.m_blockInfo.m_arrayStride * i, vars));
  420. }
  421. }
  422. }
  423. else if(isNumeric)
  424. {
  425. const Bool isMatrix = memberType.columns > 1;
  426. if(0)
  427. {
  428. }
  429. #define ANKI_SVDT_MACRO(capital, type, baseType_, rowCount, columnCount) \
  430. else if(ShaderVariableDataType::baseType_ == baseType && isMatrix && memberType.vecsize == columnCount \
  431. && memberType.columns == rowCount) \
  432. { \
  433. var.m_type = ShaderVariableDataType::capital; \
  434. var.m_blockInfo.m_matrixStride = 16; \
  435. } \
  436. else if(ShaderVariableDataType::baseType_ == baseType && !isMatrix && memberType.vecsize == rowCount) \
  437. { \
  438. var.m_type = ShaderVariableDataType::capital; \
  439. }
  440. #include <AnKi/Gr/ShaderVariableDataTypeDefs.h>
  441. #undef ANKI_SVDT_MACRO
  442. if(var.m_type == ShaderVariableDataType::NONE)
  443. {
  444. ANKI_SHADER_COMPILER_LOGE("Unhandled numeric member: %s", var.m_name.cstr());
  445. return Error::FUNCTION_FAILED;
  446. }
  447. }
  448. else
  449. {
  450. ANKI_SHADER_COMPILER_LOGE("Unhandled base type for member: %s", var.m_name.cstr());
  451. return Error::FUNCTION_FAILED;
  452. }
  453. // Store the member if it's no struct
  454. if(var.m_type != ShaderVariableDataType::NONE)
  455. {
  456. vars.emplaceBack(std::move(var));
  457. }
  458. }
  459. return Error::NONE;
  460. }
  461. Error SpirvReflector::blockReflection(const spirv_cross::Resource& res, Bool isStorage,
  462. DynamicArrayAuto<Block>& blocks) const
  463. {
  464. Block newBlock(m_alloc);
  465. const spirv_cross::SPIRType type = get_type(res.type_id);
  466. const spirv_cross::Bitset decorationMask = get_decoration_bitset(res.id);
  467. const Bool isPushConstant = get_storage_class(res.id) == spv::StorageClassPushConstant;
  468. // Name
  469. {
  470. const std::string name = (!res.name.empty()) ? res.name : to_name(res.base_type_id);
  471. if(name.length() == 0)
  472. {
  473. ANKI_SHADER_COMPILER_LOGE("Can't accept zero name length");
  474. return Error::USER_DATA;
  475. }
  476. if(m_interface->skipSymbol(name.c_str()))
  477. {
  478. return Error::NONE;
  479. }
  480. newBlock.m_name.create(name.c_str());
  481. }
  482. // Set
  483. if(!isPushConstant)
  484. {
  485. newBlock.m_set = get_decoration(res.id, spv::DecorationDescriptorSet);
  486. if(newBlock.m_set >= MAX_DESCRIPTOR_SETS)
  487. {
  488. ANKI_SHADER_COMPILER_LOGE("Too high descriptor set: %u", newBlock.m_set);
  489. return Error::USER_DATA;
  490. }
  491. }
  492. // Binding
  493. if(!isPushConstant)
  494. {
  495. newBlock.m_binding = get_decoration(res.id, spv::DecorationBinding);
  496. }
  497. // Size
  498. newBlock.m_size = U32(get_declared_struct_size(get_type(res.base_type_id)));
  499. ANKI_ASSERT(isStorage || newBlock.m_size > 0);
  500. // Add it
  501. const Block* otherFound = nullptr;
  502. for(const Block& other : blocks)
  503. {
  504. const Bool bindingSame = other.m_set == newBlock.m_set && other.m_binding == newBlock.m_binding;
  505. const Bool nameSame = strcmp(other.m_name.getBegin(), newBlock.m_name.getBegin()) == 0;
  506. const Bool sizeSame = other.m_size == newBlock.m_size;
  507. const Bool err0 = bindingSame && (!nameSame || !sizeSame);
  508. const Bool err1 = nameSame && (!bindingSame || !sizeSame);
  509. if(err0 || err1)
  510. {
  511. ANKI_SHADER_COMPILER_LOGE("Linking error. Blocks %s and %s", other.m_name.cstr(), newBlock.m_name.cstr());
  512. return Error::USER_DATA;
  513. }
  514. if(bindingSame)
  515. {
  516. otherFound = &other;
  517. break;
  518. }
  519. }
  520. if(!otherFound)
  521. {
  522. // Get the variables
  523. ANKI_CHECK(blockVariablesReflection(res.base_type_id, newBlock.m_vars));
  524. // Store the block
  525. blocks.emplaceBack(std::move(newBlock));
  526. }
  527. #if ANKI_ENABLE_ASSERTIONS
  528. else
  529. {
  530. DynamicArrayAuto<Var> vars(m_alloc);
  531. ANKI_CHECK(blockVariablesReflection(res.base_type_id, vars));
  532. ANKI_ASSERT(vars.getSize() == otherFound->m_vars.getSize() && "Expecting same vars");
  533. }
  534. #endif
  535. return Error::NONE;
  536. }
  537. Error SpirvReflector::spirvTypeToAnki(const spirv_cross::SPIRType& type, ShaderVariableDataType& out) const
  538. {
  539. switch(type.basetype)
  540. {
  541. case spirv_cross::SPIRType::Image:
  542. case spirv_cross::SPIRType::SampledImage:
  543. {
  544. switch(type.image.dim)
  545. {
  546. case spv::Dim1D:
  547. out = (type.image.arrayed) ? ShaderVariableDataType::TEXTURE_1D_ARRAY : ShaderVariableDataType::TEXTURE_1D;
  548. break;
  549. case spv::Dim2D:
  550. out = (type.image.arrayed) ? ShaderVariableDataType::TEXTURE_2D_ARRAY : ShaderVariableDataType::TEXTURE_2D;
  551. break;
  552. case spv::Dim3D:
  553. out = ShaderVariableDataType::TEXTURE_3D;
  554. break;
  555. case spv::DimCube:
  556. out = (type.image.arrayed) ? ShaderVariableDataType::TEXTURE_CUBE_ARRAY
  557. : ShaderVariableDataType::TEXTURE_CUBE;
  558. break;
  559. default:
  560. ANKI_ASSERT(0);
  561. }
  562. break;
  563. }
  564. case spirv_cross::SPIRType::Sampler:
  565. out = ShaderVariableDataType::SAMPLER;
  566. break;
  567. default:
  568. ANKI_SHADER_COMPILER_LOGE("Can't determine the type");
  569. return Error::USER_DATA;
  570. }
  571. return Error::NONE;
  572. }
  573. Error SpirvReflector::opaqueReflection(const spirv_cross::Resource& res, DynamicArrayAuto<Opaque>& opaques) const
  574. {
  575. Opaque newOpaque(m_alloc);
  576. const spirv_cross::SPIRType type = get_type(res.type_id);
  577. const spirv_cross::Bitset decorationMask = get_decoration_bitset(res.id);
  578. const spirv_cross::ID fallbackId = spirv_cross::ID(res.id);
  579. // Name
  580. const std::string name = (!res.name.empty()) ? res.name : get_fallback_name(fallbackId);
  581. if(name.length() == 0)
  582. {
  583. ANKI_SHADER_COMPILER_LOGE("Can't accept zero length name");
  584. return Error::USER_DATA;
  585. }
  586. if(m_interface->skipSymbol(name.c_str()))
  587. {
  588. return Error::NONE;
  589. }
  590. newOpaque.m_name.create(name.c_str());
  591. // Type
  592. ANKI_CHECK(spirvTypeToAnki(type, newOpaque.m_type));
  593. // Set
  594. newOpaque.m_set = get_decoration(res.id, spv::DecorationDescriptorSet);
  595. if(newOpaque.m_set >= MAX_DESCRIPTOR_SETS)
  596. {
  597. ANKI_SHADER_COMPILER_LOGE("Too high descriptor set: %u", newOpaque.m_set);
  598. return Error::USER_DATA;
  599. }
  600. // Binding
  601. newOpaque.m_binding = get_decoration(res.id, spv::DecorationBinding);
  602. // Size
  603. if(type.array.size() == 0)
  604. {
  605. newOpaque.m_arraySize = 1;
  606. }
  607. else if(type.array.size() == 1)
  608. {
  609. newOpaque.m_arraySize = type.array[0];
  610. }
  611. else
  612. {
  613. ANKI_SHADER_COMPILER_LOGE("Can't support multi-dimensional arrays: %s", newOpaque.m_name.cstr());
  614. return Error::USER_DATA;
  615. }
  616. // Add it
  617. Bool found = false;
  618. for(const Opaque& other : opaques)
  619. {
  620. const Bool bindingSame = other.m_set == newOpaque.m_set && other.m_binding == newOpaque.m_binding;
  621. const Bool nameSame = other.m_name == newOpaque.m_name;
  622. const Bool sizeSame = other.m_arraySize == newOpaque.m_arraySize;
  623. const Bool typeSame = other.m_type == newOpaque.m_type;
  624. const Bool err = nameSame && (!bindingSame || !sizeSame || !typeSame);
  625. if(err)
  626. {
  627. ANKI_SHADER_COMPILER_LOGE("Linking error");
  628. return Error::USER_DATA;
  629. }
  630. if(nameSame)
  631. {
  632. found = true;
  633. break;
  634. }
  635. }
  636. if(!found)
  637. {
  638. opaques.emplaceBack(std::move(newOpaque));
  639. }
  640. return Error::NONE;
  641. }
  642. Error SpirvReflector::constsReflection(DynamicArrayAuto<Const>& consts, ShaderType stage) const
  643. {
  644. spirv_cross::SmallVector<spirv_cross::SpecializationConstant> specConsts = get_specialization_constants();
  645. for(const spirv_cross::SpecializationConstant& c : specConsts)
  646. {
  647. Const newConst(m_alloc);
  648. const spirv_cross::SPIRConstant cc = get<spirv_cross::SPIRConstant>(c.id);
  649. const spirv_cross::SPIRType type = get<spirv_cross::SPIRType>(cc.constant_type);
  650. const std::string name = get_name(c.id);
  651. if(name.length() == 0)
  652. {
  653. ANKI_SHADER_COMPILER_LOGE("Can't accept zero legth name");
  654. return Error::USER_DATA;
  655. }
  656. newConst.m_name.create(name.c_str());
  657. newConst.m_constantId = c.constant_id;
  658. switch(type.basetype)
  659. {
  660. case spirv_cross::SPIRType::UInt:
  661. newConst.m_type = ShaderVariableDataType::U32;
  662. break;
  663. case spirv_cross::SPIRType::Int:
  664. newConst.m_type = ShaderVariableDataType::I32;
  665. break;
  666. case spirv_cross::SPIRType::Float:
  667. newConst.m_type = ShaderVariableDataType::F32;
  668. break;
  669. default:
  670. ANKI_SHADER_COMPILER_LOGE("Can't determine the type of the spec constant: %s", name.c_str());
  671. return Error::USER_DATA;
  672. }
  673. // Search for it
  674. Const* foundConst = nullptr;
  675. for(Const& other : consts)
  676. {
  677. const Bool nameSame = other.m_name == newConst.m_name;
  678. const Bool typeSame = other.m_type == newConst.m_type;
  679. const Bool idSame = other.m_constantId == newConst.m_constantId;
  680. const Bool err0 = nameSame && (!typeSame || !idSame);
  681. const Bool err1 = idSame && (!nameSame || !typeSame);
  682. if(err0 || err1)
  683. {
  684. ANKI_SHADER_COMPILER_LOGE("Linking error");
  685. return Error::USER_DATA;
  686. }
  687. if(idSame)
  688. {
  689. foundConst = &other;
  690. break;
  691. }
  692. }
  693. // Add it or update it
  694. if(foundConst == nullptr)
  695. {
  696. consts.emplaceBack(std::move(newConst));
  697. }
  698. }
  699. return Error::NONE;
  700. }
  701. Error SpirvReflector::workgroupSizes(U32& sizex, U32& sizey, U32& sizez, U32& specConstMask)
  702. {
  703. sizex = sizey = sizez = specConstMask = 0;
  704. auto entries = get_entry_points_and_stages();
  705. for(const auto& e : entries)
  706. {
  707. if(e.execution_model == spv::ExecutionModelGLCompute)
  708. {
  709. const auto& spvEntry = get_entry_point(e.name, e.execution_model);
  710. spirv_cross::SpecializationConstant specx, specy, specz;
  711. get_work_group_size_specialization_constants(specx, specy, specz);
  712. if(specx.id != spirv_cross::ID(0))
  713. {
  714. specConstMask |= 1;
  715. sizex = specx.constant_id;
  716. }
  717. else
  718. {
  719. sizex = spvEntry.workgroup_size.x;
  720. }
  721. if(specy.id != spirv_cross::ID(0))
  722. {
  723. specConstMask |= 2;
  724. sizey = specy.constant_id;
  725. }
  726. else
  727. {
  728. sizey = spvEntry.workgroup_size.y;
  729. }
  730. if(specz.id != spirv_cross::ID(0))
  731. {
  732. specConstMask |= 4;
  733. sizez = specz.constant_id;
  734. }
  735. else
  736. {
  737. sizez = spvEntry.workgroup_size.z;
  738. }
  739. }
  740. }
  741. return Error::NONE;
  742. }
  743. Error SpirvReflector::performSpirvReflection(Array<ConstWeakArray<U8>, U32(ShaderType::COUNT)> spirv,
  744. GenericMemoryPoolAllocator<U8> tmpAlloc,
  745. ShaderReflectionVisitorInterface& interface)
  746. {
  747. DynamicArrayAuto<Block> uniformBlocks(tmpAlloc);
  748. DynamicArrayAuto<Block> storageBlocks(tmpAlloc);
  749. DynamicArrayAuto<Block> pushConstantBlock(tmpAlloc);
  750. DynamicArrayAuto<Opaque> opaques(tmpAlloc);
  751. DynamicArrayAuto<Const> specializationConstants(tmpAlloc);
  752. Array<U32, 3> workgroupSizes = {};
  753. U32 workgroupSizeSpecConstMask = 0;
  754. DynamicArrayAuto<Struct> structs(tmpAlloc);
  755. // Perform reflection for each stage
  756. for(const ShaderType type : EnumIterable<ShaderType>())
  757. {
  758. if(spirv[type].getSize() == 0)
  759. {
  760. continue;
  761. }
  762. // Parse SPIR-V
  763. const unsigned int* spvb = reinterpret_cast<const unsigned int*>(spirv[type].getBegin());
  764. SpirvReflector compiler(spvb, spirv[type].getSizeInBytes() / sizeof(unsigned int), tmpAlloc, &interface);
  765. // Uniform blocks
  766. for(const spirv_cross::Resource& res : compiler.get_shader_resources().uniform_buffers)
  767. {
  768. ANKI_CHECK(compiler.blockReflection(res, false, uniformBlocks));
  769. }
  770. // Sorage blocks
  771. for(const spirv_cross::Resource& res : compiler.get_shader_resources().storage_buffers)
  772. {
  773. ANKI_CHECK(compiler.blockReflection(res, true, storageBlocks));
  774. }
  775. // Push constants
  776. if(compiler.get_shader_resources().push_constant_buffers.size() == 1)
  777. {
  778. ANKI_CHECK(compiler.blockReflection(compiler.get_shader_resources().push_constant_buffers[0], false,
  779. pushConstantBlock));
  780. }
  781. else if(compiler.get_shader_resources().push_constant_buffers.size() > 1)
  782. {
  783. ANKI_SHADER_COMPILER_LOGE("Expecting only a single push constants block");
  784. return Error::USER_DATA;
  785. }
  786. // Opaque
  787. for(const spirv_cross::Resource& res : compiler.get_shader_resources().separate_images)
  788. {
  789. ANKI_CHECK(compiler.opaqueReflection(res, opaques));
  790. }
  791. for(const spirv_cross::Resource& res : compiler.get_shader_resources().storage_images)
  792. {
  793. ANKI_CHECK(compiler.opaqueReflection(res, opaques));
  794. }
  795. for(const spirv_cross::Resource& res : compiler.get_shader_resources().separate_samplers)
  796. {
  797. ANKI_CHECK(compiler.opaqueReflection(res, opaques));
  798. }
  799. // Spec consts
  800. ANKI_CHECK(compiler.constsReflection(specializationConstants, type));
  801. // Workgroup sizes
  802. if(type == ShaderType::COMPUTE)
  803. {
  804. ANKI_CHECK(compiler.workgroupSizes(workgroupSizes[0], workgroupSizes[1], workgroupSizes[2],
  805. workgroupSizeSpecConstMask));
  806. }
  807. // Structs
  808. ANKI_CHECK(compiler.structsReflection(structs));
  809. }
  810. // Inform through the interface
  811. ANKI_CHECK(interface.setCounts(uniformBlocks.getSize(), storageBlocks.getSize(), opaques.getSize(),
  812. pushConstantBlock.getSize() == 1, specializationConstants.getSize(),
  813. structs.getSize()));
  814. for(U32 i = 0; i < uniformBlocks.getSize(); ++i)
  815. {
  816. const Block& block = uniformBlocks[i];
  817. ANKI_CHECK(interface.visitUniformBlock(i, block.m_name, block.m_set, block.m_binding, block.m_size,
  818. block.m_vars.getSize()));
  819. for(U32 j = 0; j < block.m_vars.getSize(); ++j)
  820. {
  821. const Var& var = block.m_vars[j];
  822. ANKI_CHECK(interface.visitUniformVariable(i, j, var.m_name, var.m_type, var.m_blockInfo));
  823. }
  824. }
  825. for(U32 i = 0; i < storageBlocks.getSize(); ++i)
  826. {
  827. const Block& block = storageBlocks[i];
  828. ANKI_CHECK(interface.visitStorageBlock(i, block.m_name, block.m_set, block.m_binding, block.m_size,
  829. block.m_vars.getSize()));
  830. for(U32 j = 0; j < block.m_vars.getSize(); ++j)
  831. {
  832. const Var& var = block.m_vars[j];
  833. ANKI_CHECK(interface.visitStorageVariable(i, j, var.m_name, var.m_type, var.m_blockInfo));
  834. }
  835. }
  836. if(pushConstantBlock.getSize() == 1)
  837. {
  838. ANKI_CHECK(interface.visitPushConstantsBlock(pushConstantBlock[0].m_name, pushConstantBlock[0].m_size,
  839. pushConstantBlock[0].m_vars.getSize()));
  840. for(U32 j = 0; j < pushConstantBlock[0].m_vars.getSize(); ++j)
  841. {
  842. const Var& var = pushConstantBlock[0].m_vars[j];
  843. ANKI_CHECK(interface.visitPushConstant(j, var.m_name, var.m_type, var.m_blockInfo));
  844. }
  845. }
  846. for(U32 i = 0; i < opaques.getSize(); ++i)
  847. {
  848. const Opaque& o = opaques[i];
  849. ANKI_CHECK(interface.visitOpaque(i, o.m_name, o.m_type, o.m_set, o.m_binding, o.m_arraySize));
  850. }
  851. for(U32 i = 0; i < specializationConstants.getSize(); ++i)
  852. {
  853. const Const& c = specializationConstants[i];
  854. ANKI_CHECK(interface.visitConstant(i, c.m_name, c.m_type, c.m_constantId));
  855. }
  856. if(spirv[ShaderType::COMPUTE].getSize())
  857. {
  858. ANKI_CHECK(interface.setWorkgroupSizes(workgroupSizes[0], workgroupSizes[1], workgroupSizes[2],
  859. workgroupSizeSpecConstMask));
  860. }
  861. for(U32 i = 0; i < structs.getSize(); ++i)
  862. {
  863. const Struct& s = structs[i];
  864. ANKI_CHECK(interface.visitStruct(i, s.m_name, s.m_members.getSize(), s.m_size));
  865. for(U32 j = 0; j < s.m_members.getSize(); ++j)
  866. {
  867. const StructMember& sm = s.m_members[j];
  868. ANKI_CHECK(interface.visitStructMember(i, s.m_name, j, sm.m_name, sm.m_type,
  869. (sm.m_structIndex != MAX_U32) ? structs[sm.m_structIndex].m_name
  870. : CString(),
  871. sm.m_offset, sm.m_arraySize));
  872. }
  873. }
  874. return Error::NONE;
  875. }
  876. Error performSpirvReflection(Array<ConstWeakArray<U8>, U32(ShaderType::COUNT)> spirv,
  877. GenericMemoryPoolAllocator<U8> tmpAlloc, ShaderReflectionVisitorInterface& interface)
  878. {
  879. return SpirvReflector::performSpirvReflection(spirv, tmpAlloc, interface);
  880. }
  881. } // end namespace anki