Qt
Internal/Contributor docs for the Qt SDK. <b>Note:</b> These are NOT official API docs; those are found <a href='https://doc.qt.io/'>here</a>.
|
#include <qrhid3d11_p.h>
Public Member Functions | |
QD3D11Buffer (QRhiImplementation *rhi, Type type, UsageFlags usage, quint32 size) | |
~QD3D11Buffer () | |
void | destroy () override |
Releases (or requests deferred releasing of) the underlying native graphics resources. | |
bool | create () override |
Creates the corresponding native graphics resources. | |
QRhiBuffer::NativeBuffer | nativeBuffer () override |
char * | beginFullDynamicBufferUpdateForCurrentFrame () override |
void | endFullDynamicBufferUpdateForCurrentFrame () override |
To be called when the entire contents of the buffer data has been updated in the memory block returned from beginFullDynamicBufferUpdateForCurrentFrame(). | |
ID3D11UnorderedAccessView * | unorderedAccessView (quint32 offset) |
Public Member Functions inherited from QRhiBuffer | |
QRhiResource::Type | resourceType () const override |
Type | type () const |
void | setType (Type t) |
Sets the buffer's type to t. | |
UsageFlags | usage () const |
void | setUsage (UsageFlags u) |
Sets the buffer's usage flags to u. | |
quint32 | size () const |
void | setSize (quint32 sz) |
Sets the size of the buffer in bytes. | |
Public Member Functions inherited from QRhiResource | |
virtual | ~QRhiResource () |
Destructor. | |
void | deleteLater () |
When called without a frame being recorded, this function is equivalent to deleting the object. | |
QByteArray | name () const |
void | setName (const QByteArray &name) |
Sets a name for the object. | |
quint64 | globalResourceId () const |
QRhi * | rhi () const |
Public Attributes | |
ID3D11Buffer * | buffer = nullptr |
char * | dynBuf = nullptr |
bool | hasPendingDynamicUpdates = false |
QHash< quint32, ID3D11UnorderedAccessView * > | uavs |
uint | generation = 0 |
Friends | |
class | QRhiD3D11 |
Additional Inherited Members | |
Public Types inherited from QRhiBuffer | |
enum | Type { Immutable , Static , Dynamic } |
Specifies storage type of buffer resource. More... | |
enum | UsageFlag { VertexBuffer = 1 << 0 , IndexBuffer = 1 << 1 , UniformBuffer = 1 << 2 , StorageBuffer = 1 << 3 } |
Flag values to specify how the buffer is going to be used. More... | |
Public Types inherited from QRhiResource | |
enum | Type { Buffer , Texture , Sampler , RenderBuffer , RenderPassDescriptor , SwapChainRenderTarget , TextureRenderTarget , ShaderResourceBindings , GraphicsPipeline , SwapChain , ComputePipeline , CommandBuffer } |
Specifies type of the resource. More... | |
Protected Member Functions inherited from QRhiBuffer | |
QRhiBuffer (QRhiImplementation *rhi, Type type_, UsageFlags usage_, quint32 size_) | |
\variable QRhiBuffer::NativeBuffer::objects | |
Protected Member Functions inherited from QRhiResource | |
QRhiResource (QRhiImplementation *rhi) | |
Protected Attributes inherited from QRhiBuffer | |
Type | m_type |
UsageFlags | m_usage |
quint32 | m_size |
Protected Attributes inherited from QRhiResource | |
QRhiImplementation * | m_rhi = nullptr |
quint64 | m_id |
QByteArray | m_objectName |
Definition at line 30 of file qrhid3d11_p.h.
QD3D11Buffer::QD3D11Buffer | ( | QRhiImplementation * | rhi, |
Type | type, | ||
UsageFlags | usage, | ||
quint32 | size ) |
Definition at line 2932 of file qrhid3d11.cpp.
QD3D11Buffer::~QD3D11Buffer | ( | ) |
Definition at line 2937 of file qrhid3d11.cpp.
References destroy().
|
overridevirtual |
This is a shortcut for medium-to-large dynamic uniform buffers that have their entire contents (or at least all regions that are read by the shaders in the current frame) changed {in every frame} and the QRhiResourceUpdateBatch-based update mechanism is seen too heavy due to the amount of data copying involved.
The call to this function must be eventually followed by a call to endFullDynamicUniformBufferUpdateForCurrentFrame(), before recording any render or compute pass that relies on this buffer.
Reimplemented from QRhiBuffer.
Definition at line 3031 of file qrhid3d11.cpp.
References QRhiBuffer::Dynamic, QRhiBuffer::m_type, Q_ASSERT, qPrintable, QRHI_RES_RHI, and qWarning.
|
overridevirtual |
Creates the corresponding native graphics resources.
If there are already resources present due to an earlier create() with no corresponding destroy(), then destroy() is called implicitly first.
true
when successful, false
when a graphics operation failed. Regardless of the return value, calling destroy() is always safe. Implements QRhiBuffer.
Definition at line 2976 of file qrhid3d11.cpp.
References aligned(), QByteArray::constData(), destroy(), QRhiBuffer::Dynamic, dynBuf, generation, hasPendingDynamicUpdates, QByteArray::isEmpty(), QRhiResource::m_objectName, QRhiBuffer::m_size, QRhiBuffer::m_type, QRhiBuffer::m_usage, qPrintable, QRHI_RES_RHI, qWarning, QByteArray::size(), QRhiBuffer::StorageBuffer, toD3DBufferUsage(), and QRhiBuffer::UniformBuffer.
|
overridevirtual |
Releases (or requests deferred releasing of) the underlying native graphics resources.
Safe to call multiple times, subsequent invocations will be a no-op then.
Once destroy() is called, the QRhiResource instance can be reused, by calling create()
again. That will then result in creating new native graphics resources underneath.
The QRhiResource destructor also performs the same task, so calling this function is not necessary before deleting a QRhiResource.
Implements QRhiResource.
Definition at line 2942 of file qrhid3d11.cpp.
References QHash< Key, T >::begin(), QHash< Key, T >::clear(), dynBuf, QHash< Key, T >::end(), it, QRHI_RES_RHI, and uavs.
Referenced by ~QD3D11Buffer(), and create().
|
overridevirtual |
To be called when the entire contents of the buffer data has been updated in the memory block returned from beginFullDynamicBufferUpdateForCurrentFrame().
Reimplemented from QRhiBuffer.
Definition at line 3051 of file qrhid3d11.cpp.
References QRHI_RES_RHI.
|
overridevirtual |
A QRhiBuffer may be backed by multiple native buffer objects, depending on the type() and the QRhi backend in use. When this is the case, all of them are returned in the objects array in the returned struct, with slotCount specifying the number of native buffer objects. While \l{QRhi::beginFrame()}{recording a frame}, QRhi::currentFrameSlot() can be used to determine which of the native buffers QRhi is using for operations that read or write from this QRhiBuffer within the frame being recorded.
In some cases a QRhiBuffer will not be backed by a native buffer object at all. In this case slotCount will be set to 0 and no valid native objects are returned. This is not an error, and is perfectly valid when a given backend does not use native buffers for QRhiBuffers with certain types or usages.
Reimplemented from QRhiBuffer.
Definition at line 3022 of file qrhid3d11.cpp.
References QRhiBuffer::Dynamic, QRhiBuffer::m_type, and QRHI_RES_RHI.
ID3D11UnorderedAccessView * QD3D11Buffer::unorderedAccessView | ( | quint32 | offset | ) |
Definition at line 3057 of file qrhid3d11.cpp.
References aligned(), QHash< Key, T >::end(), QHash< Key, T >::find(), it, QRhiBuffer::m_size, qPrintable, QRHI_RES_RHI, qWarning, and uavs.
|
friend |
Definition at line 47 of file qrhid3d11_p.h.
ID3D11Buffer* QD3D11Buffer::buffer = nullptr |
Definition at line 42 of file qrhid3d11_p.h.
char* QD3D11Buffer::dynBuf = nullptr |
Definition at line 43 of file qrhid3d11_p.h.
uint QD3D11Buffer::generation = 0 |
Definition at line 46 of file qrhid3d11_p.h.
Referenced by create().
bool QD3D11Buffer::hasPendingDynamicUpdates = false |
Definition at line 44 of file qrhid3d11_p.h.
Referenced by create().
Definition at line 45 of file qrhid3d11_p.h.
Referenced by destroy(), and unorderedAccessView().