Loading...
Searching...
No Matches
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
36PXR_NAMESPACE_OPEN_SCOPE
37
38
39using HdBufferSpecVector = std::vector<struct HdBufferSpec>;
40using HdBufferArrayRangeSharedPtr = std::shared_ptr<class HdBufferArrayRange>;
41using HdBufferSourceSharedPtr = std::shared_ptr<class HdBufferSource>;
42
52{
53public:
54
55 HD_API
57
63 HD_API
65
67 virtual bool IsValid() const = 0;
68
70 virtual bool IsAssigned() const = 0;
71
73 virtual bool IsImmutable() const = 0;
74
76 virtual bool RequiresStaging() const = 0;
77
80 virtual bool Resize(int numElements) = 0;
81
83 virtual void CopyData(HdBufferSourceSharedPtr const &bufferSource) = 0;
84
86 virtual VtValue ReadData(TfToken const &name) const = 0;
87
90 virtual int GetElementOffset() const = 0;
91
94 virtual int GetByteOffset(TfToken const& resourceName) const = 0;
95
97 virtual size_t GetNumElements() const = 0;
98
100 virtual size_t GetVersion() const = 0;
101
104 virtual void IncrementVersion() = 0;
105
107 virtual size_t GetMaxNumElements() const = 0;
108
110 virtual HdBufferArrayUsageHint GetUsageHint() const = 0;
111
113 virtual void SetBufferArray(HdBufferArray *bufferArray) = 0;
114
116 virtual void DebugDump(std::ostream &out) const = 0;
117
119 bool IsAggregatedWith(HdBufferArrayRangeSharedPtr const &other) const {
120 return (other && (_GetAggregation() == other->_GetAggregation()));
121 }
122
124 virtual void GetBufferSpecs(HdBufferSpecVector *bufferSpecs) const = 0;
125
126protected:
128 virtual const void *_GetAggregation() const = 0;
129
130 // Don't allow copies
131 HdBufferArrayRange(const HdBufferArrayRange &) = delete;
132 HdBufferArrayRange &operator=(const HdBufferArrayRange &) = delete;
133
134};
135
136HD_API
137std::ostream &operator <<(std::ostream &out,
138 const HdBufferArrayRange &self);
139
145{
146public:
148 HdBufferArrayRangeContainer(int size) : _ranges(size) { }
149
152 HD_API
153 void Set(int index, HdBufferArrayRangeSharedPtr const &range);
154
157 HD_API
158 HdBufferArrayRangeSharedPtr const &Get(int index) const;
159
162 HD_API
163 void Resize(int size);
164
165private:
166 std::vector<HdBufferArrayRangeSharedPtr> _ranges;
167};
168
169
170PXR_NAMESPACE_CLOSE_SCOPE
171
172#endif // PXR_IMAGING_HD_BUFFER_ARRAY_RANGE_H
Similar to a VAO, this object is a bundle of coherent buffers.
Definition: bufferArray.h:86
A resizable container of HdBufferArrayRanges.
HD_API void Set(int index, HdBufferArrayRangeSharedPtr const &range)
Set range into the container at index.
HdBufferArrayRangeContainer(int size)
Constructor.
HD_API void Resize(int size)
Resize the buffer array range container to size size.
HD_API HdBufferArrayRangeSharedPtr const & Get(int index) const
Returns the bar at index.
Interface class for representing range (subset) locator of HdBufferArray.
virtual bool IsAssigned() const =0
Returns true is the range has been assigned to a buffer.
virtual const void * _GetAggregation() const =0
Returns the aggregation container to be used in IsAggregatedWith()
virtual int GetElementOffset() const =0
Returns the offset at which this range begins in the underlying buffer array in terms of elements.
virtual void DebugDump(std::ostream &out) const =0
Debug output.
virtual size_t GetNumElements() const =0
Returns the number of elements.
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 VtValue ReadData(TfToken const &name) const =0
Read back the buffer content.
virtual HD_API ~HdBufferArrayRange()
Destructor (do nothing).
virtual bool RequiresStaging() const =0
Returns true if this needs a staging buffer for CPU to GPU copies.
bool IsAggregatedWith(HdBufferArrayRangeSharedPtr const &other) const
Returns true if the underlying buffer array is aggregated to other's.
virtual HdBufferArrayUsageHint GetUsageHint() const =0
Gets the usage hint on the underlying buffer array.
virtual size_t GetMaxNumElements() const =0
Returns the max number of elements.
virtual bool IsImmutable() const =0
Returns true if this range is marked as immutable.
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 void IncrementVersion()=0
Increment the version of the buffer array.
virtual void SetBufferArray(HdBufferArray *bufferArray)=0
Sets the buffer array associated with this buffer;.
virtual void CopyData(HdBufferSourceSharedPtr const &bufferSource)=0
Copy source data into buffer.
virtual bool IsValid() const =0
Returns true if this range is valid.
virtual size_t GetVersion() const =0
Returns the version of the buffer array.
Token for efficient comparison, assignment, and hashing of known strings.
Definition: token.h:88
Provides a container which may hold any type, and provides introspection and iteration over array typ...
Definition: value.h:164
TfToken class for efficient string referencing and hashing, plus conversions to and from stl string c...