optimizer.cpp 32 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869
  1. // Copyright (c) 2016 Google Inc.
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. #include "spirv-tools/optimizer.hpp"
  15. #include <memory>
  16. #include <string>
  17. #include <unordered_map>
  18. #include <utility>
  19. #include <vector>
  20. #include <source/spirv_optimizer_options.h>
  21. #include "source/opt/build_module.h"
  22. #include "source/opt/log.h"
  23. #include "source/opt/pass_manager.h"
  24. #include "source/opt/passes.h"
  25. #include "source/util/make_unique.h"
  26. #include "source/util/string_utils.h"
  27. namespace spvtools {
  28. struct Optimizer::PassToken::Impl {
  29. Impl(std::unique_ptr<opt::Pass> p) : pass(std::move(p)) {}
  30. std::unique_ptr<opt::Pass> pass; // Internal implementation pass.
  31. };
  32. Optimizer::PassToken::PassToken(
  33. std::unique_ptr<Optimizer::PassToken::Impl> impl)
  34. : impl_(std::move(impl)) {}
  35. Optimizer::PassToken::PassToken(std::unique_ptr<opt::Pass>&& pass)
  36. : impl_(MakeUnique<Optimizer::PassToken::Impl>(std::move(pass))) {}
  37. Optimizer::PassToken::PassToken(PassToken&& that)
  38. : impl_(std::move(that.impl_)) {}
  39. Optimizer::PassToken& Optimizer::PassToken::operator=(PassToken&& that) {
  40. impl_ = std::move(that.impl_);
  41. return *this;
  42. }
  43. Optimizer::PassToken::~PassToken() {}
  44. struct Optimizer::Impl {
  45. explicit Impl(spv_target_env env) : target_env(env), pass_manager() {}
  46. spv_target_env target_env; // Target environment.
  47. opt::PassManager pass_manager; // Internal implementation pass manager.
  48. };
  49. Optimizer::Optimizer(spv_target_env env) : impl_(new Impl(env)) {}
  50. Optimizer::~Optimizer() {}
  51. void Optimizer::SetMessageConsumer(MessageConsumer c) {
  52. // All passes' message consumer needs to be updated.
  53. for (uint32_t i = 0; i < impl_->pass_manager.NumPasses(); ++i) {
  54. impl_->pass_manager.GetPass(i)->SetMessageConsumer(c);
  55. }
  56. impl_->pass_manager.SetMessageConsumer(std::move(c));
  57. }
  58. const MessageConsumer& Optimizer::consumer() const {
  59. return impl_->pass_manager.consumer();
  60. }
  61. Optimizer& Optimizer::RegisterPass(PassToken&& p) {
  62. // Change to use the pass manager's consumer.
  63. p.impl_->pass->SetMessageConsumer(consumer());
  64. impl_->pass_manager.AddPass(std::move(p.impl_->pass));
  65. return *this;
  66. }
  67. // The legalization passes take a spir-v shader generated by an HLSL front-end
  68. // and turn it into a valid vulkan spir-v shader. There are two ways in which
  69. // the code will be invalid at the start:
  70. //
  71. // 1) There will be opaque objects, like images, which will be passed around
  72. // in intermediate objects. Valid spir-v will have to replace the use of
  73. // the opaque object with an intermediate object that is the result of the
  74. // load of the global opaque object.
  75. //
  76. // 2) There will be variables that contain pointers to structured or uniform
  77. // buffers. It be legal, the variables must be eliminated, and the
  78. // references to the structured buffers must use the result of OpVariable
  79. // in the Uniform storage class.
  80. //
  81. // Optimization in this list must accept shaders with these relaxation of the
  82. // rules. There is not guarantee that this list of optimizations is able to
  83. // legalize all inputs, but it is on a best effort basis.
  84. //
  85. // The legalization problem is essentially a very general copy propagation
  86. // problem. The optimization we use are all used to either do copy propagation
  87. // or enable more copy propagation.
  88. Optimizer& Optimizer::RegisterLegalizationPasses() {
  89. return
  90. // Remove unreachable block so that merge return works.
  91. RegisterPass(CreateDeadBranchElimPass())
  92. // Merge the returns so we can inline.
  93. .RegisterPass(CreateMergeReturnPass())
  94. // Make sure uses and definitions are in the same function.
  95. .RegisterPass(CreateInlineExhaustivePass())
  96. // Make private variable function scope
  97. .RegisterPass(CreateEliminateDeadFunctionsPass())
  98. .RegisterPass(CreatePrivateToLocalPass())
  99. // Fix up the storage classes that DXC may have purposely generated
  100. // incorrectly. All functions are inlined, and a lot of dead code has
  101. // been removed.
  102. .RegisterPass(CreateFixStorageClassPass())
  103. // Propagate the value stored to the loads in very simple cases.
  104. .RegisterPass(CreateLocalSingleBlockLoadStoreElimPass())
  105. .RegisterPass(CreateLocalSingleStoreElimPass())
  106. .RegisterPass(CreateAggressiveDCEPass())
  107. // Split up aggregates so they are easier to deal with.
  108. .RegisterPass(CreateScalarReplacementPass(0))
  109. // Remove loads and stores so everything is in intermediate values.
  110. // Takes care of copy propagation of non-members.
  111. .RegisterPass(CreateLocalSingleBlockLoadStoreElimPass())
  112. .RegisterPass(CreateLocalSingleStoreElimPass())
  113. .RegisterPass(CreateAggressiveDCEPass())
  114. .RegisterPass(CreateLocalMultiStoreElimPass())
  115. .RegisterPass(CreateAggressiveDCEPass())
  116. // Propagate constants to get as many constant conditions on branches
  117. // as possible.
  118. .RegisterPass(CreateCCPPass())
  119. .RegisterPass(CreateLoopUnrollPass(true))
  120. .RegisterPass(CreateDeadBranchElimPass())
  121. // Copy propagate members. Cleans up code sequences generated by
  122. // scalar replacement. Also important for removing OpPhi nodes.
  123. .RegisterPass(CreateSimplificationPass())
  124. .RegisterPass(CreateAggressiveDCEPass())
  125. .RegisterPass(CreateCopyPropagateArraysPass())
  126. // May need loop unrolling here see
  127. // https://github.com/Microsoft/DirectXShaderCompiler/pull/930
  128. // Get rid of unused code that contain traces of illegal code
  129. // or unused references to unbound external objects
  130. .RegisterPass(CreateVectorDCEPass())
  131. .RegisterPass(CreateDeadInsertElimPass())
  132. .RegisterPass(CreateReduceLoadSizePass())
  133. .RegisterPass(CreateAggressiveDCEPass());
  134. }
  135. Optimizer& Optimizer::RegisterPerformancePasses() {
  136. return RegisterPass(CreateDeadBranchElimPass())
  137. .RegisterPass(CreateMergeReturnPass())
  138. .RegisterPass(CreateInlineExhaustivePass())
  139. .RegisterPass(CreateAggressiveDCEPass())
  140. .RegisterPass(CreatePrivateToLocalPass())
  141. .RegisterPass(CreateLocalSingleBlockLoadStoreElimPass())
  142. .RegisterPass(CreateLocalSingleStoreElimPass())
  143. .RegisterPass(CreateAggressiveDCEPass())
  144. .RegisterPass(CreateScalarReplacementPass())
  145. .RegisterPass(CreateLocalAccessChainConvertPass())
  146. .RegisterPass(CreateLocalSingleBlockLoadStoreElimPass())
  147. .RegisterPass(CreateLocalSingleStoreElimPass())
  148. .RegisterPass(CreateAggressiveDCEPass())
  149. .RegisterPass(CreateLocalMultiStoreElimPass())
  150. .RegisterPass(CreateAggressiveDCEPass())
  151. .RegisterPass(CreateCCPPass())
  152. .RegisterPass(CreateAggressiveDCEPass())
  153. .RegisterPass(CreateRedundancyEliminationPass())
  154. .RegisterPass(CreateCombineAccessChainsPass())
  155. .RegisterPass(CreateSimplificationPass())
  156. .RegisterPass(CreateVectorDCEPass())
  157. .RegisterPass(CreateDeadInsertElimPass())
  158. .RegisterPass(CreateDeadBranchElimPass())
  159. .RegisterPass(CreateSimplificationPass())
  160. .RegisterPass(CreateIfConversionPass())
  161. .RegisterPass(CreateCopyPropagateArraysPass())
  162. .RegisterPass(CreateReduceLoadSizePass())
  163. .RegisterPass(CreateAggressiveDCEPass())
  164. .RegisterPass(CreateBlockMergePass())
  165. .RegisterPass(CreateRedundancyEliminationPass())
  166. .RegisterPass(CreateDeadBranchElimPass())
  167. .RegisterPass(CreateBlockMergePass())
  168. .RegisterPass(CreateSimplificationPass());
  169. // Currently exposing driver bugs resulting in crashes (#946)
  170. // .RegisterPass(CreateCommonUniformElimPass())
  171. }
  172. Optimizer& Optimizer::RegisterSizePasses() {
  173. return RegisterPass(CreateDeadBranchElimPass())
  174. .RegisterPass(CreateMergeReturnPass())
  175. .RegisterPass(CreateInlineExhaustivePass())
  176. .RegisterPass(CreateAggressiveDCEPass())
  177. .RegisterPass(CreatePrivateToLocalPass())
  178. .RegisterPass(CreateScalarReplacementPass())
  179. .RegisterPass(CreateLocalAccessChainConvertPass())
  180. .RegisterPass(CreateLocalSingleBlockLoadStoreElimPass())
  181. .RegisterPass(CreateLocalSingleStoreElimPass())
  182. .RegisterPass(CreateAggressiveDCEPass())
  183. .RegisterPass(CreateSimplificationPass())
  184. .RegisterPass(CreateDeadInsertElimPass())
  185. .RegisterPass(CreateLocalMultiStoreElimPass())
  186. .RegisterPass(CreateAggressiveDCEPass())
  187. .RegisterPass(CreateCCPPass())
  188. .RegisterPass(CreateAggressiveDCEPass())
  189. .RegisterPass(CreateDeadBranchElimPass())
  190. .RegisterPass(CreateIfConversionPass())
  191. .RegisterPass(CreateAggressiveDCEPass())
  192. .RegisterPass(CreateBlockMergePass())
  193. .RegisterPass(CreateSimplificationPass())
  194. .RegisterPass(CreateDeadInsertElimPass())
  195. .RegisterPass(CreateRedundancyEliminationPass())
  196. .RegisterPass(CreateCFGCleanupPass())
  197. // Currently exposing driver bugs resulting in crashes (#946)
  198. // .RegisterPass(CreateCommonUniformElimPass())
  199. .RegisterPass(CreateAggressiveDCEPass());
  200. }
  201. Optimizer& Optimizer::RegisterVulkanToWebGPUPasses() {
  202. return RegisterPass(CreateStripDebugInfoPass())
  203. .RegisterPass(CreateStripAtomicCounterMemoryPass())
  204. .RegisterPass(CreateGenerateWebGPUInitializersPass())
  205. .RegisterPass(CreateLegalizeVectorShufflePass())
  206. .RegisterPass(CreateEliminateDeadConstantPass())
  207. .RegisterPass(CreateFlattenDecorationPass())
  208. .RegisterPass(CreateAggressiveDCEPass())
  209. .RegisterPass(CreateDeadBranchElimPass());
  210. }
  211. Optimizer& Optimizer::RegisterWebGPUToVulkanPasses() { return *this; }
  212. bool Optimizer::RegisterPassesFromFlags(const std::vector<std::string>& flags) {
  213. for (const auto& flag : flags) {
  214. if (!RegisterPassFromFlag(flag)) {
  215. return false;
  216. }
  217. }
  218. return true;
  219. }
  220. bool Optimizer::FlagHasValidForm(const std::string& flag) const {
  221. if (flag == "-O" || flag == "-Os") {
  222. return true;
  223. } else if (flag.size() > 2 && flag.substr(0, 2) == "--") {
  224. return true;
  225. }
  226. Errorf(consumer(), nullptr, {},
  227. "%s is not a valid flag. Flag passes should have the form "
  228. "'--pass_name[=pass_args]'. Special flag names also accepted: -O "
  229. "and -Os.",
  230. flag.c_str());
  231. return false;
  232. }
  233. bool Optimizer::RegisterPassFromFlag(const std::string& flag) {
  234. if (!FlagHasValidForm(flag)) {
  235. return false;
  236. }
  237. // Split flags of the form --pass_name=pass_args.
  238. auto p = utils::SplitFlagArgs(flag);
  239. std::string pass_name = p.first;
  240. std::string pass_args = p.second;
  241. // FIXME(dnovillo): This should be re-factored so that pass names can be
  242. // automatically checked against Pass::name() and PassToken instances created
  243. // via a template function. Additionally, class Pass should have a desc()
  244. // method that describes the pass (so it can be used in --help).
  245. //
  246. // Both Pass::name() and Pass::desc() should be static class members so they
  247. // can be invoked without creating a pass instance.
  248. if (pass_name == "strip-atomic-counter-memory") {
  249. RegisterPass(CreateStripAtomicCounterMemoryPass());
  250. } else if (pass_name == "strip-debug") {
  251. RegisterPass(CreateStripDebugInfoPass());
  252. } else if (pass_name == "strip-reflect") {
  253. RegisterPass(CreateStripReflectInfoPass());
  254. } else if (pass_name == "set-spec-const-default-value") {
  255. if (pass_args.size() > 0) {
  256. auto spec_ids_vals =
  257. opt::SetSpecConstantDefaultValuePass::ParseDefaultValuesString(
  258. pass_args.c_str());
  259. if (!spec_ids_vals) {
  260. Errorf(consumer(), nullptr, {},
  261. "Invalid argument for --set-spec-const-default-value: %s",
  262. pass_args.c_str());
  263. return false;
  264. }
  265. RegisterPass(
  266. CreateSetSpecConstantDefaultValuePass(std::move(*spec_ids_vals)));
  267. } else {
  268. Errorf(consumer(), nullptr, {},
  269. "Invalid spec constant value string '%s'. Expected a string of "
  270. "<spec id>:<default value> pairs.",
  271. pass_args.c_str());
  272. return false;
  273. }
  274. } else if (pass_name == "if-conversion") {
  275. RegisterPass(CreateIfConversionPass());
  276. } else if (pass_name == "freeze-spec-const") {
  277. RegisterPass(CreateFreezeSpecConstantValuePass());
  278. } else if (pass_name == "inline-entry-points-exhaustive") {
  279. RegisterPass(CreateInlineExhaustivePass());
  280. } else if (pass_name == "inline-entry-points-opaque") {
  281. RegisterPass(CreateInlineOpaquePass());
  282. } else if (pass_name == "combine-access-chains") {
  283. RegisterPass(CreateCombineAccessChainsPass());
  284. } else if (pass_name == "convert-local-access-chains") {
  285. RegisterPass(CreateLocalAccessChainConvertPass());
  286. } else if (pass_name == "eliminate-dead-code-aggressive") {
  287. RegisterPass(CreateAggressiveDCEPass());
  288. } else if (pass_name == "propagate-line-info") {
  289. RegisterPass(CreatePropagateLineInfoPass());
  290. } else if (pass_name == "eliminate-redundant-line-info") {
  291. RegisterPass(CreateRedundantLineInfoElimPass());
  292. } else if (pass_name == "eliminate-insert-extract") {
  293. RegisterPass(CreateInsertExtractElimPass());
  294. } else if (pass_name == "eliminate-local-single-block") {
  295. RegisterPass(CreateLocalSingleBlockLoadStoreElimPass());
  296. } else if (pass_name == "eliminate-local-single-store") {
  297. RegisterPass(CreateLocalSingleStoreElimPass());
  298. } else if (pass_name == "merge-blocks") {
  299. RegisterPass(CreateBlockMergePass());
  300. } else if (pass_name == "merge-return") {
  301. RegisterPass(CreateMergeReturnPass());
  302. } else if (pass_name == "eliminate-dead-branches") {
  303. RegisterPass(CreateDeadBranchElimPass());
  304. } else if (pass_name == "eliminate-dead-functions") {
  305. RegisterPass(CreateEliminateDeadFunctionsPass());
  306. } else if (pass_name == "eliminate-local-multi-store") {
  307. RegisterPass(CreateLocalMultiStoreElimPass());
  308. } else if (pass_name == "eliminate-common-uniform") {
  309. RegisterPass(CreateCommonUniformElimPass());
  310. } else if (pass_name == "eliminate-dead-const") {
  311. RegisterPass(CreateEliminateDeadConstantPass());
  312. } else if (pass_name == "eliminate-dead-inserts") {
  313. RegisterPass(CreateDeadInsertElimPass());
  314. } else if (pass_name == "eliminate-dead-variables") {
  315. RegisterPass(CreateDeadVariableEliminationPass());
  316. } else if (pass_name == "eliminate-dead-members") {
  317. RegisterPass(CreateEliminateDeadMembersPass());
  318. } else if (pass_name == "fold-spec-const-op-composite") {
  319. RegisterPass(CreateFoldSpecConstantOpAndCompositePass());
  320. } else if (pass_name == "loop-unswitch") {
  321. RegisterPass(CreateLoopUnswitchPass());
  322. } else if (pass_name == "scalar-replacement") {
  323. if (pass_args.size() == 0) {
  324. RegisterPass(CreateScalarReplacementPass());
  325. } else {
  326. int limit = -1;
  327. if (pass_args.find_first_not_of("0123456789") == std::string::npos) {
  328. limit = atoi(pass_args.c_str());
  329. }
  330. if (limit >= 0) {
  331. RegisterPass(CreateScalarReplacementPass(limit));
  332. } else {
  333. Error(consumer(), nullptr, {},
  334. "--scalar-replacement must have no arguments or a non-negative "
  335. "integer argument");
  336. return false;
  337. }
  338. }
  339. } else if (pass_name == "strength-reduction") {
  340. RegisterPass(CreateStrengthReductionPass());
  341. } else if (pass_name == "unify-const") {
  342. RegisterPass(CreateUnifyConstantPass());
  343. } else if (pass_name == "flatten-decorations") {
  344. RegisterPass(CreateFlattenDecorationPass());
  345. } else if (pass_name == "compact-ids") {
  346. RegisterPass(CreateCompactIdsPass());
  347. } else if (pass_name == "cfg-cleanup") {
  348. RegisterPass(CreateCFGCleanupPass());
  349. } else if (pass_name == "local-redundancy-elimination") {
  350. RegisterPass(CreateLocalRedundancyEliminationPass());
  351. } else if (pass_name == "loop-invariant-code-motion") {
  352. RegisterPass(CreateLoopInvariantCodeMotionPass());
  353. } else if (pass_name == "reduce-load-size") {
  354. RegisterPass(CreateReduceLoadSizePass());
  355. } else if (pass_name == "redundancy-elimination") {
  356. RegisterPass(CreateRedundancyEliminationPass());
  357. } else if (pass_name == "private-to-local") {
  358. RegisterPass(CreatePrivateToLocalPass());
  359. } else if (pass_name == "remove-duplicates") {
  360. RegisterPass(CreateRemoveDuplicatesPass());
  361. } else if (pass_name == "workaround-1209") {
  362. RegisterPass(CreateWorkaround1209Pass());
  363. } else if (pass_name == "replace-invalid-opcode") {
  364. RegisterPass(CreateReplaceInvalidOpcodePass());
  365. } else if (pass_name == "inst-bindless-check") {
  366. RegisterPass(CreateInstBindlessCheckPass(7, 23, true, true));
  367. RegisterPass(CreateSimplificationPass());
  368. RegisterPass(CreateDeadBranchElimPass());
  369. RegisterPass(CreateBlockMergePass());
  370. RegisterPass(CreateAggressiveDCEPass());
  371. } else if (pass_name == "simplify-instructions") {
  372. RegisterPass(CreateSimplificationPass());
  373. } else if (pass_name == "ssa-rewrite") {
  374. RegisterPass(CreateSSARewritePass());
  375. } else if (pass_name == "copy-propagate-arrays") {
  376. RegisterPass(CreateCopyPropagateArraysPass());
  377. } else if (pass_name == "loop-fission") {
  378. int register_threshold_to_split =
  379. (pass_args.size() > 0) ? atoi(pass_args.c_str()) : -1;
  380. if (register_threshold_to_split > 0) {
  381. RegisterPass(CreateLoopFissionPass(
  382. static_cast<size_t>(register_threshold_to_split)));
  383. } else {
  384. Error(consumer(), nullptr, {},
  385. "--loop-fission must have a positive integer argument");
  386. return false;
  387. }
  388. } else if (pass_name == "loop-fusion") {
  389. int max_registers_per_loop =
  390. (pass_args.size() > 0) ? atoi(pass_args.c_str()) : -1;
  391. if (max_registers_per_loop > 0) {
  392. RegisterPass(
  393. CreateLoopFusionPass(static_cast<size_t>(max_registers_per_loop)));
  394. } else {
  395. Error(consumer(), nullptr, {},
  396. "--loop-fusion must have a positive integer argument");
  397. return false;
  398. }
  399. } else if (pass_name == "loop-unroll") {
  400. RegisterPass(CreateLoopUnrollPass(true));
  401. } else if (pass_name == "upgrade-memory-model") {
  402. RegisterPass(CreateUpgradeMemoryModelPass());
  403. } else if (pass_name == "vector-dce") {
  404. RegisterPass(CreateVectorDCEPass());
  405. } else if (pass_name == "loop-unroll-partial") {
  406. int factor = (pass_args.size() > 0) ? atoi(pass_args.c_str()) : 0;
  407. if (factor > 0) {
  408. RegisterPass(CreateLoopUnrollPass(false, factor));
  409. } else {
  410. Error(consumer(), nullptr, {},
  411. "--loop-unroll-partial must have a positive integer argument");
  412. return false;
  413. }
  414. } else if (pass_name == "loop-peeling") {
  415. RegisterPass(CreateLoopPeelingPass());
  416. } else if (pass_name == "loop-peeling-threshold") {
  417. int factor = (pass_args.size() > 0) ? atoi(pass_args.c_str()) : 0;
  418. if (factor > 0) {
  419. opt::LoopPeelingPass::SetLoopPeelingThreshold(factor);
  420. } else {
  421. Error(consumer(), nullptr, {},
  422. "--loop-peeling-threshold must have a positive integer argument");
  423. return false;
  424. }
  425. } else if (pass_name == "ccp") {
  426. RegisterPass(CreateCCPPass());
  427. } else if (pass_name == "code-sink") {
  428. RegisterPass(CreateCodeSinkingPass());
  429. } else if (pass_name == "fix-storage-class") {
  430. RegisterPass(CreateFixStorageClassPass());
  431. } else if (pass_name == "O") {
  432. RegisterPerformancePasses();
  433. } else if (pass_name == "Os") {
  434. RegisterSizePasses();
  435. } else if (pass_name == "legalize-hlsl") {
  436. RegisterLegalizationPasses();
  437. } else if (pass_name == "generate-webgpu-initializers") {
  438. RegisterPass(CreateGenerateWebGPUInitializersPass());
  439. } else if (pass_name == "legalize-vector-shuffle") {
  440. RegisterPass(CreateLegalizeVectorShufflePass());
  441. } else {
  442. Errorf(consumer(), nullptr, {},
  443. "Unknown flag '--%s'. Use --help for a list of valid flags",
  444. pass_name.c_str());
  445. return false;
  446. }
  447. return true;
  448. }
  449. void Optimizer::SetTargetEnv(const spv_target_env env) {
  450. impl_->target_env = env;
  451. }
  452. bool Optimizer::Run(const uint32_t* original_binary,
  453. const size_t original_binary_size,
  454. std::vector<uint32_t>* optimized_binary) const {
  455. return Run(original_binary, original_binary_size, optimized_binary,
  456. OptimizerOptions());
  457. }
  458. bool Optimizer::Run(const uint32_t* original_binary,
  459. const size_t original_binary_size,
  460. std::vector<uint32_t>* optimized_binary,
  461. const ValidatorOptions& validator_options,
  462. bool skip_validation) const {
  463. OptimizerOptions opt_options;
  464. opt_options.set_run_validator(!skip_validation);
  465. opt_options.set_validator_options(validator_options);
  466. return Run(original_binary, original_binary_size, optimized_binary,
  467. opt_options);
  468. }
  469. bool Optimizer::Run(const uint32_t* original_binary,
  470. const size_t original_binary_size,
  471. std::vector<uint32_t>* optimized_binary,
  472. const spv_optimizer_options opt_options) const {
  473. spvtools::SpirvTools tools(impl_->target_env);
  474. tools.SetMessageConsumer(impl_->pass_manager.consumer());
  475. if (opt_options->run_validator_ &&
  476. !tools.Validate(original_binary, original_binary_size,
  477. &opt_options->val_options_)) {
  478. return false;
  479. }
  480. std::unique_ptr<opt::IRContext> context = BuildModule(
  481. impl_->target_env, consumer(), original_binary, original_binary_size);
  482. if (context == nullptr) return false;
  483. context->set_max_id_bound(opt_options->max_id_bound_);
  484. impl_->pass_manager.SetValidatorOptions(&opt_options->val_options_);
  485. impl_->pass_manager.SetTargetEnv(impl_->target_env);
  486. auto status = impl_->pass_manager.Run(context.get());
  487. bool binary_changed = false;
  488. if (status == opt::Pass::Status::SuccessWithChange) {
  489. binary_changed = true;
  490. } else if (status == opt::Pass::Status::SuccessWithoutChange) {
  491. if (optimized_binary->size() != original_binary_size ||
  492. (memcmp(optimized_binary->data(), original_binary,
  493. original_binary_size) != 0)) {
  494. binary_changed = true;
  495. Log(consumer(), SPV_MSG_WARNING, nullptr, {},
  496. "Binary unexpectedly changed despite optimizer saying there was no "
  497. "change");
  498. }
  499. }
  500. if (binary_changed) {
  501. optimized_binary->clear();
  502. context->module()->ToBinary(optimized_binary, /* skip_nop = */ true);
  503. }
  504. return status != opt::Pass::Status::Failure;
  505. }
  506. Optimizer& Optimizer::SetPrintAll(std::ostream* out) {
  507. impl_->pass_manager.SetPrintAll(out);
  508. return *this;
  509. }
  510. Optimizer& Optimizer::SetTimeReport(std::ostream* out) {
  511. impl_->pass_manager.SetTimeReport(out);
  512. return *this;
  513. }
  514. Optimizer& Optimizer::SetValidateAfterAll(bool validate) {
  515. impl_->pass_manager.SetValidateAfterAll(validate);
  516. return *this;
  517. }
  518. Optimizer::PassToken CreateNullPass() {
  519. return MakeUnique<Optimizer::PassToken::Impl>(MakeUnique<opt::NullPass>());
  520. }
  521. Optimizer::PassToken CreateStripAtomicCounterMemoryPass() {
  522. return MakeUnique<Optimizer::PassToken::Impl>(
  523. MakeUnique<opt::StripAtomicCounterMemoryPass>());
  524. }
  525. Optimizer::PassToken CreateStripDebugInfoPass() {
  526. return MakeUnique<Optimizer::PassToken::Impl>(
  527. MakeUnique<opt::StripDebugInfoPass>());
  528. }
  529. Optimizer::PassToken CreateStripReflectInfoPass() {
  530. return MakeUnique<Optimizer::PassToken::Impl>(
  531. MakeUnique<opt::StripReflectInfoPass>());
  532. }
  533. Optimizer::PassToken CreateEliminateDeadFunctionsPass() {
  534. return MakeUnique<Optimizer::PassToken::Impl>(
  535. MakeUnique<opt::EliminateDeadFunctionsPass>());
  536. }
  537. Optimizer::PassToken CreateEliminateDeadMembersPass() {
  538. return MakeUnique<Optimizer::PassToken::Impl>(
  539. MakeUnique<opt::EliminateDeadMembersPass>());
  540. }
  541. Optimizer::PassToken CreateSetSpecConstantDefaultValuePass(
  542. const std::unordered_map<uint32_t, std::string>& id_value_map) {
  543. return MakeUnique<Optimizer::PassToken::Impl>(
  544. MakeUnique<opt::SetSpecConstantDefaultValuePass>(id_value_map));
  545. }
  546. Optimizer::PassToken CreateSetSpecConstantDefaultValuePass(
  547. const std::unordered_map<uint32_t, std::vector<uint32_t>>& id_value_map) {
  548. return MakeUnique<Optimizer::PassToken::Impl>(
  549. MakeUnique<opt::SetSpecConstantDefaultValuePass>(id_value_map));
  550. }
  551. Optimizer::PassToken CreateFlattenDecorationPass() {
  552. return MakeUnique<Optimizer::PassToken::Impl>(
  553. MakeUnique<opt::FlattenDecorationPass>());
  554. }
  555. Optimizer::PassToken CreateFreezeSpecConstantValuePass() {
  556. return MakeUnique<Optimizer::PassToken::Impl>(
  557. MakeUnique<opt::FreezeSpecConstantValuePass>());
  558. }
  559. Optimizer::PassToken CreateFoldSpecConstantOpAndCompositePass() {
  560. return MakeUnique<Optimizer::PassToken::Impl>(
  561. MakeUnique<opt::FoldSpecConstantOpAndCompositePass>());
  562. }
  563. Optimizer::PassToken CreateUnifyConstantPass() {
  564. return MakeUnique<Optimizer::PassToken::Impl>(
  565. MakeUnique<opt::UnifyConstantPass>());
  566. }
  567. Optimizer::PassToken CreateEliminateDeadConstantPass() {
  568. return MakeUnique<Optimizer::PassToken::Impl>(
  569. MakeUnique<opt::EliminateDeadConstantPass>());
  570. }
  571. Optimizer::PassToken CreateDeadVariableEliminationPass() {
  572. return MakeUnique<Optimizer::PassToken::Impl>(
  573. MakeUnique<opt::DeadVariableElimination>());
  574. }
  575. Optimizer::PassToken CreateStrengthReductionPass() {
  576. return MakeUnique<Optimizer::PassToken::Impl>(
  577. MakeUnique<opt::StrengthReductionPass>());
  578. }
  579. Optimizer::PassToken CreateBlockMergePass() {
  580. return MakeUnique<Optimizer::PassToken::Impl>(
  581. MakeUnique<opt::BlockMergePass>());
  582. }
  583. Optimizer::PassToken CreateInlineExhaustivePass() {
  584. return MakeUnique<Optimizer::PassToken::Impl>(
  585. MakeUnique<opt::InlineExhaustivePass>());
  586. }
  587. Optimizer::PassToken CreateInlineOpaquePass() {
  588. return MakeUnique<Optimizer::PassToken::Impl>(
  589. MakeUnique<opt::InlineOpaquePass>());
  590. }
  591. Optimizer::PassToken CreateLocalAccessChainConvertPass() {
  592. return MakeUnique<Optimizer::PassToken::Impl>(
  593. MakeUnique<opt::LocalAccessChainConvertPass>());
  594. }
  595. Optimizer::PassToken CreateLocalSingleBlockLoadStoreElimPass() {
  596. return MakeUnique<Optimizer::PassToken::Impl>(
  597. MakeUnique<opt::LocalSingleBlockLoadStoreElimPass>());
  598. }
  599. Optimizer::PassToken CreateLocalSingleStoreElimPass() {
  600. return MakeUnique<Optimizer::PassToken::Impl>(
  601. MakeUnique<opt::LocalSingleStoreElimPass>());
  602. }
  603. Optimizer::PassToken CreateInsertExtractElimPass() {
  604. return MakeUnique<Optimizer::PassToken::Impl>(
  605. MakeUnique<opt::SimplificationPass>());
  606. }
  607. Optimizer::PassToken CreateDeadInsertElimPass() {
  608. return MakeUnique<Optimizer::PassToken::Impl>(
  609. MakeUnique<opt::DeadInsertElimPass>());
  610. }
  611. Optimizer::PassToken CreateDeadBranchElimPass() {
  612. return MakeUnique<Optimizer::PassToken::Impl>(
  613. MakeUnique<opt::DeadBranchElimPass>());
  614. }
  615. Optimizer::PassToken CreateLocalMultiStoreElimPass() {
  616. return MakeUnique<Optimizer::PassToken::Impl>(
  617. MakeUnique<opt::LocalMultiStoreElimPass>());
  618. }
  619. Optimizer::PassToken CreateAggressiveDCEPass() {
  620. return MakeUnique<Optimizer::PassToken::Impl>(
  621. MakeUnique<opt::AggressiveDCEPass>());
  622. }
  623. Optimizer::PassToken CreatePropagateLineInfoPass() {
  624. return MakeUnique<Optimizer::PassToken::Impl>(
  625. MakeUnique<opt::ProcessLinesPass>(opt::kLinesPropagateLines));
  626. }
  627. Optimizer::PassToken CreateRedundantLineInfoElimPass() {
  628. return MakeUnique<Optimizer::PassToken::Impl>(
  629. MakeUnique<opt::ProcessLinesPass>(opt::kLinesEliminateDeadLines));
  630. }
  631. Optimizer::PassToken CreateCommonUniformElimPass() {
  632. return MakeUnique<Optimizer::PassToken::Impl>(
  633. MakeUnique<opt::CommonUniformElimPass>());
  634. }
  635. Optimizer::PassToken CreateCompactIdsPass() {
  636. return MakeUnique<Optimizer::PassToken::Impl>(
  637. MakeUnique<opt::CompactIdsPass>());
  638. }
  639. Optimizer::PassToken CreateMergeReturnPass() {
  640. return MakeUnique<Optimizer::PassToken::Impl>(
  641. MakeUnique<opt::MergeReturnPass>());
  642. }
  643. std::vector<const char*> Optimizer::GetPassNames() const {
  644. std::vector<const char*> v;
  645. for (uint32_t i = 0; i < impl_->pass_manager.NumPasses(); i++) {
  646. v.push_back(impl_->pass_manager.GetPass(i)->name());
  647. }
  648. return v;
  649. }
  650. Optimizer::PassToken CreateCFGCleanupPass() {
  651. return MakeUnique<Optimizer::PassToken::Impl>(
  652. MakeUnique<opt::CFGCleanupPass>());
  653. }
  654. Optimizer::PassToken CreateLocalRedundancyEliminationPass() {
  655. return MakeUnique<Optimizer::PassToken::Impl>(
  656. MakeUnique<opt::LocalRedundancyEliminationPass>());
  657. }
  658. Optimizer::PassToken CreateLoopFissionPass(size_t threshold) {
  659. return MakeUnique<Optimizer::PassToken::Impl>(
  660. MakeUnique<opt::LoopFissionPass>(threshold));
  661. }
  662. Optimizer::PassToken CreateLoopFusionPass(size_t max_registers_per_loop) {
  663. return MakeUnique<Optimizer::PassToken::Impl>(
  664. MakeUnique<opt::LoopFusionPass>(max_registers_per_loop));
  665. }
  666. Optimizer::PassToken CreateLoopInvariantCodeMotionPass() {
  667. return MakeUnique<Optimizer::PassToken::Impl>(MakeUnique<opt::LICMPass>());
  668. }
  669. Optimizer::PassToken CreateLoopPeelingPass() {
  670. return MakeUnique<Optimizer::PassToken::Impl>(
  671. MakeUnique<opt::LoopPeelingPass>());
  672. }
  673. Optimizer::PassToken CreateLoopUnswitchPass() {
  674. return MakeUnique<Optimizer::PassToken::Impl>(
  675. MakeUnique<opt::LoopUnswitchPass>());
  676. }
  677. Optimizer::PassToken CreateRedundancyEliminationPass() {
  678. return MakeUnique<Optimizer::PassToken::Impl>(
  679. MakeUnique<opt::RedundancyEliminationPass>());
  680. }
  681. Optimizer::PassToken CreateRemoveDuplicatesPass() {
  682. return MakeUnique<Optimizer::PassToken::Impl>(
  683. MakeUnique<opt::RemoveDuplicatesPass>());
  684. }
  685. Optimizer::PassToken CreateScalarReplacementPass(uint32_t size_limit) {
  686. return MakeUnique<Optimizer::PassToken::Impl>(
  687. MakeUnique<opt::ScalarReplacementPass>(size_limit));
  688. }
  689. Optimizer::PassToken CreatePrivateToLocalPass() {
  690. return MakeUnique<Optimizer::PassToken::Impl>(
  691. MakeUnique<opt::PrivateToLocalPass>());
  692. }
  693. Optimizer::PassToken CreateCCPPass() {
  694. return MakeUnique<Optimizer::PassToken::Impl>(MakeUnique<opt::CCPPass>());
  695. }
  696. Optimizer::PassToken CreateWorkaround1209Pass() {
  697. return MakeUnique<Optimizer::PassToken::Impl>(
  698. MakeUnique<opt::Workaround1209>());
  699. }
  700. Optimizer::PassToken CreateIfConversionPass() {
  701. return MakeUnique<Optimizer::PassToken::Impl>(
  702. MakeUnique<opt::IfConversion>());
  703. }
  704. Optimizer::PassToken CreateReplaceInvalidOpcodePass() {
  705. return MakeUnique<Optimizer::PassToken::Impl>(
  706. MakeUnique<opt::ReplaceInvalidOpcodePass>());
  707. }
  708. Optimizer::PassToken CreateSimplificationPass() {
  709. return MakeUnique<Optimizer::PassToken::Impl>(
  710. MakeUnique<opt::SimplificationPass>());
  711. }
  712. Optimizer::PassToken CreateLoopUnrollPass(bool fully_unroll, int factor) {
  713. return MakeUnique<Optimizer::PassToken::Impl>(
  714. MakeUnique<opt::LoopUnroller>(fully_unroll, factor));
  715. }
  716. Optimizer::PassToken CreateSSARewritePass() {
  717. return MakeUnique<Optimizer::PassToken::Impl>(
  718. MakeUnique<opt::SSARewritePass>());
  719. }
  720. Optimizer::PassToken CreateCopyPropagateArraysPass() {
  721. return MakeUnique<Optimizer::PassToken::Impl>(
  722. MakeUnique<opt::CopyPropagateArrays>());
  723. }
  724. Optimizer::PassToken CreateVectorDCEPass() {
  725. return MakeUnique<Optimizer::PassToken::Impl>(MakeUnique<opt::VectorDCE>());
  726. }
  727. Optimizer::PassToken CreateReduceLoadSizePass() {
  728. return MakeUnique<Optimizer::PassToken::Impl>(
  729. MakeUnique<opt::ReduceLoadSize>());
  730. }
  731. Optimizer::PassToken CreateCombineAccessChainsPass() {
  732. return MakeUnique<Optimizer::PassToken::Impl>(
  733. MakeUnique<opt::CombineAccessChains>());
  734. }
  735. Optimizer::PassToken CreateUpgradeMemoryModelPass() {
  736. return MakeUnique<Optimizer::PassToken::Impl>(
  737. MakeUnique<opt::UpgradeMemoryModel>());
  738. }
  739. Optimizer::PassToken CreateInstBindlessCheckPass(uint32_t desc_set,
  740. uint32_t shader_id,
  741. bool input_length_enable,
  742. bool input_init_enable) {
  743. return MakeUnique<Optimizer::PassToken::Impl>(
  744. MakeUnique<opt::InstBindlessCheckPass>(
  745. desc_set, shader_id, input_length_enable, input_init_enable));
  746. }
  747. Optimizer::PassToken CreateCodeSinkingPass() {
  748. return MakeUnique<Optimizer::PassToken::Impl>(
  749. MakeUnique<opt::CodeSinkingPass>());
  750. }
  751. Optimizer::PassToken CreateGenerateWebGPUInitializersPass() {
  752. return MakeUnique<Optimizer::PassToken::Impl>(
  753. MakeUnique<opt::GenerateWebGPUInitializersPass>());
  754. }
  755. Optimizer::PassToken CreateFixStorageClassPass() {
  756. return MakeUnique<Optimizer::PassToken::Impl>(
  757. MakeUnique<opt::FixStorageClass>());
  758. }
  759. Optimizer::PassToken CreateLegalizeVectorShufflePass() {
  760. return MakeUnique<Optimizer::PassToken::Impl>(
  761. MakeUnique<opt::LegalizeVectorShufflePass>());
  762. }
  763. } // namespace spvtools