ShaderProgramReflection.cpp 28 KB

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