111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// Copyright (c) 2016 Google Inc. 211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// 311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// Permission is hereby granted, free of charge, to any person obtaining a 411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// copy of this software and/or associated documentation files (the 511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// "Materials"), to deal in the Materials without restriction, including 611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// without limitation the rights to use, copy, modify, merge, publish, 711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// distribute, sublicense, and/or sell copies of the Materials, and to 811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// permit persons to whom the Materials are furnished to do so, subject to 911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// the following conditions: 1011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// 1111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// The above copyright notice and this permission notice shall be included 1211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// in all copies or substantial portions of the Materials. 1311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// 1411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// MODIFICATIONS TO THIS FILE MAY MEAN IT NO LONGER ACCURATELY REFLECTS 1511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// KHRONOS STANDARDS. THE UNMODIFIED, NORMATIVE VERSIONS OF KHRONOS 1611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// SPECIFICATIONS AND HEADER INFORMATION ARE LOCATED AT 1711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// https://www.khronos.org/registry/ 1811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// 1911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 2011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 2111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 2211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 2311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 2411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 2511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS. 2611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 2711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#ifndef LIBSPIRV_OPT_PASSES_H_ 2811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#define LIBSPIRV_OPT_PASSES_H_ 2911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 3011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#include <memory> 3111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 3211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#include "module.h" 3311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 3411cd02dfb91661c65134cac258cf5924270e9d2Dan Albertnamespace spvtools { 3511cd02dfb91661c65134cac258cf5924270e9d2Dan Albertnamespace opt { 3611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 3711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// A pass. All analysis and transformation is done via the Process() method. 3811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertclass Pass { 3911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert public: 4011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert // Returns a descriptive name for this pass. 4111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert virtual const char* name() const = 0; 4211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert // Processes the given |module| and returns true if the given |module| is 4311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert // modified for optimization. 4411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert virtual bool Process(ir::Module* module) = 0; 4511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert}; 4611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 4711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// A null pass that does nothing. 4811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertclass NullPass : public Pass { 4911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert const char* name() const override { return "Null"; } 5011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert bool Process(ir::Module*) override { return false; } 5111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert}; 5211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 5311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// The optimization pass for removing debug instructions (as documented in 5411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert// Section 3.32.2 of the SPIR-V spec). 5511cd02dfb91661c65134cac258cf5924270e9d2Dan Albertclass StripDebugInfoPass : public Pass { 5611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert public: 5711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert const char* name() const override { return "StripDebugInfo"; } 5811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert bool Process(ir::Module* module) override; 5911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert}; 6011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 6111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert} // namespace opt 6211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert} // namespace spvtools 6311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 6411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#endif // LIBSPIRV_OPT_PASSES_H_ 65