QRenderTargetOutput Class

class Qt3DRender::QRenderTargetOutput

The QRenderTargetOutput class allows the specification of an attachment of a render target (whether it is a color texture, a depth texture, etc... ). More...

Header: #include <QRenderTargetOutput>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
Instantiated By: RenderTargetOutput
Inherits: Qt3DCore::QNode

Public Types

enum AttachmentPoint { Color0, Color1, Color2, Color3, Color4, …, Right }

Properties

Public Functions

QRenderTargetOutput(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint() const
Qt3DRender::QAbstractTexture::CubeMapFace face() const
int layer() const
int mipLevel() const
Qt3DRender::QAbstractTexture *texture() const

Public Slots

void setAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint)
void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)
void setLayer(int layer)
void setMipLevel(int level)
void setTexture(Qt3DRender::QAbstractTexture *texture)

Signals

void attachmentPointChanged(Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint)
void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)
void layerChanged(int layer)
void mipLevelChanged(int mipLevel)
void textureChanged(Qt3DRender::QAbstractTexture *texture)

Detailed Description

A QRenderTargetOutput specifies the attachment point and parameters for texture that is attached to render target. In addition to the attachment point, texture miplevel, layer and cubemap face can be specified. The texture attached to the QRenderTargetOutput must be compatible with the given parameters.

Note: Left and Right attachment points are special values. They do not refer to render target objects to be either of the back buffers used for stereo rendering.

Member Type Documentation

enum QRenderTargetOutput::AttachmentPoint

This enumeration specifies the values for the attachment point.

ConstantValueDescription
Qt3DRender::QRenderTargetOutput::Color00Color attachment point at index 0
Qt3DRender::QRenderTargetOutput::Color11Color attachment point at index 1
Qt3DRender::QRenderTargetOutput::Color22Color attachment point at index 2
Qt3DRender::QRenderTargetOutput::Color33Color attachment point at index 3
Qt3DRender::QRenderTargetOutput::Color44Color attachment point at index 4
Qt3DRender::QRenderTargetOutput::Color55Color attachment point at index 5
Qt3DRender::QRenderTargetOutput::Color66Color attachment point at index 6
Qt3DRender::QRenderTargetOutput::Color77Color attachment point at index 7
Qt3DRender::QRenderTargetOutput::Color88Color attachment point at index 8
Qt3DRender::QRenderTargetOutput::Color99Color attachment point at index 9
Qt3DRender::QRenderTargetOutput::Color1010Color attachment point at index 10
Qt3DRender::QRenderTargetOutput::Color1111Color attachment point at index 11
Qt3DRender::QRenderTargetOutput::Color1212Color attachment point at index 12
Qt3DRender::QRenderTargetOutput::Color1313Color attachment point at index 13
Qt3DRender::QRenderTargetOutput::Color1414Color attachment point at index 14
Qt3DRender::QRenderTargetOutput::Color1515Color attachment point at index 15
Qt3DRender::QRenderTargetOutput::Depth16Depth attachment point
Qt3DRender::QRenderTargetOutput::Stencil17Stencil attachment point
Qt3DRender::QRenderTargetOutput::DepthStencil18DepthStencil attachment point
Qt3DRender::QRenderTargetOutput::Left19Back Left Draw Buffer
Qt3DRender::QRenderTargetOutput::Right20Back Right Draw Buffer

Property Documentation

attachmentPoint : AttachmentPoint

Holds the attachment point of the QRenderTargetOutput.

Access functions:

Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint() const
void setAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint)

Notifier signal:

void attachmentPointChanged(Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint)

face : Qt3DRender::QAbstractTexture::CubeMapFace

Holds the face of the attached cubemap texture the rendering is directed to.

Access functions:

Qt3DRender::QAbstractTexture::CubeMapFace face() const
void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)

Notifier signal:

void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)

layer : int

Holds the layer of the attached texture the rendering is directed to.

Access functions:

int layer() const
void setLayer(int layer)

Notifier signal:

void layerChanged(int layer)

mipLevel : int

Holds the miplevel of the attached texture the rendering is directed to.

Access functions:

int mipLevel() const
void setMipLevel(int level)

Notifier signal:

void mipLevelChanged(int mipLevel)

texture : QAbstractTexture*

Holds the texture attached to the attachment point.

Access functions:

Qt3DRender::QAbstractTexture *texture() const
void setTexture(Qt3DRender::QAbstractTexture *texture)

Notifier signal:

void textureChanged(Qt3DRender::QAbstractTexture *texture)

Member Function Documentation

[explicit] QRenderTargetOutput::QRenderTargetOutput(Qt3DCore::QNode *parent = nullptr)

The constructor creates a new QRenderTargetOutput::QRenderTargetOutput instance with the specified parent.