Berserk
Material.hpp
Go to the documentation of this file.
1 /**********************************************************************************/
2 /* This file is part of Berserk Engine project */
3 /* https://github.com/EgorOrachyov/Berserk */
4 /**********************************************************************************/
5 /* MIT License */
6 /* */
7 /* Copyright (c) 2018 - 2021 Egor Orachyov */
8 /* */
9 /* Permission is hereby granted, free of charge, to any person obtaining a copy */
10 /* of this software and associated documentation files (the "Software"), to deal */
11 /* in the Software without restriction, including without limitation the rights */
12 /* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell */
13 /* copies of the Software, and to permit persons to whom the Software is */
14 /* furnished to do so, subject to the following conditions: */
15 /* */
16 /* The above copyright notice and this permission notice shall be included in all */
17 /* copies or substantial portions of the Software. */
18 /* */
19 /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR */
20 /* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, */
21 /* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE */
22 /* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER */
23 /* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, */
24 /* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE */
25 /* SOFTWARE. */
26 /**********************************************************************************/
27 
28 #ifndef BERSERK_MATERIAL_HPP
29 #define BERSERK_MATERIAL_HPP
30 
31 #include <core/Config.hpp>
32 #include <core/Typedefs.hpp>
33 #include <core/math/TMatMxN.hpp>
34 #include <core/math/TVecN.hpp>
36 #include <render/shader/Shader.hpp>
37 #include <rhi/RHISampler.hpp>
38 #include <rhi/RHITexture.hpp>
39 
40 #include <vector>
41 
43 
63 class Material final : public RefCnt {
64 public:
74  BRK_API explicit Material(Ref<const Shader> shader);
75 
76  BRK_API ~Material() override = default;
77 
79  BRK_API void SetName(StringName name);
81  BRK_API void SetDescription(String description);
82 
94  BRK_API void SetTexture(const StringName &name, Ref<RHITexture> texture, Ref<RHISampler> sampler, uint32 arrayIndex = 0);
95 
106  BRK_API void SetFloat1(const StringName &name, float value, uint32 arrayIndex = 0);
107 
118  BRK_API void SetFloat2(const StringName &name, const Vec2f &value, uint32 arrayIndex = 0);
119 
130  BRK_API void SetFloat3(const StringName &name, const Vec3f &value, uint32 arrayIndex = 0);
131 
142  BRK_API void SetFloat4(const StringName &name, const Vec4f &value, uint32 arrayIndex = 0);
143 
154  BRK_API void SetInt1(const StringName &name, int32 value, uint32 arrayIndex = 0);
155 
166  BRK_API void SetInt2(const StringName &name, const Vec2i &value, uint32 arrayIndex = 0);
167 
178  BRK_API void SetInt3(const StringName &name, const Vec3i &value, uint32 arrayIndex = 0);
179 
190  BRK_API void SetInt4(const StringName &name, const Vec4i &value, uint32 arrayIndex = 0);
191 
202  BRK_API void SetUInt1(const StringName &name, uint32 value, uint32 arrayIndex = 0);
203 
214  BRK_API void SetUInt2(const StringName &name, const Vec2u &value, uint32 arrayIndex = 0);
215 
226  BRK_API void SetUInt3(const StringName &name, const Vec3u &value, uint32 arrayIndex = 0);
227 
238  BRK_API void SetUInt4(const StringName &name, const Vec4u &value, uint32 arrayIndex = 0);
239 
250  BRK_API void SetBool1(const StringName &name, bool value, uint32 arrayIndex = 0);
251 
262  BRK_API void SetBool2(const StringName &name, const Vec2b &value, uint32 arrayIndex = 0);
263 
274  BRK_API void SetBool3(const StringName &name, const Vec3b &value, uint32 arrayIndex = 0);
275 
286  BRK_API void SetBool4(const StringName &name, const Vec4b &value, uint32 arrayIndex = 0);
287 
298  BRK_API void SetMat2(const StringName &name, const Mat2x2f &value, uint32 arrayIndex = 0);
299 
310  BRK_API void SetMat3(const StringName &name, const Mat3x3f &value, uint32 arrayIndex = 0);
311 
322  BRK_API void SetMat4(const StringName &name, const Mat4x4f &value, uint32 arrayIndex = 0);
323 
330  BRK_API void UpdatePack();
331 
333  BRK_API bool IsDirty() const { return mIsDirty; }
334 
335  BRK_API const StringName &GetName() const { return mName; }
336  BRK_API const String &GetDescription() const { return mDescription; }
337  BRK_API const Ref<const Shader> &GetShader() const { return mShader; }
338  BRK_API const Ref<const ShaderTechnique> &GetTechnique() const { return mTechnique; }
339  BRK_API const ShaderVariation &GetVariation() const { return mShader->GetVariation(); }
340 
342  BRK_API Ref<const MaterialParams> GetPackedParams() const { return mPackedParams.As<const MaterialParams>(); }
343 
344 private:
345  friend class MaterialParams;
346 
347  void SetDataParam(const StringName &name, RHIShaderDataType type, const void *data, uint32 arrayIndex);
348  const std::vector<Ref<RHISampler>> &GetSamplers() const { return mSamplers; }
349  const std::vector<Ref<RHITexture>> &GetTextures() const { return mTextures; }
350  const std::vector<unsigned char> &GetDataParams() const { return mDataParams; }
351 
352 private:
353  StringName mName;
354  String mDescription;
356  Ref<const Shader> mShader;
357  Ref<const ShaderTechnique> mTechnique;
358  Ref<MaterialParams> mPackedParams;
360  std::vector<Ref<RHISampler>> mSamplers;
361  std::vector<Ref<RHITexture>> mTextures;
362  std::vector<unsigned char> mDataParams;
364  bool mIsDirty = true;
365 };
366 
372 
373 #endif//BERSERK_MATERIAL_HPP
#define BRK_NS_END
Definition: Config.hpp:48
#define BRK_API
Definition: Config.hpp:32
std::int32_t int32
Definition: Typedefs.hpp:43
std::uint32_t uint32
Definition: Typedefs.hpp:44
Packed material params ready for rendering usage.
Definition: MaterialParams.hpp:50
Controls how object is actually rendered.
Definition: Material.hpp:63
BRK_API void UpdatePack()
Update rhi-set of the material.
Definition: Material.cpp:170
BRK_API void SetFloat2(const StringName &name, const Vec2f &value, uint32 arrayIndex=0)
Set material float vec2 parameter.
Definition: Material.cpp:98
BRK_API void SetFloat4(const StringName &name, const Vec4f &value, uint32 arrayIndex=0)
Set material float vec4 parameter.
Definition: Material.cpp:106
BRK_API void SetBool2(const StringName &name, const Vec2b &value, uint32 arrayIndex=0)
Set material bool vec2 parameter.
Definition: Material.cpp:146
BRK_API void SetInt1(const StringName &name, int32 value, uint32 arrayIndex=0)
Set material int parameter.
Definition: Material.cpp:110
BRK_API Ref< const MaterialParams > GetPackedParams() const
Definition: Material.hpp:342
BRK_API void SetTexture(const StringName &name, Ref< RHITexture > texture, Ref< RHISampler > sampler, uint32 arrayIndex=0)
Set material texture parameter.
Definition: Material.cpp:71
BRK_API void SetBool4(const StringName &name, const Vec4b &value, uint32 arrayIndex=0)
Set material bool vec4 parameter.
Definition: Material.cpp:154
BRK_API void SetInt2(const StringName &name, const Vec2i &value, uint32 arrayIndex=0)
Set material int vec2 parameter.
Definition: Material.cpp:114
BRK_API void SetBool1(const StringName &name, bool value, uint32 arrayIndex=0)
Set material bool parameter.
Definition: Material.cpp:142
BRK_API void SetMat4(const StringName &name, const Mat4x4f &value, uint32 arrayIndex=0)
Set material float mat4x4 parameter.
Definition: Material.cpp:166
BRK_API Material(Ref< const Shader > shader)
Creates new material instance from provided shader.
Definition: Material.cpp:35
BRK_API void SetName(StringName name)
Definition: Material.cpp:63
BRK_API const String & GetDescription() const
Definition: Material.hpp:336
BRK_API void SetBool3(const StringName &name, const Vec3b &value, uint32 arrayIndex=0)
Set material bool vec3 parameter.
Definition: Material.cpp:150
BRK_API const Ref< const Shader > & GetShader() const
Definition: Material.hpp:337
BRK_API void SetUInt1(const StringName &name, uint32 value, uint32 arrayIndex=0)
Set material uint parameter.
Definition: Material.cpp:126
BRK_API ~Material() override=default
BRK_API void SetMat2(const StringName &name, const Mat2x2f &value, uint32 arrayIndex=0)
Set material float mat2x2 parameter.
Definition: Material.cpp:158
BRK_API const Ref< const ShaderTechnique > & GetTechnique() const
Definition: Material.hpp:338
BRK_API void SetInt3(const StringName &name, const Vec3i &value, uint32 arrayIndex=0)
Set material int vec3 parameter.
Definition: Material.cpp:118
BRK_API void SetUInt2(const StringName &name, const Vec2u &value, uint32 arrayIndex=0)
Set material uint vec2 parameter.
Definition: Material.cpp:130
BRK_API void SetInt4(const StringName &name, const Vec4i &value, uint32 arrayIndex=0)
Set material int vec4 parameter.
Definition: Material.cpp:122
BRK_API void SetUInt3(const StringName &name, const Vec3u &value, uint32 arrayIndex=0)
Set material uint vec3 parameter.
Definition: Material.cpp:134
BRK_API void SetFloat3(const StringName &name, const Vec3f &value, uint32 arrayIndex=0)
Set material float vec3 parameter.
Definition: Material.cpp:102
BRK_API const ShaderVariation & GetVariation() const
Definition: Material.hpp:339
BRK_API bool IsDirty() const
Definition: Material.hpp:333
BRK_API void SetMat3(const StringName &name, const Mat3x3f &value, uint32 arrayIndex=0)
Set material float mat3x3 parameter.
Definition: Material.cpp:162
BRK_API void SetUInt4(const StringName &name, const Vec4u &value, uint32 arrayIndex=0)
Set material uint vec4 parameter.
Definition: Material.cpp:138
BRK_API void SetFloat1(const StringName &name, float value, uint32 arrayIndex=0)
Set material float parameter.
Definition: Material.cpp:94
BRK_API const StringName & GetName() const
Definition: Material.hpp:335
BRK_API void SetDescription(String description)
Definition: Material.cpp:67
Reference counted base object.
Definition: RefCnt.hpp:52
Ref< G > As() const
Definition: Ref.hpp:139
Describes variation of compiled shader of the single type (max 64 flags)
BRK_API const ShaderVariation & GetVariation() const
Definition: Shader.hpp:111
Cached shared utf-8 string id.
Definition: StringName.hpp:61
Utf-8 encoded std based default string class.
Generic matrix of M x N size for space of type T.
Definition: TMatMxN.hpp:56
RHIShaderDataType
Definition: RHIDefs.hpp:83
Definition: GLDevice.cpp:46