light.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_ST_LIGHT_H
25 #define PXR_IMAGING_HD_ST_LIGHT_H
26 
27 #include "pxr/pxr.h"
28 #include "pxr/imaging/hdSt/api.h"
29 #include "pxr/imaging/hd/version.h"
30 #include "pxr/imaging/hd/light.h"
31 
33 
34 #include "pxr/base/vt/value.h"
35 
36 PXR_NAMESPACE_OPEN_SCOPE
37 
44 class HdStLight final : public HdLight {
45 public:
46  HDST_API
47  HdStLight(SdfPath const & id, TfToken const &lightType);
48  HDST_API
49  ~HdStLight() override;
50 
52  HDST_API
53  void Sync(HdSceneDelegate *sceneDelegate,
54  HdRenderParam *renderParam,
55  HdDirtyBits *dirtyBits) override;
56 
60  HDST_API
61  void Finalize(HdRenderParam *renderParam) override;
62 
64  HDST_API
65  VtValue Get(TfToken const &token) const;
66 
70  HDST_API
71  HdDirtyBits GetInitialDirtyBitsMask() const override;
72 
73 private:
74  // Converts area lights (sphere lights and distant lights) into
75  // glfSimpleLights and inserts them in the dictionary so
76  // SimpleLightTask can use them later on as if they were regular lights.
77  GlfSimpleLight _ApproximateAreaLight(SdfPath const &id,
78  HdSceneDelegate *sceneDelegate);
79 
80  // Collects data such as the environment map texture path for a
81  // dome light. The lighting shader is responsible for pre-calculating
82  // the different textures needed for IBL.
83  GlfSimpleLight _PrepareDomeLight(SdfPath const &id,
84  HdSceneDelegate *sceneDelegate);
85 
86 private:
87  // Stores the internal light type of this light.
88  TfToken _lightType;
89 
90  // Cached states.
91  TfHashMap<TfToken, VtValue, TfToken::HashFunctor> _params;
92 };
93 
94 
95 PXR_NAMESPACE_CLOSE_SCOPE
96 
97 #endif // PXR_IMAGING_HD_ST_LIGHT_H
HDST_API VtValue Get(TfToken const &token) const
Accessor for tasks to get the parameters cached in this object.
HDST_API void Finalize(HdRenderParam *renderParam) override
Finalizes object resources.
The HdRenderParam is an opaque (to core Hydra) handle, to an object that is obtained from the render ...
A light model for use in Storm.
Definition: light.h:44
Token for efficient comparison, assignment, and hashing of known strings.
Definition: token.h:87
Adapter class providing data exchange with the client scene graph.
HDST_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...
A path value used to locate objects in layers or scenegraphs.
Definition: path.h:290
HDST_API void Sync(HdSceneDelegate *sceneDelegate, HdRenderParam *renderParam, HdDirtyBits *dirtyBits) override
Synchronizes state from the delegate to this object.
Provides a container which may hold any type, and provides introspection and iteration over array typ...
Definition: value.h:166
A light model, used in conjunction with HdRenderPass.
Definition: light.h:82