| // Copyright 2023 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_LANG_CORE_IR_TRANSFORM_SHADER_IO_H_ |
| #define SRC_TINT_LANG_CORE_IR_TRANSFORM_SHADER_IO_H_ |
| |
| #include <memory> |
| #include <utility> |
| |
| #include "src/tint/lang/core/ir/builder.h" |
| #include "src/tint/lang/core/type/manager.h" |
| |
| namespace tint::core::ir::transform { |
| |
| /// Abstract base class for the state needed to handle IO for a particular backend target. |
| struct ShaderIOBackendState { |
| /// Constructor |
| /// @param mod the IR module |
| /// @param f the entry point function |
| ShaderIOBackendState(Module* mod, Function* f) : ir(mod), func(f) {} |
| |
| /// Destructor |
| virtual ~ShaderIOBackendState(); |
| |
| /// Add an input. |
| /// @param name the name of the input |
| /// @param type the type of the input |
| /// @param attributes the IO attributes |
| /// @returns the index of the input |
| virtual uint32_t AddInput(Symbol name, |
| const core::type::Type* type, |
| core::type::StructMemberAttributes attributes) { |
| inputs.Push({name, type, std::move(attributes)}); |
| return uint32_t(inputs.Length() - 1); |
| } |
| |
| /// Add an output. |
| /// @param name the name of the output |
| /// @param type the type of the output |
| /// @param attributes the IO attributes |
| /// @returns the index of the output |
| virtual uint32_t AddOutput(Symbol name, |
| const core::type::Type* type, |
| core::type::StructMemberAttributes attributes) { |
| outputs.Push({name, type, std::move(attributes)}); |
| return uint32_t(outputs.Length() - 1); |
| } |
| |
| /// Finalize the shader inputs and create any state needed for the new entry point function. |
| /// @returns the list of function parameters for the new entry point |
| virtual Vector<FunctionParam*, 4> FinalizeInputs() = 0; |
| |
| /// Finalize the shader outputs and create state needed for the new entry point function. |
| /// @returns the return value for the new entry point |
| virtual Value* FinalizeOutputs() = 0; |
| |
| /// Get the value of the input at index @p idx |
| /// @param builder the IR builder for new instructions |
| /// @param idx the index of the input |
| /// @returns the value of the input |
| virtual Value* GetInput(Builder& builder, uint32_t idx) = 0; |
| |
| /// Set the value of the output at index @p idx |
| /// @param builder the IR builder for new instructions |
| /// @param idx the index of the output |
| /// @param value the value to set |
| virtual void SetOutput(Builder& builder, uint32_t idx, Value* value) = 0; |
| |
| /// @returns true if a vertex point size builtin should be added |
| virtual bool NeedsVertexPointSize() const { return false; } |
| |
| protected: |
| /// The IR module. |
| Module* ir = nullptr; |
| |
| /// The IR builder. |
| Builder b{*ir}; |
| |
| /// The type manager. |
| core::type::Manager& ty{ir->Types()}; |
| |
| /// The original entry point function. |
| Function* func = nullptr; |
| |
| /// The list of shader inputs. |
| Vector<core::type::Manager::StructMemberDesc, 4> inputs; |
| |
| /// The list of shader outputs. |
| Vector<core::type::Manager::StructMemberDesc, 4> outputs; |
| }; |
| |
| /// The signature for a function that creates a backend state object. |
| using MakeBackendStateFunc = std::unique_ptr<ShaderIOBackendState>(Module*, Function*); |
| |
| /// @param module the module to transform |
| /// @param make_backend_state a function that creates a backend state object |
| void RunShaderIOBase(Module* module, std::function<MakeBackendStateFunc> make_backend_state); |
| |
| } // namespace tint::core::ir::transform |
| |
| #endif // SRC_TINT_LANG_CORE_IR_TRANSFORM_SHADER_IO_H_ |