| /**************************************************************************** |
| ** |
| ** Copyright (C) 2014 Klaralvdalens Datakonsult AB (KDAB). |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the Qt3D module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #include "qrendertargetselector.h" |
| #include "qrendertargetselector_p.h" |
| #include <Qt3DRender/qrendertarget.h> |
| #include <Qt3DRender/private/qrenderpass_p.h> |
| #include <Qt3DRender/qframegraphnodecreatedchange.h> |
| |
| QT_BEGIN_NAMESPACE |
| |
| using namespace Qt3DCore; |
| |
| namespace Qt3DRender { |
| /*! |
| \class Qt3DRender::QRenderTargetSelector |
| \inmodule Qt3DRender |
| \since 5.7 |
| \brief 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. |
| */ |
| |
| /*! |
| \qmltype RenderTargetSelector |
| \inqmlmodule Qt3D.Render |
| \since 5.7 |
| \instantiates Qt3DRender::QRenderTargetSelector |
| \inherits FrameGraphNode |
| \brief Provides a way of specifying a render target. |
| |
| A RenderTargetSelector is used to select active RenderTarget |
| for the FrameGraph. When RenderTargetSelector is present in the FrameGraph, |
| the rendering is directed into Texture objects or draw buffers instead of the surface |
| specified in the RenderSurfaceSelector. |
| */ |
| /*! |
| \qmlproperty list<variant> RenderTargetSelector::drawBuffers |
| Holds the list of draw buffers enabled for the RenderTarget. |
| |
| \sa Qt3DRender::QRenderTargetOutput::AttachmentPoint |
| */ |
| |
| QRenderTargetSelectorPrivate::QRenderTargetSelectorPrivate() |
| : QFrameGraphNodePrivate() |
| , m_target(nullptr) |
| { |
| } |
| |
| /*! |
| Constructs QRenderTargetSelector with given \a parent. |
| */ |
| QRenderTargetSelector::QRenderTargetSelector(QNode *parent) |
| : QFrameGraphNode(*new QRenderTargetSelectorPrivate, parent) |
| { |
| } |
| |
| /*! \internal */ |
| QRenderTargetSelector::~QRenderTargetSelector() |
| { |
| } |
| |
| /*! |
| \property QRenderTargetSelector::target |
| Holds the current render target |
| */ |
| |
| /*! \qmlproperty RenderTarget Qt3D.Render::RenderTargetSelector::target |
| |
| Holds the current render target |
| */ |
| void QRenderTargetSelector::setTarget(QRenderTarget *target) |
| { |
| Q_D(QRenderTargetSelector); |
| if (d->m_target != target) { |
| |
| if (d->m_target) |
| d->unregisterDestructionHelper(d->m_target); |
| |
| // For inline declaration cases |
| if (target != nullptr && !target->parent()) |
| target->setParent(this); |
| |
| d->m_target = target; |
| |
| if (d->m_target) |
| d->registerDestructionHelper(d->m_target, &QRenderTargetSelector::setTarget, d->m_target); |
| |
| emit targetChanged(target); |
| } |
| } |
| |
| QRenderTarget *QRenderTargetSelector::target() const |
| { |
| Q_D(const QRenderTargetSelector); |
| return d->m_target; |
| } |
| |
| /*! |
| Sets the draw \a 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. |
| */ |
| void QRenderTargetSelector::setOutputs(const QVector<QRenderTargetOutput::AttachmentPoint> &buffers) |
| { |
| Q_D(QRenderTargetSelector); |
| if (buffers != d->m_outputs) { |
| d->m_outputs = buffers; |
| d->update(); |
| } |
| } |
| |
| /*! |
| \return the list of draw buffers for the current Qt3DRender::QRenderTargetSelector instance. |
| */ |
| QVector<QRenderTargetOutput::AttachmentPoint> QRenderTargetSelector::outputs() const |
| { |
| Q_D(const QRenderTargetSelector); |
| return d->m_outputs; |
| } |
| |
| /*! \internal */ |
| QRenderTargetSelector::QRenderTargetSelector(QRenderTargetSelectorPrivate &dd, QNode *parent) |
| : QFrameGraphNode(dd, parent) |
| { |
| } |
| |
| Qt3DCore::QNodeCreatedChangeBasePtr QRenderTargetSelector::createNodeCreationChange() const |
| { |
| auto creationChange = QFrameGraphNodeCreatedChangePtr<QRenderTargetSelectorData>::create(this); |
| auto &data = creationChange->data; |
| Q_D(const QRenderTargetSelector); |
| data.targetId = qIdForNode(d->m_target); |
| data.outputs = d->m_outputs; |
| return creationChange; |
| } |
| |
| } // namespace Qt3DRender |
| |
| QT_END_NAMESPACE |