mirror of
https://github.com/KhronosGroup/SPIRV-Tools
synced 2024-10-19 03:20:14 +00:00
1ca817a38e
There is no difference between the previous IgnoreMessage() function and a null std::function, from functionality's perspective. The user can set nullptr as the MessageConsumer, so need to guard against nullptr before calling the consumer anyway. It's better we use it internally so that it may expose problems by us instead of the user.
69 lines
2.3 KiB
C++
69 lines
2.3 KiB
C++
// Copyright (c) 2016 Google Inc.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef LIBSPIRV_OPT_PASS_H_
|
|
#define LIBSPIRV_OPT_PASS_H_
|
|
|
|
#include <memory>
|
|
|
|
#include "message.h"
|
|
#include "module.h"
|
|
|
|
namespace spvtools {
|
|
namespace opt {
|
|
|
|
// Abstract class of a pass. All passes should implement this abstract class
|
|
// and all analysis and transformation is done via the Process() method.
|
|
class Pass {
|
|
public:
|
|
// The status of processing a module using a pass.
|
|
//
|
|
// The numbers for the cases are assigned to make sure that Failure & anything
|
|
// is Failure, SuccessWithChange & any success is SuccessWithChange.
|
|
enum class Status {
|
|
Failure = 0x00,
|
|
SuccessWithChange = 0x10,
|
|
SuccessWithoutChange = 0x11,
|
|
};
|
|
|
|
// Constructs a new pass.
|
|
//
|
|
// The constructed instance will have an empty message consumer, which just
|
|
// ignores all messages from the library. Use SetMessageConsumer() to supply
|
|
// one if messages are of concern.
|
|
Pass() : consumer_(nullptr) {}
|
|
|
|
// Returns a descriptive name for this pass.
|
|
virtual const char* name() const = 0;
|
|
|
|
// Sets the message consumer to the given |consumer|. |consumer| which will be
|
|
// invoked every time there is a message to be communicated to the outside.
|
|
void SetMessageConsumer(MessageConsumer c) { consumer_ = std::move(c); }
|
|
// Returns the reference to the message consumer for this pass.
|
|
const MessageConsumer& consumer() const { return consumer_; }
|
|
|
|
// Processes the given |module|. Returns Status::Failure if errors occur when
|
|
// processing. Returns the corresponding Status::Success if processing is
|
|
// succesful to indicate whether changes are made to the module.
|
|
virtual Status Process(ir::Module* module) = 0;
|
|
|
|
private:
|
|
MessageConsumer consumer_; // Message consumer.
|
|
};
|
|
|
|
} // namespace opt
|
|
} // namespace spvtools
|
|
|
|
#endif // LIBSPIRV_OPT_PASS_H_
|