Qt 6.x
The Qt SDK
Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | Friends | List of all members
QGles2TextureRenderTarget Struct Reference

#include <qrhigles2_p.h>

+ Inheritance diagram for QGles2TextureRenderTarget:
+ Collaboration diagram for QGles2TextureRenderTarget:

Public Member Functions

 QGles2TextureRenderTarget (QRhiImplementation *rhi, const QRhiTextureRenderTargetDescription &desc, Flags flags)
 
 ~QGles2TextureRenderTarget ()
 
void destroy () override
 Releases (or requests deferred releasing of) the underlying native graphics resources.
 
QSize pixelSize () const override
 
float devicePixelRatio () const override
 
int sampleCount () const override
 
QRhiRenderPassDescriptor * newCompatibleRenderPassDescriptor () override
 
bool create () override
 Creates the corresponding native graphics resources.
 
- Public Member Functions inherited from QRhiTextureRenderTarget
QRhiResource::Type resourceType () const override
 
QRhiTextureRenderTargetDescription description () const
 
void setDescription (const QRhiTextureRenderTargetDescription &desc)
 Sets the render target description desc.
 
Flags flags () const
 
void setFlags (Flags f)
 Sets the flags to f.
 
virtual QRhiRenderPassDescriptor * newCompatibleRenderPassDescriptor ()=0
 
virtual bool create ()=0
 Creates the corresponding native graphics resources.
 
- Public Member Functions inherited from QRhiRenderTarget
virtual QSize pixelSize () const =0
 
virtual float devicePixelRatio () const =0
 
virtual int sampleCount () const =0
 
QRhiRenderPassDescriptor * renderPassDescriptor () const
 
void setRenderPassDescriptor (QRhiRenderPassDescriptor *desc)
 Sets the QRhiRenderPassDescriptor desc for use with this render target.
 
- 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
 

Public Attributes

QGles2RenderTargetData d
 
GLuint framebuffer = 0
 

Friends

class QRhiGles2
 

Additional Inherited Members

- Public Types inherited from QRhiTextureRenderTarget
enum  Flag { PreserveColorContents = 1 << 0 , PreserveDepthStencilContents = 1 << 1 }
 Flag values describing the load/store behavior for the render target. 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 QRhiTextureRenderTarget
 QRhiTextureRenderTarget (QRhiImplementation *rhi, const QRhiTextureRenderTargetDescription &desc_, Flags flags_)
 
- Protected Member Functions inherited from QRhiRenderTarget
 QRhiRenderTarget (QRhiImplementation *rhi)
 
- Protected Member Functions inherited from QRhiResource
 QRhiResource (QRhiImplementation *rhi)
 
- Protected Attributes inherited from QRhiTextureRenderTarget
QRhiTextureRenderTargetDescription m_desc
 
Flags m_flags
 
- Protected Attributes inherited from QRhiRenderTarget
QRhiRenderPassDescriptor * m_renderPassDesc = nullptr
 
- Protected Attributes inherited from QRhiResource
QRhiImplementation * m_rhi = nullptr
 
quint64 m_id
 
QByteArray m_objectName
 

Detailed Description

Definition at line 202 of file qrhigles2_p.h.

Constructor & Destructor Documentation

◆ QGles2TextureRenderTarget()

QGles2TextureRenderTarget::QGles2TextureRenderTarget ( QRhiImplementation *  rhi,
const QRhiTextureRenderTargetDescription &  desc,
Flags  flags 
)

Definition at line 5571 of file qrhigles2.cpp.

◆ ~QGles2TextureRenderTarget()

QGles2TextureRenderTarget::~QGles2TextureRenderTarget ( )

Definition at line 5579 of file qrhigles2.cpp.

References destroy().

+ Here is the call graph for this function:

Member Function Documentation

◆ create()

bool QGles2TextureRenderTarget::create ( )
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.

Note
renderPassDescriptor() must be set before calling create(). To obtain a QRhiRenderPassDescriptor compatible with the render target, call newCompatibleRenderPassDescriptor() before create() but after setting all other parameters, such as description() and flags(). To save resources, reuse the same QRhiRenderPassDescriptor with multiple QRhiTextureRenderTarget instances, whenever possible. Sharing the same render pass descriptor is only possible when the render targets have the same number and type of attachments (the actual textures can differ) and the same flags.
resources, such as QRhiTexture instances, referenced in description() must already have create() called on them.
Returns
true when successful, false when a graphics operation failed. Regardless of the return value, calling destroy() is always safe.

Implements QRhiTextureRenderTarget.

Definition at line 5611 of file qrhigles2.cpp.

