materialAdapter.h
Go to the documentation of this file.
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_USD_IMAGING_USD_IMAGING_MATERIAL_ADAPTER_H
25 #define PXR_USD_IMAGING_USD_IMAGING_MATERIAL_ADAPTER_H
26 
28 
29 #include "pxr/pxr.h"
32 
33 PXR_NAMESPACE_OPEN_SCOPE
34 
36 
37 
41 {
42 public:
44 
47  {}
48 
49  USDIMAGING_API
50  ~UsdImagingMaterialAdapter() override;
51 
52 
53 
54  // ---------------------------------------------------------------------- //
56  // ---------------------------------------------------------------------- //
57 
58  USDIMAGING_API
59  TfTokenVector GetImagingSubprims(UsdPrim const& prim) override;
60 
61  USDIMAGING_API
62  TfToken GetImagingSubprimType(
63  UsdPrim const& prim,
64  TfToken const& subprim) override;
65 
66  USDIMAGING_API
67  HdContainerDataSourceHandle GetImagingSubprimData(
68  UsdPrim const& prim,
69  TfToken const& subprim,
70  const UsdImagingDataSourceStageGlobals &stageGlobals) override;
71 
72  USDIMAGING_API
73  HdDataSourceLocatorSet InvalidateImagingSubprim(
74  UsdPrim const& prim,
75  TfToken const& subprim,
76  TfTokenVector const& properties) override;
77 
80  USDIMAGING_API
82 
83  USDIMAGING_API
85  UsdPrim const& prim,
86  UsdPrim const& descendentPrim,
87  TfToken const& subprim,
88  TfTokenVector const& properties) override;
89 
90  // ---------------------------------------------------------------------- //
92  // ---------------------------------------------------------------------- //
93 
94  USDIMAGING_API
95  SdfPath Populate(UsdPrim const& prim,
96  UsdImagingIndexProxy* index,
97  UsdImagingInstancerContext const* instancerContext = NULL) override;
98 
99  USDIMAGING_API
100  bool IsSupported(UsdImagingIndexProxy const* index) const override;
101 
102  // ---------------------------------------------------------------------- //
104  // ---------------------------------------------------------------------- //
105 
107  USDIMAGING_API
108  void TrackVariability(UsdPrim const& prim,
109  SdfPath const& cachePath,
110  HdDirtyBits* timeVaryingBits,
112  instancerContext = NULL) const override;
113 
114 
116  USDIMAGING_API
117  void UpdateForTime(UsdPrim const& prim,
118  SdfPath const& cachePath,
119  UsdTimeCode time,
120  HdDirtyBits requestedBits,
122  instancerContext = NULL) const override;
123 
124  // ---------------------------------------------------------------------- //
126  // ---------------------------------------------------------------------- //
127 
130  USDIMAGING_API
131  HdDirtyBits ProcessPropertyChange(UsdPrim const& prim,
132  SdfPath const& cachePath,
133  TfToken const& propertyName) override;
134 
135  USDIMAGING_API
136  void MarkDirty(UsdPrim const& prim,
137  SdfPath const& cachePath,
138  HdDirtyBits dirty,
139  UsdImagingIndexProxy* index) override;
140 
141  USDIMAGING_API
142  void MarkMaterialDirty(UsdPrim const& prim,
143  SdfPath const& cachePath,
144  UsdImagingIndexProxy* index) override;
145 
146  USDIMAGING_API
147  void ProcessPrimResync(SdfPath const& cachePath,
148  UsdImagingIndexProxy* index) override;
149 
150  // ---------------------------------------------------------------------- //
152  // ---------------------------------------------------------------------- //
153 
154  USDIMAGING_API
155  VtValue GetMaterialResource(UsdPrim const &prim,
156  SdfPath const& cachePath,
157  UsdTimeCode time) const override;
158 
159 protected:
160  USDIMAGING_API
161  void _RemovePrim(SdfPath const& cachePath,
162  UsdImagingIndexProxy* index) final;
163 };
164 
170 {
171 public:
173 
176 };
177 
178 PXR_NAMESPACE_CLOSE_SCOPE
179 
180 #endif // PXR_USD_IMAGING_USD_IMAGING_MATERIAL_ADAPTER_H
USDIMAGING_API PopulationMode GetPopulationMode() override
Returns RepresentsSelfAndDescendents to suppress population of child Shader prims and receive notice ...
Base class for all prim adapters which only want to indicate that an ancestor prim is responsible for...
USDIMAGING_API void ProcessPrimResync(SdfPath const &cachePath, UsdImagingIndexProxy *index) override
When a PrimResync event occurs, the prim may have been deleted entirely, adapter plug-ins should over...
This proxy class exposes a subset of the private Delegate API to PrimAdapters.
Definition: indexProxy.h:47
Token for efficient comparison, assignment, and hashing of known strings.
Definition: token.h:87
USDIMAGING_API SdfPath Populate(UsdPrim const &prim, UsdImagingIndexProxy *index, UsdImagingInstancerContext const *instancerContext=NULL) override
Called to populate the RenderIndex for this UsdPrim.
USDIMAGING_API bool IsSupported(UsdImagingIndexProxy const *index) const override
Returns true if the adapter can be populated into the target index.
Represent a time value, which may be either numeric, holding a double value, or a sentinel value UsdT...
Definition: timeCode.h:85
This class is used as a context object with global stage information, that gets passed down to dataso...
Base class for all PrimAdapters.
Definition: primAdapter.h:67
Represents a set of data source locators closed under descendancy.
UsdPrim is the sole persistent scenegraph object on a UsdStage, and is the embodiment of a "Prim" as ...
Definition: prim.h:135
std::vector< TfToken > TfTokenVector
Convenience types.
Definition: token.h:442
A path value used to locate objects in layers or scenegraphs.
Definition: path.h:290
USDIMAGING_API HdDirtyBits ProcessPropertyChange(UsdPrim const &prim, SdfPath const &cachePath, TfToken const &propertyName) override
Returns a bit mask of attributes to be updated, or HdChangeTracker::AllDirty if the entire prim must ...
USDIMAGING_API void UpdateForTime(UsdPrim const &prim, SdfPath const &cachePath, UsdTimeCode time, HdDirtyBits requestedBits, UsdImagingInstancerContext const *instancerContext=NULL) const override
Thread Safe.
Delegates invalidation responsibility of a Shader prim to an ancestor Material prim.
USDIMAGING_API HdDataSourceLocatorSet InvalidateImagingSubprimFromDescendent(UsdPrim const &prim, UsdPrim const &descendentPrim, TfToken const &subprim, TfTokenVector const &properties) override
This is called (for each result of GetImagingSubprims) when this adapter's GetScope() result is Repre...
Object used by instancer prim adapters to pass along context about the instancer and instance prim to...
Provides information that can be used to generate a material.
Describes a map from network type to network.
Definition: material.h:126
Provides a container which may hold any type, and provides introspection and iteration over array typ...
Definition: value.h:166
USDIMAGING_API void TrackVariability(UsdPrim const &prim, SdfPath const &cachePath, HdDirtyBits *timeVaryingBits, UsdImagingInstancerContext const *instancerContext=NULL) const override
Thread Safe.