MaterialX 1.39.2
Loading...
Searching...
No Matches
MdlShaderGenerator.h
Go to the documentation of this file.
1//
2// Copyright Contributors to the MaterialX Project
3// SPDX-License-Identifier: Apache-2.0
4//
5
6#ifndef MATERIALX_MDLSHADERGENERATOR_H
7#define MATERIALX_MDLSHADERGENERATOR_H
8
11
13
15
16MATERIALX_NAMESPACE_BEGIN
17
19class MX_GENMDL_API GenMdlOptions : public GenUserData
20{
21 public:
23 enum class MdlVersion
24 {
25 MDL_1_6,
26 MDL_1_7,
27 MDL_1_8,
28 MDL_1_9,
29 MDL_LATEST = MDL_1_9
30 };
31
34 targetVersion(MdlVersion::MDL_LATEST) { }
35
37 static const string GEN_CONTEXT_USER_DATA_KEY;
38
43};
44
46using GenMdlOptionsPtr = shared_ptr<class GenMdlOptions>;
47
49using MdlShaderGeneratorPtr = shared_ptr<class MdlShaderGenerator>;
50
53class MX_GENMDL_API MdlShaderGenerator : public ShaderGenerator
54{
55 public:
56 MdlShaderGenerator();
57
58 static ShaderGeneratorPtr create() { return std::make_shared<MdlShaderGenerator>(); }
59
61 const string& getTarget() const override { return TARGET; }
62
65 ShaderPtr generate(const string& name, ElementPtr element, GenContext& context) const override;
66
69 ShaderNodeImplPtr getImplementation(const NodeDef& nodedef, GenContext& context) const override;
70
72 string getUpstreamResult(const ShaderInput* input, GenContext& context) const override;
73
75 static const string TARGET;
76
78 static const std::unordered_map<string, string> GEOMPROP_DEFINITIONS;
79
83
85 void emitMdlVersionNumber(GenContext& context, ShaderStage& stage) const;
86
89
91 const string& getMdlVersionFilenameSuffix(GenContext& context) const;
92
93 protected:
94 // Create and initialize a new MDL shader for shader generation.
95 ShaderPtr createShader(const string& name, ElementPtr element, GenContext& context) const;
96
97 // Emit a block of shader inputs.
98 void emitShaderInputs(ConstDocumentPtr doc, const VariableBlock& inputs, ShaderStage& stage) const;
99};
100
101namespace MDL
102{
103
104// Identifiers for MDL variable blocks
105extern MX_GENMDL_API const string INPUTS;
106extern MX_GENMDL_API const string OUTPUTS;
107
108} // namespace MDL
109
110MATERIALX_NAMESPACE_END
111
112#endif
shared_ptr< const Document > ConstDocumentPtr
A shared pointer to a const Document.
Definition Document.h:24
shared_ptr< Element > ElementPtr
A shared pointer to an Element.
Definition Element.h:31
Macros for declaring imported and exported symbols.
shared_ptr< Shader > ShaderPtr
Shared pointer to a Shader.
Definition Library.h:34
shared_ptr< ShaderNodeImpl > ShaderNodeImplPtr
Shared pointer to a ShaderNodeImpl.
Definition Library.h:40
shared_ptr< ShaderGenerator > ShaderGeneratorPtr
Shared pointer to a ShaderGenerator.
Definition Library.h:38
MX_RENDER_API ShaderPtr createShader(const string &shaderName, GenContext &context, ElementPtr elem)
Create a shader for a given element.
shared_ptr< class MdlShaderGenerator > MdlShaderGeneratorPtr
Shared pointer to an MdlShaderGenerator.
Definition MdlShaderGenerator.h:49
shared_ptr< class GenMdlOptions > GenMdlOptionsPtr
Shared pointer to GenMdlOptions.
Definition MdlShaderGenerator.h:46
Base shader generator class.
A context class for shader generation.
Definition GenContext.h:31
GenMdlOptions()
Create MDL code generator options with default values.
Definition MdlShaderGenerator.h:33
MdlVersion targetVersion
The MDL version number the generated module will have.
Definition MdlShaderGenerator.h:42
MdlVersion
MDL Versions supported by the Code Generator.
Definition MdlShaderGenerator.h:24
static const string GEN_CONTEXT_USER_DATA_KEY
Unique identifier for the MDL options on the GenContext object.
Definition MdlShaderGenerator.h:37
const string & getTarget() const override
Return a unique identifier for the target this generator is for.
Definition MdlShaderGenerator.h:61
static const string TARGET
Unique identifier for this generator target.
Definition MdlShaderGenerator.h:75
ShaderPtr generate(const string &name, ElementPtr element, GenContext &context) const override
Generate a shader starting from the given element, translating the element and all dependencies upstr...
void emitMdlVersionNumber(GenContext &context, ShaderStage &stage) const
Add the MDL file header containing the version number of the generated module.
void emitMdlVersionFilenameSuffix(GenContext &context, ShaderStage &stage) const
Add the version number suffix appended to MDL modules that use versions.
static const std::unordered_map< string, string > GEOMPROP_DEFINITIONS
Map of code snippets for geomprops in MDL.
Definition MdlShaderGenerator.h:78
ShaderNodeImplPtr getImplementation(const NodeDef &nodedef, GenContext &context) const override
Return a registered shader node implementation given an implementation element.
GenMdlOptions::MdlVersion getMdlVersion(GenContext &context) const
Get the selected MDL target language version number from the context option.
const string & getMdlVersionFilenameSuffix(GenContext &context) const
Get the version number suffix appended to MDL modules that use versions.
string getUpstreamResult(const ShaderInput *input, GenContext &context) const override
Return the result of an upstream connection or value for an input.
A node definition element within a Document.
Definition Definition.h:82
ShaderGenerator(SyntaxPtr syntax)
Protected constructor.
An input on a ShaderNode.
Definition ShaderNode.h:264
A shader stage, containing the state and resulting source code for the stage.
Definition ShaderStage.h:139
A block of variables in a shader stage.
Definition ShaderStage.h:61