 |
Qt 6.x
The Qt SDK
|
|
Qt 6.x
The Qt SDK
|
\inmodule QtGui More...
#include <qrhi.h>
Inheritance diagram for QRhiRenderPassDescriptor: Collaboration diagram for QRhiRenderPassDescriptor:Public Member Functions | |
| QRhiResource::Type | resourceType () const override |
| virtual bool | isCompatible (const QRhiRenderPassDescriptor *other) const =0 |
| virtual const QRhiNativeHandles * | nativeHandles () |
| virtual QRhiRenderPassDescriptor * | newCompatibleRenderPassDescriptor () const =0 |
| virtual QVector< quint32 > | serializedFormat () const =0 |
| Public Member Functions inherited from QRhiResource | |
| virtual | ~QRhiResource () |
| Destructor. | |
| virtual Type | resourceType () const =0 |
| virtual void | destroy ()=0 |
| Releases (or requests deferred releasing of) the underlying native graphics resources. | |
| 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 |
Protected Member Functions | |
| QRhiRenderPassDescriptor (QRhiImplementation *rhi) | |
| Protected Member Functions inherited from QRhiResource | |
| QRhiResource (QRhiImplementation *rhi) | |
Additional Inherited Members | |
| 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 Attributes inherited from QRhiResource | |
| QRhiImplementation * | m_rhi = nullptr |
| quint64 | m_id |
| QByteArray | m_objectName |
\inmodule QtGui
Render pass resource.
A render pass, if such a concept exists in the underlying graphics API, is a collection of attachments (color, depth, stencil) and describes how those attachments are used.
|
protected |
|
pure virtual |
this and other can be used interchangebly in QRhiGraphicsPipeline::setRenderPassDescriptor().The concept of the compatibility of renderpass descriptors is similar to the \l{QRhiShaderResourceBindings::isLayoutCompatible}{layout compatibility} of QRhiShaderResourceBindings instances. They allow better reuse of QRhiGraphicsPipeline instances: for example, a QRhiGraphicsPipeline instance cache is expected to use these functions to look for a matching pipeline, instead of just comparing pointers, thus allowing a different QRhiRenderPassDescriptor and QRhiShaderResourceBindings to be used in combination with the pipeline, as long as they are compatible.
The exact details of compatibility depend on the underlying graphics API. Two renderpass descriptors \l{QRhiTextureRenderTarget::newCompatibleRenderPassDescriptor()}{created} from the same QRhiTextureRenderTarget are always compatible.
Similarly to QRhiShaderResourceBindings, compatibility can also be tested without having two existing objects available. Extracting the opaque blob by calling serializedFormat() allows testing for compatibility by comparing the returned vector to another QRhiRenderPassDescriptor's serializedFormat(). This has benefits in certain situations, because it allows testing the compatibility of a QRhiRenderPassDescriptor with a QRhiGraphicsPipeline even when the QRhiRenderPassDescriptor the pipeline was originally built was is no longer available (but the data returned from its serializedFormat() still is).
Implemented in QD3D11RenderPassDescriptor, QGles2RenderPassDescriptor, QMetalRenderPassDescriptor, QNullRenderPassDescriptor, and QVkRenderPassDescriptor.
|
virtual |
Reimplemented in QVkRenderPassDescriptor.
Definition at line 4745 of file qrhi.cpp.
Referenced by QSGRhiSupport::rifResource().
Here is the caller graph for this function:
|
pure virtual |
This function allows cloning a QRhiRenderPassDescriptor. The returned object is ready to be used, and the ownership is transferred to the caller. Cloning a QRhiRenderPassDescriptor object can become useful in situations where the object is stored in data structures related to graphics pipelines (in order to allow creating new pipelines which in turn requires a renderpass descriptor object), and the lifetime of the renderpass descriptor created from a render target may be shorter than the pipelines. (for example, because the engine manages and destroys renderpasses together with the textures and render targets it was created from) In such a situation, it can be beneficial to store a cloned version in the data structures, and thus transferring ownership as well.
Implemented in QD3D11RenderPassDescriptor, QGles2RenderPassDescriptor, QMetalRenderPassDescriptor, QNullRenderPassDescriptor, and QVkRenderPassDescriptor.
Referenced by QSSGRenderReflectionMap::addReflectionMapEntry(), and renderToKTXFileInternal().
Here is the caller graph for this function:
|
overridevirtual |
Implements QRhiResource.
Definition at line 4659 of file qrhi.cpp.
References QRhiResource::RenderPassDescriptor.
Given two QRhiRenderPassDescriptor objects rp1 and rp2, if the data returned from this function is identical, then {rp1->isCompatible(rp2)}, and vice versa hold true as well.
Implemented in QD3D11RenderPassDescriptor, QGles2RenderPassDescriptor, QMetalRenderPassDescriptor, QNullRenderPassDescriptor, and QVkRenderPassDescriptor.
Referenced by QSGBatchRenderer::GraphicsPipelineStateKey::create(), and QSSGGraphicsPipelineStateKey::create().
Here is the caller graph for this function:
1.9.7