renderSettings.h
1 //
2 // Copyright 2022 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_RENDER_SETTINGS_H
25 #define PXR_IMAGING_HD_RENDER_SETTINGS_H
26 
27 #include "pxr/pxr.h"
28 #include "pxr/imaging/hd/api.h"
29 #include "pxr/imaging/hd/bprim.h"
30 
31 PXR_NAMESPACE_OPEN_SCOPE
32 
38 {
39 };
40 
66 class HdRenderSettings : public HdBprim
67 {
68 public:
69  // Change tracking for HdRenderSettings.
70  enum DirtyBits : HdDirtyBits {
71  Clean = 0,
72  DirtyActive = 1 << 1,
73  DirtyParams = 1 << 2,
74  AllDirty = (DirtyActive | DirtyParams)
75  };
76 
77  HD_API
78  ~HdRenderSettings() override;
79 
80  // ------------------------------------------------------------------------
81  // Public API
82  // ------------------------------------------------------------------------
83  HD_API
84  bool IsActive() const;
85 
86  HD_API
87  const HdRenderSettingsParams& GetParams() const;
88 
89  // ------------------------------------------------------------------------
90  // Satisfying HdBprim
91  // ------------------------------------------------------------------------
92  HD_API
93  void
94  Sync(HdSceneDelegate *sceneDelegate,
95  HdRenderParam *renderParam,
96  HdDirtyBits *dirtyBits) override final;
97 
98  HD_API
99  HdDirtyBits
100  GetInitialDirtyBitsMask() const override;
101 
102 protected:
103  HD_API
104  HdRenderSettings(SdfPath const& id);
105 
106  // ------------------------------------------------------------------------
107  // Virtual API
108  // ------------------------------------------------------------------------
109  // This is called during Sync after dirty processing and before clearing the
110  // dirty bits.
111  virtual void
112  _Sync(HdSceneDelegate *sceneDelegate,
113  HdRenderParam *renderParam,
114  const HdDirtyBits *dirtyBits);
115 
116 
117 private:
118  // Class cannot be default constructed or copied.
119  HdRenderSettings() = delete;
120  HdRenderSettings(const HdRenderSettings &) = delete;
121  HdRenderSettings &operator =(const HdRenderSettings &) = delete;
122 
123  bool _active;
124  HdRenderSettingsParams _params;
125 };
126 
127 
128 PXR_NAMESPACE_CLOSE_SCOPE
129 
130 #endif // PXR_IMAGING_HD_RENDER_SETTINGS_H
HD_API HdDirtyBits GetInitialDirtyBitsMask() const override
Returns the minimal set of dirty bits to place in the change tracker for use in the first sync of thi...
HD_API void Sync(HdSceneDelegate *sceneDelegate, HdRenderParam *renderParam, HdDirtyBits *dirtyBits) override final
Synchronizes state from the delegate to this object.
The HdRenderParam is an opaque (to core Hydra) handle, to an object that is obtained from the render ...
Adapter class providing data exchange with the client scene graph.
A path value used to locate objects in layers or scenegraphs.
Definition: path.h:290
Abstract hydra prim backing render settings scene description.
Bprim (buffer prim) is a base class of managing a blob of data that is used to communicate between th...
Definition: bprim.h:56
XXX Empty for now, but will be filled up in a follow-up change to mirror UsdRenderSpec.