QRenderTargetSelector Class | Qt 3D 5.12.11

- Qt 5.12
- Qt 3D
- C++ Classes
- QRenderTargetSelector
- Qt 5.12.11 Reference Documentation

# QRenderTargetSelector Class

(Qt3DRender::QRenderTargetSelector)

Provides a way of specifying a render target. More...

Header: | #include <QRenderTargetSelector>
qmake: | QT += 3drender
Since: | Qt 5.7
Instantiated By: | RenderTargetSelector
Inherits: | Qt3DRender::QFrameGraphNode

- List of all members, including inherited members
- Obsolete members

## Properties

- target : Qt3DRender::QRenderTarget*

- 3 properties inherited from Qt3DCore::QNode
- 1 property inherited from QObject

## Public Functions

| QRenderTargetSelector(Qt3DCore::QNode *parent = nullptr)
QVector<QRenderTargetOutput::AttachmentPoint> | outputs() const
void | setOutputs(const QVector<QRenderTargetOutput::AttachmentPoint> &buffers)
Qt3DRender::QRenderTarget * | target() const

- 1 public function inherited from Qt3DRender::QFrameGraphNode
- 13 public functions inherited from Qt3DCore::QNode
- 31 public functions inherited from QObject

## Public Slots

void | setTarget(Qt3DRender::QRenderTarget *target)

- 3 public slots inherited from Qt3DCore::QNode
- 1 public slot inherited from QObject

## Signals

void | targetChanged(Qt3DRender::QRenderTarget *target)

- 4 signals inherited from Qt3DCore::QNode
- 2 signals inherited from QObject

## Static Public Members

const QMetaObject | staticMetaObject

- 9 static public members inherited from QObject

### Additional Inherited Members

- 1 protected function inherited from Qt3DRender::QFrameGraphNode
- 2 protected functions inherited from Qt3DCore::QNode
- 9 protected functions inherited from QObject

## Detailed Description

Provides a way of specifying a render target.

A Qt3DRender::QRenderTargetSelector is used to select active Qt3DRender::QRenderTarget for the FrameGraph. When QRenderTargetSelector is present in the FrameGraph, the rendering is directed into QTexture objects or draw buffers instead of the surface specified in the Qt3DRender::QRenderSurfaceSelector. A render buffer is automatically generated for an attachment point if drawBuffers contain attachment point that any output in the QRenderTarget do not specify. If the drawBuffers is empty, the renderer will default to using all the outputs in QRenderTarget.

## Property Documentation

### target : Qt3DRender::QRenderTarget*

Holds the current render target

Access functions:

Qt3DRender::QRenderTarget * | target() const
void | setTarget(Qt3DRender::QRenderTarget *target)

Notifier signal:

void | targetChanged(Qt3DRender::QRenderTarget *target)

## Member Function Documentation

### QRenderTargetSelector::QRenderTargetSelector(Qt3DCore::QNode *parent = nullptr)

Constructs QRenderTargetSelector with given parent.

### QVector<QRenderTargetOutput::AttachmentPoint> QRenderTargetSelector::outputs() const

Returns the list of draw buffers for the current Qt3DRender::QRenderTargetSelector instance.

See also setOutputs().

### void QRenderTargetSelector::setOutputs(const QVector<QRenderTargetOutput::AttachmentPoint> &buffers)

Sets the draw buffers to be used. The draw buffers should be matching the Qt3DRender::QRenderTargetOutput::AttachmentPoint defined in the attachments of the Qt3DRender::QRenderTarget associated to the Qt3DRender::QRenderTargetSelector instance.

Note: At render time, if no draw buffer has been specified, the renderer will default to using all the attachments' draw buffers.

See also outputs().