/* * Copyright 2015-2016 The Brenwill Workshop Ltd. * * 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 SPIRV_CROSS_MSL_HPP #define SPIRV_CROSS_MSL_HPP #include "spirv_glsl.hpp" #include #include namespace spirv_cross { // Options for compiling to Metal Shading Language struct MSLConfiguration { uint32_t vtx_attr_stage_in_binding = 0; bool flip_vert_y = true; bool flip_frag_y = true; bool is_rendering_points = false; }; // Defines MSL characteristics of a vertex attribute at a particular location. // The used_by_shader flag is set to true during compilation of SPIR-V to MSL // if the shader makes use of this vertex attribute. struct MSLVertexAttr { uint32_t location = 0; uint32_t msl_buffer = 0; uint32_t msl_offset = 0; uint32_t msl_stride = 0; bool per_instance = false; bool used_by_shader = false; }; // Matches the binding index of a MSL resource for a binding within a descriptor set. // Taken together, the stage, desc_set and binding combine to form a reference to a resource // descriptor used in a particular shading stage. Generally, only one of the buffer, texture, // or sampler elements will be populated. The used_by_shader flag is set to true during // compilation of SPIR-V to MSL if the shader makes use of this vertex attribute. struct MSLResourceBinding { spv::ExecutionModel stage; uint32_t desc_set = 0; uint32_t binding = 0; uint32_t msl_buffer = 0; uint32_t msl_texture = 0; uint32_t msl_sampler = 0; bool used_by_shader = false; }; // Special constant used in a MSLResourceBinding desc_set // element to indicate the bindings for the push constants. static const uint32_t kPushConstDescSet = UINT32_MAX; // Special constant used in a MSLResourceBinding binding // element to indicate the bindings for the push constants. static const uint32_t kPushConstBinding = 0; // Decompiles SPIR-V to Metal Shading Language class CompilerMSL : public CompilerGLSL { public: // Constructs an instance to compile the SPIR-V code into Metal Shading Language. CompilerMSL(std::vector spirv); // Compiles the SPIR-V code into Metal Shading Language using the specified configuration parameters. // - msl_cfg indicates some general configuration for directing the compilation. // - p_vtx_attrs is an optional list of vertex attribute bindings used to match // vertex content locations to MSL attributes. If vertex attributes are provided, // the compiler will set the used_by_shader flag to true in any vertex attribute // actually used by the MSL code. // - p_res_bindings is a list of resource bindings to indicate the MSL buffer, // texture or sampler index to use for a particular SPIR-V description set // and binding. If resource bindings are provided, the compiler will set the // used_by_shader flag to true in any resource binding actually used by the MSL code. std::string compile(MSLConfiguration &msl_cfg, std::vector *p_vtx_attrs = nullptr, std::vector *p_res_bindings = nullptr); // Compiles the SPIR-V code into Metal Shading Language using default configuration parameters. std::string compile() override; void set_func_name(std::string func_name); protected: void emit_instruction(const Instruction &instr) override; void emit_glsl_op(uint32_t result_type, uint32_t result_id, uint32_t op, const uint32_t *args, uint32_t count) override; void emit_header() override; void emit_function_prototype(SPIRFunction &func, uint64_t return_flags) override; void emit_sampled_image_op(uint32_t result_type, uint32_t result_id, uint32_t image_id, uint32_t samp_id) override; void emit_texture_op(const Instruction &i) override; void emit_fixup() override; std::string type_to_glsl(const SPIRType &type) override; std::string image_type_glsl(const SPIRType &type) override; std::string builtin_to_glsl(spv::BuiltIn builtin) override; std::string member_decl(const SPIRType &type, const SPIRType &member_type, uint32_t member) override; std::string constant_expression(const SPIRConstant &c) override; size_t get_declared_struct_member_size(const SPIRType &struct_type, uint32_t index) const override; std::string to_func_call_arg(uint32_t id) override; std::string to_name(uint32_t id, bool allow_alias = true) override; void extract_builtins(); void add_builtin(spv::BuiltIn builtin_type); void localize_global_variables(); void extract_global_variables_from_functions(); void extract_global_variables_from_function(uint32_t func_id, std::set &added_arg_ids, std::set &global_var_ids, std::set &processed_func_ids); void add_interface_structs(); void bind_vertex_attributes(std::set &bindings); uint32_t add_interface_struct(spv::StorageClass storage, uint32_t vtx_binding = 0); void emit_resources(); void emit_interface_block(uint32_t ib_var_id); void emit_function_prototype(SPIRFunction &func, bool is_decl); void emit_function_declarations(); std::string func_type_decl(SPIRType &type); std::string _clean_msl_main_func_name; std::string clean_func_name(std::string func_name); std::string entry_point_args(bool append_comma); std::string get_entry_point_name(); std::string to_qualified_member_name(const SPIRType &type, uint32_t index); std::string ensure_valid_name(std::string name, std::string pfx); std::string to_sampler_expression(uint32_t id); std::string builtin_qualifier(spv::BuiltIn builtin); std::string builtin_type_decl(spv::BuiltIn builtin); std::string member_attribute_qualifier(const SPIRType &type, uint32_t index); std::string argument_decl(const SPIRFunction::Parameter &arg); std::string get_vtx_idx_var_name(bool per_instance); uint32_t get_metal_resource_index(SPIRVariable &var, SPIRType::BaseType basetype); uint32_t get_ordered_member_location(uint32_t type_id, uint32_t index); uint32_t pad_to_offset(SPIRType &struct_type, bool is_indxd_vtx_input, uint32_t offset, uint32_t struct_size); SPIRType &get_pad_type(uint32_t pad_len); size_t get_declared_type_size(const SPIRType &type) const; size_t get_declared_type_size(const SPIRType &type, uint64_t dec_mask) const; MSLConfiguration msl_config; std::unordered_map vtx_attrs_by_location; std::vector resource_bindings; std::unordered_map builtin_vars; MSLResourceBinding next_metal_resource_index; std::unordered_map pad_type_ids_by_pad_len; std::vector stage_in_var_ids; uint32_t stage_out_var_id = 0; uint32_t stage_uniforms_var_id = 0; std::string qual_pos_var_name; std::string stage_in_var_name = "in"; std::string stage_out_var_name = "out"; std::string stage_uniform_var_name = "uniforms"; std::string sampler_name_suffix = "Smplr"; }; // Sorts the members of a SPIRType and associated Meta info based on a settable sorting // aspect, which defines which aspect of the struct members will be used to sort them. // Regardless of the sorting aspect, built-in members always appear at the end of the struct. struct MemberSorter { enum SortAspect { Location, Offset, }; void sort(); bool operator()(uint32_t mbr_idx1, uint32_t mbr_idx2); MemberSorter(SPIRType &t, Meta &m, SortAspect sa) : type(t) , meta(m) , sort_aspect(sa) { } SPIRType &type; Meta &meta; SortAspect sort_aspect; }; } #endif