All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
material.h
1 //
2 // Copyright 2016 Pixar
3 //
4 // Licensed under the Apache License, Version 2.0 (the "Apache License")
5 // with the following modification; you may not use this file except in
6 // compliance with the Apache License and the following modification to it:
7 // Section 6. Trademarks. is deleted and replaced with:
8 //
9 // 6. Trademarks. This License does not grant permission to use the trade
10 // names, trademarks, service marks, or product names of the Licensor
11 // and its affiliates, except as required to comply with Section 4(c) of
12 // the License and to reproduce the content of the NOTICE file.
13 //
14 // You may obtain a copy of the Apache License at
15 //
16 // http://www.apache.org/licenses/LICENSE-2.0
17 //
18 // Unless required by applicable law or agreed to in writing, software
19 // distributed under the Apache License with the above modification is
20 // distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
21 // KIND, either express or implied. See the Apache License for the specific
22 // language governing permissions and limitations under the Apache License.
23 //
24 #ifndef PXR_IMAGING_HD_MATERIAL_H
25 #define PXR_IMAGING_HD_MATERIAL_H
26 
27 #include "pxr/pxr.h"
28 #include "pxr/imaging/hd/api.h"
29 #include "pxr/imaging/hd/sprim.h"
30 #include "pxr/imaging/hd/sceneDelegate.h"
31 
32 PXR_NAMESPACE_OPEN_SCOPE
33 
37 class HdMaterial : public HdSprim {
38 public:
39  // change tracking for HdMaterial prim
40  enum DirtyBits : HdDirtyBits {
41  Clean = 0,
42  // XXX: Got to skip varying and force sync bits for now
43  DirtyParams = 1 << 2,
44  DirtyResource = 1 << 3,
45  AllDirty = (DirtyParams | DirtyResource)
46  };
47 
48  HD_API
49  virtual ~HdMaterial();
50 
51 protected:
52  HD_API
53  HdMaterial(SdfPath const& id);
54 
55 private:
56  // Class can not be default constructed or copied.
57  HdMaterial() = delete;
58  HdMaterial(const HdMaterial &) = delete;
59  HdMaterial &operator =(const HdMaterial &) = delete;
60 };
61 
62 
83  SdfPath inputId;
84  TfToken inputName;
85  SdfPath outputId;
86  TfToken outputName;
87 };
88 
89 // VtValue requirements
90 HD_API
91 bool operator==(const HdMaterialRelationship& lhs,
92  const HdMaterialRelationship& rhs);
93 HD_API
94 size_t hash_value(const HdMaterialRelationship& rel);
95 
96 
102  SdfPath path;
103  TfToken identifier;
104  std::map<TfToken, VtValue> parameters;
105 };
106 
107 // VtValue requirements
108 HD_API
109 bool operator==(const HdMaterialNode& lhs, const HdMaterialNode& rhs);
110 HD_API
111 size_t hash_value(const HdMaterialNode& node);
112 
113 
119  std::vector<HdMaterialRelationship> relationships;
120  std::vector<HdMaterialNode> nodes;
121  TfTokenVector primvars;
122 };
123 
128  std::map<TfToken, HdMaterialNetwork> map;
129  std::vector<SdfPath> terminals;
130 };
131 
132 
141 
147  SdfPath upstreamNode;
148  TfToken upstreamOutputName;
149 
150  bool operator==(const HdMaterialConnection2 & rhs) const {
151  return upstreamNode == rhs.upstreamNode
152  && upstreamOutputName == rhs.upstreamOutputName;
153  }
154 };
155 
163  TfToken nodeTypeId;
164  std::map<TfToken, VtValue> parameters;
165  std::map<TfToken, std::vector<HdMaterialConnection2>> inputConnections;
166 
167  bool operator==(const HdMaterialNode2 & rhs) const {
168  return nodeTypeId == rhs.nodeTypeId
169  && parameters == rhs.parameters
170  && inputConnections == rhs.inputConnections;
171  }
172 };
173 
180  std::map<SdfPath, HdMaterialNode2> nodes;
181  std::map<TfToken, HdMaterialConnection2> terminals;
182  TfTokenVector primvars;
183 
184  bool operator==(const HdMaterialNetwork2 & rhs) const {
185  return nodes == rhs.nodes
186  && terminals == rhs.terminals
187  && primvars == rhs.primvars;
188  }
189 };
190 
192 HD_API
193 void HdMaterialNetwork2ConvertFromHdMaterialNetworkMap(
194  const HdMaterialNetworkMap & hdNetworkMap,
195  HdMaterialNetwork2 *result,
196  bool *isVolume = nullptr);
197 
198 
199 // VtValue requirements
200 HD_API
201 std::ostream& operator<<(std::ostream& out, const HdMaterialNetwork& pv);
202 HD_API
203 bool operator==(const HdMaterialNetwork& lhs, const HdMaterialNetwork& rhs);
204 HD_API
205 bool operator!=(const HdMaterialNetwork& lhs, const HdMaterialNetwork& rhs);
206 HD_API
207 size_t hash_value(const HdMaterialNetwork& network);
208 
209 HD_API
210 std::ostream& operator<<(std::ostream& out,
211  const HdMaterialNetworkMap& pv);
212 HD_API
213 bool operator==(const HdMaterialNetworkMap& lhs,
214  const HdMaterialNetworkMap& rhs);
215 HD_API
216 bool operator!=(const HdMaterialNetworkMap& lhs,
217  const HdMaterialNetworkMap& rhs);
218 HD_API
219 size_t hash_value(const HdMaterialNetworkMap& networkMap);
220 
221 
222 PXR_NAMESPACE_CLOSE_SCOPE
223 
224 #endif // PXR_IMAGING_HD_MATERIAL_H
HdMaterialNetwork2.
Definition: material.h:146
Describes a material node which is made of a path, an identifier and a list of parameters.
Definition: material.h:101
Describes a material network composed of nodes, primvars, and relationships between the nodes and ter...
Definition: material.h:118
Token for efficient comparison, assignment, and hashing of known strings.
Definition: token.h:87
Describes an instance of a node within a network A node contains a (shader) type identifier, parameter values, and connections to upstream nodes.
Definition: material.h:162
std::vector< TfToken > TfTokenVector
Convenience types.
Definition: token.h:442
A path value used to locate objects in layers or scenegraphs.
Definition: path.h:288
Sprim (state prim) is a base class of managing state for non-drawable scene entity (e...
Definition: sprim.h:52
GF_API std::ostream & operator<<(std::ostream &, const GfBBox3d &)
Output a GfBBox3d using the format [(range) matrix zeroArea].
Hydra Schema for a material object.
Definition: material.h:37
VT_API bool operator==(VtDictionary const &, VtDictionary const &)
Equality comparison.
Container of nodes and top-level terminal connections.
Definition: material.h:179
Describes a map from network type to network.
Definition: material.h:127
Describes a connection between two nodes in a material.
Definition: material.h:82