References QRhiTextureRenderTargetDescription::cbeginColorAttachments(), QRhiTextureRenderTargetDescription::cendColorAttachments(), QRhiTextureRenderTargetDescription::colorAttachmentCount(), QGles2RenderTargetData::colorAttCount, QRhiTexture::CubeMap, QGles2RenderTargetData::currentResIdList, d, QRhiTextureRenderTargetDescription::depthStencilBuffer(), QRhiTextureRenderTargetDescription::depthTexture(), destroy(), QGles2RenderTargetData::dpr, QGles2RenderTargetData::dsAttCount, QRhiTexture::flags(), QRhiTexture::format(), GL_COLOR_ATTACHMENT0, GL_DEPTH_ATTACHMENT, GL_DEPTH_STENCIL_ATTACHMENT, GL_FRAMEBUFFER, GL_FRAMEBUFFER_COMPLETE, GL_RENDERBUFFER, GL_STENCIL_ATTACHMENT, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GLenum(), it, QRhiColorAttachment::layer(), QRhiColorAttachment::level(), QRhiTextureRenderTarget::m_desc, QRhiRenderTarget::m_renderPassDesc, QRhiColorAttachment::multiViewCount(), QRhiTexture::OneDimensional, QRhiTexture::pixelSize(), QRhiRenderBuffer::pixelSize(), QGles2RenderTargetData::pixelSize, Q_ASSERT, QRHI_RES, QRHI_RES_RHI, qWarning, QRhiColorAttachment::renderBuffer(), QGles2RenderBuffer::renderbuffer, QGles2RenderTargetData::rp, QGles2RenderTargetData::sampleCount, QGles2RenderBuffer::samples, QGles2Texture::specified, QGles2RenderBuffer::stencilRenderbuffer, QGles2Texture::target, QRhiColorAttachment::texture(), QGles2Texture::texture, QRhiTexture::TextureArray, and QRhiTexture::ThreeDimensional.

Referenced by QRhiGles2::beginPass(), and pixelSize().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ destroy()

void QGles2TextureRenderTarget::destroy ( )
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.

Note
Resources referenced by commands for the current frame should not be released until the frame is submitted by QRhi::endFrame().

The QRhiResource destructor also performs the same task, so calling this function is not necessary before deleting a QRhiResource.

See also
deleteLater()

Implements QRhiResource.

Definition at line 5584 of file qrhigles2.cpp.

References e, framebuffer, QRHI_RES_RHI, and QRhiGles2::DeferredReleaseEntry::TextureRenderTarget.

Referenced by ~QGles2TextureRenderTarget(), and create().

+ Here is the caller graph for this function:

◆ devicePixelRatio()

float QGles2TextureRenderTarget::devicePixelRatio ( ) const
overridevirtual
Returns
the device pixel ratio. For QRhiTextureRenderTarget this is always
  1. For targets retrieved from a QRhiSwapChain the value reflects the \l{QWindow::devicePixelRatio()}{device pixel ratio} of the targeted QWindow.

Implements QRhiRenderTarget.

Definition at line 5754 of file qrhigles2.cpp.

References d, and QGles2RenderTargetData::dpr.

◆ newCompatibleRenderPassDescriptor()

QRhiRenderPassDescriptor * QGles2TextureRenderTarget::newCompatibleRenderPassDescriptor ( )
overridevirtual
Returns
a new QRhiRenderPassDescriptor that is compatible with this render target.

The returned value is used in two ways: it can be passed to setRenderPassDescriptor() and QRhiGraphicsPipeline::setRenderPassDescriptor(). A render pass descriptor describes the attachments (color, depth/stencil) and the load/store behavior that can be affected by flags(). A QRhiGraphicsPipeline can only be used in combination with a render target that has a \l{QRhiRenderPassDescriptor::isCompatible()}{compatible} QRhiRenderPassDescriptor set.

Two QRhiTextureRenderTarget instances can share the same render pass descriptor as long as they have the same number and type of attachments. The associated QRhiTexture or QRhiRenderBuffer instances are not part of the render pass descriptor so those can differ in the two QRhiTextureRenderTarget instances.

Note
resources, such as QRhiTexture instances, referenced in description() must already have create() called on them.
See also
create()

Implements QRhiTextureRenderTarget.

Definition at line 5603 of file qrhigles2.cpp.

References QRhiResource::m_rhi, and QRHI_RES_RHI.

◆ pixelSize()

QSize QGles2TextureRenderTarget::pixelSize ( ) const
overridevirtual
Returns
the size in pixels.

Valid only after create() has been called successfully. Until then the result is a default-constructed QSize.

With QRhiTextureRenderTarget the returned size is the size of the associated attachments at the time of create(), in practice the size of the first color attachment, or the depth/stencil buffer if there are no color attachments. If the associated textures or renderbuffers are resized and rebuilt afterwards, then pixelSize() performs an implicit call to create() in order to rebuild the underlying data structures. This implicit check is similar to what QRhiCommandBuffer::beginPass() does, and ensures that the returned size is always up-to-date.

Implements QRhiRenderTarget.

Definition at line 5746 of file qrhigles2.cpp.

References create(), QGles2RenderTargetData::currentResIdList, d, QRhiTextureRenderTarget::m_desc, and QGles2RenderTargetData::pixelSize.

+ Here is the call graph for this function:

◆ sampleCount()

int QGles2TextureRenderTarget::sampleCount ( ) const
overridevirtual
Returns
the sample count or 1 if multisample antialiasing is not relevant for this render target.

Implements QRhiRenderTarget.

Definition at line 5759 of file qrhigles2.cpp.

References d, and QGles2RenderTargetData::sampleCount.

Friends And Related Symbol Documentation

◆ QRhiGles2

friend class QRhiGles2
friend

Definition at line 217 of file qrhigles2_p.h.

Member Data Documentation

◆ d

QGles2RenderTargetData QGles2TextureRenderTarget::d

Definition at line 215 of file qrhigles2_p.h.

Referenced by QRhiGles2::beginPass(), create(), devicePixelRatio(), QRhiGles2::enqueueBindFramebuffer(), pixelSize(), and sampleCount().

◆ framebuffer

GLuint QGles2TextureRenderTarget::framebuffer = 0

Definition at line 216 of file qrhigles2_p.h.

Referenced by destroy(), and QRhiGles2::enqueueBindFramebuffer().

The documentation for this struct was generated from the following files: