HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
bprim.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_IMAGING_HD_BPRIM_H
25 #define PXR_IMAGING_HD_BPRIM_H
26 
27 #include "pxr/pxr.h"
28 #include "pxr/imaging/hd/api.h"
29 #include "pxr/imaging/hd/version.h"
30 #include "pxr/imaging/hd/types.h"
31 
32 #include "pxr/usd/sdf/path.h"
33 
35 
36 class HdSceneDelegate;
37 class HdRenderParam;
38 
39 /// \class HdBprim
40 ///
41 /// Bprim (buffer prim) is a base class of managing a blob of data that is
42 /// used to communicate between the scene delegate and render.
43 ///
44 /// Like other prim types (Rprim and Sprim), the Bprim communicates with the
45 /// scene delegate got get buffer properties (e.g. the size of the buffer) as
46 /// well as the contents of the buffer.
47 ///
48 /// Changes to the properties and contents are change tracked and updates
49 /// are cached in the renderer. The Render Delegate may choose to transform
50 /// the data into a renderer specific form on download.
51 ///
52 /// BPrims are sync'ed first and thus, Bprims should not be
53 /// Dependent on the state of any other prim.
54 ///
55 /// The most typical use of a Bprim would be a Texture.
56 class HdBprim
57 {
58 public:
59  HD_API
60  HdBprim(SdfPath const & id);
61  HD_API
62  virtual ~HdBprim();
63 
64  /// Returns the identifier by which this buffer is known. This
65  /// identifier is a common associative key used by the SceneDelegate,
66  /// RenderIndex, and for binding to the buffer
67  SdfPath const& GetId() const { return _id; }
68 
69  /// Synchronizes state from the delegate to this object.
70  /// @param[in, out] dirtyBits: On input specifies which state is
71  /// is dirty and can be pulled from the scene
72  /// delegate.
73  /// On output specifies which bits are still
74  /// dirty and were not cleaned by the sync.
75  ///
76  virtual void Sync(HdSceneDelegate *sceneDelegate,
77  HdRenderParam *renderParam,
78  HdDirtyBits *dirtyBits) = 0;
79 
80  /// Finalizes object resources. This function might not delete resources,
81  /// but it should deal with resource ownership so that the sprim is
82  /// deletable.
83  HD_API
84  virtual void Finalize(HdRenderParam *renderParam);
85 
86  /// Returns the minimal set of dirty bits to place in the
87  /// change tracker for use in the first sync of this prim.
88  /// Typically this would be all dirty bits.
89  virtual HdDirtyBits GetInitialDirtyBitsMask() const = 0;
90 
91 private:
92  SdfPath _id;
93 };
94 
95 
97 
98 #endif // PXR_IMAGING_HD_BPRIM_H
virtual HdDirtyBits GetInitialDirtyBitsMask() const =0
uint32_t HdDirtyBits
Definition: types.h:158
#define HD_API
Definition: api.h:40
virtual HD_API ~HdBprim()
SdfPath const & GetId() const
Definition: bprim.h:67
HD_API HdBprim(SdfPath const &id)
Definition: path.h:290
virtual void Sync(HdSceneDelegate *sceneDelegate, HdRenderParam *renderParam, HdDirtyBits *dirtyBits)=0
virtual HD_API void Finalize(HdRenderParam *renderParam)
PXR_NAMESPACE_CLOSE_SCOPE PXR_NAMESPACE_OPEN_SCOPE
Definition: path.h:1432
#define PXR_NAMESPACE_CLOSE_SCOPE
Definition: pxr.h:91
Definition: bprim.h:56