PvrBuffer class
#include <nCine/Graphics/RHI/PVR/PvrBuffer.h>
Host-memory buffer object of the PVR backend (aliased as RHI::Buffer).
The PVR backend consumes vertices and uniform blocks from host memory (GX draws are fed through the CPU write-gather FIFO, so there is no persistent device-side vertex store to upload into), which makes this class a plain resizable byte store exactly like the software backend's: MapBufferRange() hands back a pointer into the store, and BindBufferRange() forwards a sub-range to the device so a bound uniform block can be decoded by the draw dispatch.
Public static functions
-
static void SetBoundHandle(std::
uint32_t target, std:: uint32_t glHandle) - Records the buffer handle bound for a target (inert for the PVR backend).
-
static auto BindHandle(std::
uint32_t target, std:: uint32_t glHandle) -> bool - Marks a buffer handle as bound for a target (inert for the PVR backend).
Constructors, destructors, conversion operators
- PvrBuffer(BufferTarget target) explicit
- ~PvrBuffer() defaulted
- PvrBuffer(const PvrBuffer&) deleted
Public functions
- auto operator=(const PvrBuffer&) -> PvrBuffer& deleted
-
auto GetGLHandle() const -> std::
uint32_t - Returns a synthetic handle uniquely identifying the buffer (used by material sort keys).
- auto GetTarget() const -> BufferTarget
- Returns the binding target of the buffer.
-
auto GetSize() const -> std::
size_t - Returns the size in bytes of the data store.
-
auto HostData() -> std::
uint8_t* - Returns the base pointer of the host-side data store.
-
auto HostData() const -> const std::
uint8_t* - Returns the base pointer of the host-side data store.
- auto Bind() const -> bool
- Marks the buffer as the currently bound one for its target (always issues the "bind").
- auto Unbind() const -> bool
- Marks no buffer as bound for this object's target.
-
void BufferData(std::
size_t size, const void* data, BufferUsage usage) - (Re)creates the data store with the given size, optional initial data and usage hint
-
void BufferSubData(std::
size_t offset, std:: size_t size, const void* data) - Updates a subset of the data store starting at the given byte offset.
-
void BufferStorage(std::
size_t size, const void* data, MapFlags flags) - (Re)creates the data store like BufferData(); there is no immutable storage, so the flags are ignored
-
void BindBufferBase(std::
uint32_t index) - Binds the whole buffer to a uniform binding point index.
-
void BindBufferRange(std::
uint32_t index, std:: size_t offset, std:: size_t size) - Binds a byte range of the buffer to a uniform binding point index (forwarded to the device).
-
auto MapBufferRange(std::
size_t offset, std:: size_t length, MapFlags access) -> void* - Returns a host pointer to a byte range of the store (there is no real mapping).
-
void FlushMappedBufferRange(std::
size_t offset, std:: size_t length) - Flushes a mapped range (a no-op, the store is host memory).
- auto Unmap() -> bool
- Unmaps the buffer (a no-op, the store is host memory).
- void SetObjectLabel(StringView label)
- Sets a debug label for the buffer (ignored by the PVR backend).