All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
bufferArrayRange.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_BUFFER_ARRAY_RANGE_H
25 #define PXR_IMAGING_HD_BUFFER_ARRAY_RANGE_H
26 
27 #include "pxr/pxr.h"
28 #include "pxr/imaging/hd/api.h"
29 #include "pxr/imaging/hd/version.h"
30 #include "pxr/base/tf/token.h"
31 #include "pxr/base/vt/value.h"
32 #include "pxr/imaging/hd/bufferArray.h"
33 
34 #include <memory>
35 
36 PXR_NAMESPACE_OPEN_SCOPE
37 
38 
39 using HdBufferSpecVector = std::vector<struct HdBufferSpec>;
40 using HdBufferArrayRangeSharedPtr = std::shared_ptr<class HdBufferArrayRange>;
41 using HdBufferSourceSharedPtr = std::shared_ptr<class HdBufferSource>;
42 
52 {
53 public:
54 
55  HD_API
57 
63  HD_API
64  virtual ~HdBufferArrayRange();
65 
67  virtual bool IsValid() const = 0;
68 
70  virtual bool IsAssigned() const = 0;
71 
73  virtual bool IsImmutable() const = 0;
74 
77  virtual bool Resize(int numElements) = 0;
78 
80  virtual void CopyData(HdBufferSourceSharedPtr const &bufferSource) = 0;
81 
83  virtual VtValue ReadData(TfToken const &name) const = 0;
84 
87  virtual int GetElementOffset() const = 0;
88 
91  virtual int GetByteOffset(TfToken const& resourceName) const = 0;
92 
94  virtual size_t GetNumElements() const = 0;
95 
97  virtual size_t GetVersion() const = 0;
98 
101  virtual void IncrementVersion() = 0;
102 
104  virtual size_t GetMaxNumElements() const = 0;
105 
107  virtual HdBufferArrayUsageHint GetUsageHint() const = 0;
108 
110  virtual void SetBufferArray(HdBufferArray *bufferArray) = 0;
111 
113  virtual void DebugDump(std::ostream &out) const = 0;
114 
116  bool IsAggregatedWith(HdBufferArrayRangeSharedPtr const &other) const {
117  return (other && (_GetAggregation() == other->_GetAggregation()));
118  }
119 
121  virtual void GetBufferSpecs(HdBufferSpecVector *bufferSpecs) const = 0;
122 
123 protected:
125  virtual const void *_GetAggregation() const = 0;
126 
127  // Don't allow copies
128  HdBufferArrayRange(const HdBufferArrayRange &) = delete;
129  HdBufferArrayRange &operator=(const HdBufferArrayRange &) = delete;
130 
131 };
132 
133 HD_API
134 std::ostream &operator <<(std::ostream &out,
135  const HdBufferArrayRange &self);
136 
142 {
143 public:
145  HdBufferArrayRangeContainer(int size) : _ranges(size) { }
146 
149  HD_API
150  void Set(int index, HdBufferArrayRangeSharedPtr const &range);
151 
154  HD_API
155  HdBufferArrayRangeSharedPtr const &Get(int index) const;
156 
159  HD_API
160  void Resize(int size);
161 
162 private:
163  std::vector<HdBufferArrayRangeSharedPtr> _ranges;
164 };
165 
166 
167 PXR_NAMESPACE_CLOSE_SCOPE
168 
169 #endif // PXR_IMAGING_HD_BUFFER_ARRAY_RANGE_H
virtual bool IsValid() const =0
Returns true if this range is valid.
The union provides a set of flags that provide hints to the memory management system about the proper...
Definition: bufferArray.h:70
Similar to a VAO, this object is a bundle of coherent buffers.
Definition: bufferArray.h:88
virtual VtValue ReadData(TfToken const &name) const =0
Read back the buffer content.
bool IsAggregatedWith(HdBufferArrayRangeSharedPtr const &other) const
Returns true if the underlying buffer array is aggregated to other&#39;s.
virtual int GetByteOffset(TfToken const &resourceName) const =0
Returns the byte offset at which this range begins in the underlying buffer array for the given resou...
virtual bool IsImmutable() const =0
Returns true if this range is marked as immutable.
virtual size_t GetVersion() const =0
Returns the version of the buffer array.
Interface class for representing range (subset) locator of HdBufferArray.
virtual size_t GetMaxNumElements() const =0
Returns the max number of elements.
A resizable container of HdBufferArrayRanges.
virtual int GetElementOffset() const =0
Returns the offset at which this range begins in the underlying buffer array in terms of elements...
virtual bool IsAssigned() const =0
Returns true is the range has been assigned to a buffer.
HD_API void Set(int index, HdBufferArrayRangeSharedPtr const &range)
Set range into the container at index.
Token for efficient comparison, assignment, and hashing of known strings.
Definition: token.h:87
HdBufferArrayRangeContainer(int size)
Constructor.
virtual void CopyData(HdBufferSourceSharedPtr const &bufferSource)=0
Copy source data into buffer.
virtual void DebugDump(std::ostream &out) const =0
Debug output.
virtual void GetBufferSpecs(HdBufferSpecVector *bufferSpecs) const =0
Gets the bufferSpecs for all resources.
virtual bool Resize(int numElements)=0
Resize memory area for this range.
virtual const void * _GetAggregation() const =0
Returns the aggregation container to be used in IsAggregatedWith()
GF_API std::ostream & operator<<(std::ostream &, const GfBBox3d &)
Output a GfBBox3d using the format [(range) matrix zeroArea].
virtual HD_API ~HdBufferArrayRange()
Destructor (do nothing).
virtual HdBufferArrayUsageHint GetUsageHint() const =0
Gets the usage hint on the underlying buffer array.
virtual void IncrementVersion()=0
Increment the version of the buffer array.
HD_API HdBufferArrayRangeSharedPtr const & Get(int index) const
Returns the bar at index.
virtual size_t GetNumElements() const =0
Returns the number of elements.
virtual void SetBufferArray(HdBufferArray *bufferArray)=0
Sets the buffer array associated with this buffer;.
Provides a container which may hold any type, and provides introspection and iteration over array typ...
Definition: value.h:168
TfToken class for efficient string referencing and hashing, plus conversions to and from stl string c...
HD_API void Resize(int size)
Resize the buffer array range container to size size.