lightAdapter.h
Go to the documentation of this file.
1 //
2 // Copyright 2017 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_LIGHT_ADAPTER_H
25 #define PXR_USD_IMAGING_USD_IMAGING_LIGHT_ADAPTER_H
26 
28 
29 #include "pxr/pxr.h"
30 #include "pxr/usdImaging/usdImaging/api.h"
32 
33 PXR_NAMESPACE_OPEN_SCOPE
34 
35 
36 class UsdPrim;
37 
43 public:
45 
46  USDIMAGING_API
47  static bool IsEnabledSceneLights();
48 
51  {}
52 
53  USDIMAGING_API
54  ~UsdImagingLightAdapter() override;
55 
56  // ---------------------------------------------------------------------- //
58  // ---------------------------------------------------------------------- //
59 
60  USDIMAGING_API
61  HdContainerDataSourceHandle GetImagingSubprimData(
62  UsdPrim const& prim,
63  TfToken const& subprim,
64  const UsdImagingDataSourceStageGlobals &stageGlobals) override;
65 
66  USDIMAGING_API
67  HdDataSourceLocatorSet InvalidateImagingSubprim(
68  UsdPrim const& prim,
69  TfToken const& subprim,
70  TfTokenVector const& properties) override;
71 
72  // ---------------------------------------------------------------------- //
74  // ---------------------------------------------------------------------- //
75 
76  USDIMAGING_API
77  SdfPath Populate(UsdPrim const& prim,
78  UsdImagingIndexProxy* index,
79  UsdImagingInstancerContext const* instancerContext = NULL) override;
80 
81  USDIMAGING_API
82  bool IsSupported(UsdImagingIndexProxy const* index) const override;
83 
84  // ---------------------------------------------------------------------- //
86  // ---------------------------------------------------------------------- //
87 
89  USDIMAGING_API
90  void TrackVariability(UsdPrim const& prim,
91  SdfPath const& cachePath,
92  HdDirtyBits* timeVaryingBits,
94  instancerContext = NULL) const override;
95 
96 
98  USDIMAGING_API
99  void UpdateForTime(UsdPrim const& prim,
100  SdfPath const& cachePath,
101  UsdTimeCode time,
102  HdDirtyBits requestedBits,
104  instancerContext = NULL) const override;
105 
106  // ---------------------------------------------------------------------- //
108  // ---------------------------------------------------------------------- //
109 
112  USDIMAGING_API
113  HdDirtyBits ProcessPropertyChange(UsdPrim const& prim,
114  SdfPath const& cachePath,
115  TfToken const& propertyName) override;
116 
117  USDIMAGING_API
118  void MarkDirty(UsdPrim const& prim,
119  SdfPath const& cachePath,
120  HdDirtyBits dirty,
121  UsdImagingIndexProxy* index) override;
122 
123  USDIMAGING_API
124  void MarkTransformDirty(UsdPrim const& prim,
125  SdfPath const& cachePath,
126  UsdImagingIndexProxy* index) override;
127 
128  USDIMAGING_API
129  void MarkVisibilityDirty(UsdPrim const& prim,
130  SdfPath const& cachePath,
131  UsdImagingIndexProxy* index) override;
132 
133  USDIMAGING_API
134  void MarkLightParamsDirty(UsdPrim const& prim,
135  SdfPath const& cachePath,
136  UsdImagingIndexProxy* index) override;
137 
138  USDIMAGING_API
139  virtual void MarkCollectionsDirty(UsdPrim const& prim,
140  SdfPath const& cachePath,
141  UsdImagingIndexProxy* index) override;
142 
143  // ---------------------------------------------------------------------- //
145  // ---------------------------------------------------------------------- //
146 
147  USDIMAGING_API
148  VtValue GetMaterialResource(UsdPrim const &prim,
149  SdfPath const& cachePath,
150  UsdTimeCode time) const override;
151 
152 protected:
153  void _RemovePrim(SdfPath const& cachePath,
154  UsdImagingIndexProxy* index) override;
155 
156  // To be called from the Light Populate method
157  void _UnregisterLightCollections(SdfPath const& cachePath);
158 
159  // To be called from the Light _RemovePrim method
160  void _RegisterLightCollections(UsdPrim const& prim);
161 
162 private:
165  bool _UpdateCollectionsChanged(UsdPrim const& prim) const;
166 
167 
168 };
169 
170 
171 PXR_NAMESPACE_CLOSE_SCOPE
172 
173 #endif // PXR_USD_IMAGING_USD_IMAGING_LIGHT_ADAPTER_H
Base class for all lights.
Definition: lightAdapter.h:42
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
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
USDIMAGING_API SdfPath Populate(UsdPrim const &prim, UsdImagingIndexProxy *index, UsdImagingInstancerContext const *instancerContext=NULL) override
Called to populate the RenderIndex for this UsdPrim.
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
USDIMAGING_API void TrackVariability(UsdPrim const &prim, SdfPath const &cachePath, HdDirtyBits *timeVaryingBits, UsdImagingInstancerContext const *instancerContext=NULL) const override
Thread Safe.
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 udpated, or HdChangeTracker::AllDirty if the entire prim must ...
Object used by instancer prim adapters to pass along context about the instancer and instance prim to...
Provides a container which may hold any type, and provides introspection and iteration over array typ...
Definition: value.h:166
USDIMAGING_API void UpdateForTime(UsdPrim const &prim, SdfPath const &cachePath, UsdTimeCode time, HdDirtyBits requestedBits, UsdImagingInstancerContext const *instancerContext=NULL) const override
Thread Safe.
USDIMAGING_API bool IsSupported(UsdImagingIndexProxy const *index) const override
Returns true if the adapter can be populated into the target index.