2019-11-23 20:27:39 +08:00
|
|
|
/****************************************************************************
|
|
|
|
Copyright (c) 2018-2019 Xiamen Yaji Software Co., Ltd.
|
|
|
|
|
2022-10-01 16:24:52 +08:00
|
|
|
https://axmolengine.github.io/
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
|
|
in the Software without restriction, including without limitation the rights
|
|
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
|
|
all copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
THE SOFTWARE.
|
|
|
|
****************************************************************************/
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include "../Program.h"
|
|
|
|
#import <Metal/Metal.h>
|
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
NS_AX_BACKEND_BEGIN
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
class ShaderModuleMTL;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @addtogroup _metal
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A metal Program
|
|
|
|
*/
|
|
|
|
class ProgramMTL : public Program
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
/// @name Constructor, Destructor and Initializers
|
|
|
|
/**
|
|
|
|
* @param vertexShader Specifes the vertex shader source.
|
|
|
|
* @param fragmentShader Specifes the fragment shader source.
|
|
|
|
*/
|
2021-12-31 12:12:40 +08:00
|
|
|
ProgramMTL(std::string_view vertexShader, std::string_view fragmentShader);
|
2019-11-23 20:27:39 +08:00
|
|
|
virtual ~ProgramMTL();
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get uniform location by name.
|
|
|
|
* @param uniform Specifies the uniform name.
|
|
|
|
* @return The uniform location.
|
|
|
|
*/
|
2021-12-31 12:12:40 +08:00
|
|
|
virtual UniformLocation getUniformLocation(std::string_view uniform) const override;
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get uniform location by engine built-in uniform enum name.
|
|
|
|
* @param name Specifies the engine built-in uniform enum name.
|
|
|
|
* @return The uniform location.
|
|
|
|
*/
|
|
|
|
virtual UniformLocation getUniformLocation(backend::Uniform name) const override;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get attribute location by attribute name.
|
|
|
|
* @param name Specifies the attribute name.
|
|
|
|
* @return The attribute location.
|
|
|
|
*/
|
2021-12-31 12:12:40 +08:00
|
|
|
virtual int getAttributeLocation(std::string_view name) const override;
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get attribute location by engine built-in attribute enum name.
|
|
|
|
* @param name Specifies the engine built-in attribute enum name.
|
|
|
|
* @return The attribute location.
|
|
|
|
*/
|
|
|
|
virtual int getAttributeLocation(Attribute name) const override;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get vertex shader module.
|
|
|
|
* @return Vertex shader module.
|
|
|
|
*/
|
|
|
|
virtual ShaderModuleMTL* getVertexShader() const { return _vertexShader; }
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get fragment shader module.
|
|
|
|
* @ Fragment shader module.
|
|
|
|
*/
|
|
|
|
virtual ShaderModuleMTL* getFragmentShader() const { return _fragmentShader; }
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get active vertex attributes.
|
|
|
|
* @return Active vertex attributes. key is active attribute name, Value is corresponding attribute info.
|
|
|
|
*/
|
2022-09-24 11:38:41 +08:00
|
|
|
const hlookup::string_map<AttributeBindInfo>& getActiveAttributes() const override;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get maximum vertex location.
|
|
|
|
* @return Maximum vertex locaiton.
|
|
|
|
*/
|
|
|
|
virtual int getMaxVertexLocation() const override;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get maximum fragment location.
|
|
|
|
* @return Maximum fragment location.
|
|
|
|
*/
|
|
|
|
virtual int getMaxFragmentLocation() const override;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get uniform buffer size in bytes that can hold all the uniforms.
|
|
|
|
* @param stage Specifies the shader stage. The symbolic constant can be either VERTEX or FRAGMENT.
|
|
|
|
* @return The uniform buffer size in bytes.
|
|
|
|
*/
|
|
|
|
virtual std::size_t getUniformBufferSize(ShaderStage stage) const override;
|
|
|
|
|
2023-08-25 16:46:32 +08:00
|
|
|
/**
|
|
|
|
* Get a uniformInfo in given location from the specific shader stage.
|
|
|
|
* @param stage Specifies the shader stage. The symbolic constant can be either VERTEX or FRAGMENT.
|
|
|
|
* @param location Specifies the uniform locaion.
|
|
|
|
* @return The uniformInfo.
|
|
|
|
*/
|
|
|
|
virtual const UniformInfo& getActiveUniformInfo(ShaderStage stage, int location) const override;
|
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get all uniformInfos.
|
|
|
|
* @return The uniformInfos.
|
|
|
|
*/
|
2021-12-31 12:12:40 +08:00
|
|
|
virtual const hlookup::string_map<UniformInfo>& getAllActiveUniformInfo(ShaderStage stage) const override;
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
private:
|
2021-12-25 10:04:45 +08:00
|
|
|
ShaderModuleMTL* _vertexShader = nullptr;
|
2019-11-23 20:27:39 +08:00
|
|
|
ShaderModuleMTL* _fragmentShader = nullptr;
|
|
|
|
};
|
|
|
|
|
|
|
|
// end of _metal group
|
|
|
|
/// @}
|
2022-07-11 17:50:21 +08:00
|
|
|
NS_AX_BACKEND_END
|