optimizer.cpp 35 KB

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