| // Copyright 2022 The Tint Authors. |
| // |
| // 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 SRC_TINT_TRANSFORM_BUILTIN_POLYFILL_H_ |
| #define SRC_TINT_TRANSFORM_BUILTIN_POLYFILL_H_ |
| |
| #include "src/tint/transform/transform.h" |
| |
| namespace tint::transform { |
| |
| /// Implements builtins for backends that do not have a native implementation. |
| class BuiltinPolyfill final : public Castable<BuiltinPolyfill, Transform> { |
| public: |
| /// Constructor |
| BuiltinPolyfill(); |
| /// Destructor |
| ~BuiltinPolyfill() override; |
| |
| /// Enumerator of polyfill levels |
| enum class Level { |
| /// No polyfill needed, supported by the backend. |
| kNone, |
| /// Clamp the parameters to the inner implementation. |
| kClampParameters, |
| /// Range check the input. |
| kRangeCheck, |
| /// Polyfill the entire function |
| kFull, |
| }; |
| |
| /// Specifies the builtins that should be polyfilled by the transform. |
| struct Builtins { |
| /// What level should `acosh` be polyfilled? |
| Level acosh = Level::kNone; |
| /// Should `asinh` be polyfilled? |
| bool asinh = false; |
| /// What level should `atanh` be polyfilled? |
| Level atanh = Level::kNone; |
| /// Should `countLeadingZeros()` be polyfilled? |
| bool count_leading_zeros = false; |
| /// Should `countTrailingZeros()` be polyfilled? |
| bool count_trailing_zeros = false; |
| /// What level should `extractBits()` be polyfilled? |
| Level extract_bits = Level::kNone; |
| /// Should `firstLeadingBit()` be polyfilled? |
| bool first_leading_bit = false; |
| /// Should `firstTrailingBit()` be polyfilled? |
| bool first_trailing_bit = false; |
| /// Should `insertBits()` be polyfilled? |
| Level insert_bits = Level::kNone; |
| /// Should `saturate()` be polyfilled? |
| bool saturate = false; |
| /// Should `textureSampleBaseClampToEdge()` be polyfilled for texture_2d<f32> textures? |
| bool texture_sample_base_clamp_to_edge_2d_f32 = false; |
| }; |
| |
| /// Config is consumed by the BuiltinPolyfill transform. |
| /// Config specifies the builtins that should be polyfilled. |
| struct Config final : public Castable<Data, transform::Data> { |
| /// Constructor |
| /// @param b the list of builtins to polyfill |
| explicit Config(const Builtins& b); |
| |
| /// Copy constructor |
| Config(const Config&); |
| |
| /// Destructor |
| ~Config() override; |
| |
| /// The builtins to polyfill |
| const Builtins builtins; |
| }; |
| |
| /// @param program the program to inspect |
| /// @param data optional extra transform-specific input data |
| /// @returns true if this transform should be run for the given program |
| bool ShouldRun(const Program* program, const DataMap& data = {}) const override; |
| |
| protected: |
| struct State; |
| |
| /// Runs the transform using the CloneContext built for transforming a |
| /// program. Run() is responsible for calling Clone() on the CloneContext. |
| /// @param ctx the CloneContext primed with the input program and |
| /// ProgramBuilder |
| /// @param inputs optional extra transform-specific input data |
| /// @param outputs optional extra transform-specific output data |
| void Run(CloneContext& ctx, const DataMap& inputs, DataMap& outputs) const override; |
| }; |
| |
| } // namespace tint::transform |
| |
| #endif // SRC_TINT_TRANSFORM_BUILTIN_POLYFILL_H_ |