QTechnique Class
(Qt3DRender::QTechnique)Encapsulates a Technique. More...
Header: | #include <QTechnique> |
qmake: | QT += 3drender |
Since: | Qt 5.7 |
Instantiated By: | Technique |
Inherits: | Qt3DCore::QNode |
Properties
- graphicsApiFilter : Qt3DRender::QGraphicsApiFilter * const
- 3 properties inherited from Qt3DCore::QNode
- 1 property inherited from QObject
Public Functions
QTechnique(Qt3DCore::QNode *parent = nullptr) | |
void | addFilterKey(QFilterKey *filterKey) |
void | addParameter(QParameter *parameter) |
void | addRenderPass(QRenderPass *pass) |
QVector<QFilterKey *> | filterKeys() const |
QGraphicsApiFilter * | graphicsApiFilter() |
QVector<QParameter *> | parameters() const |
void | removeFilterKey(QFilterKey *filterKey) |
void | removeParameter(QParameter *parameter) |
void | removeRenderPass(QRenderPass *pass) |
QVector<QRenderPass *> | renderPasses() const |
- 11 public functions inherited from Qt3DCore::QNode
- 32 public functions inherited from QObject
Protected Functions
QTechnique(QTechniquePrivate &dd, Qt3DCore::QNode *parent = nullptr) |
- 2 protected functions inherited from Qt3DCore::QNode
- 9 protected functions inherited from QObject
Additional Inherited Members
- 3 public slots inherited from Qt3DCore::QNode
- 1 public slot inherited from QObject
- 4 signals inherited from Qt3DCore::QNode
- 2 signals inherited from QObject
- 11 static public members inherited from QObject
Detailed Description
Encapsulates a Technique.
A Qt3DRender::QTechnique specifies a set of Qt3DRender::QRenderPass objects, Qt3DRender::QFilterKey objects, Qt3DRender::QParameter objects and a Qt3DRender::QGraphicsApiFilter, which together define a rendering technique the given graphics API can render. The filter keys are used by Qt3DRender::QTechniqueFilter to select specific techniques at specific parts of the FrameGraph. If two QParameter instances with the same name are specified in a QTechnique and a QRenderPass, the one in Technique overrides the one used in the QRenderPass.
When creating an QEffect that targets several versions of a graphics API, it is useful to create several QTechnique nodes each with a graphicsApiFilter set to match one of the targeted GL versions. At runtime, the Qt3D renderer will select the most appropriate QTechnique based on which graphics API versions are supported and (if specified) the QFilterKey nodes that satisfy a given QTechniqueFilter in the FrameGraph.
Note: When using OpenGL as the graphics API for rendering, Qt3D relies on the QSurfaceFormat returned by QSurfaceFormat::defaultFormat() at runtime to decide what is the most appropriate GL version available. If you need to customize the QSurfaceFormat, do not forget to apply it with QSurfaceFormat::setDefaultFormat(). Setting the QSurfaceFormat on the view will likely have no effect on Qt3D related rendering.
QTechnique *gl3Technique = new QTechnique(); // Create the render passes QRenderPass *firstPass = new QRenderPass(); QRenderPass *secondPass = new QRenderPass(); // Add the passes to the technique gl3Technique->addRenderPass(firstPass); gl3Technique->addRenderPass(secondPass); // Set the targeted GL version for the technique gl3Technique->graphicsApiFilter()->setApi(QGraphicsApiFilter::OpenGL); gl3Technique->graphicsApiFilter()->setMajorVersion(3); gl3Technique->graphicsApiFilter()->setMinorVersion(1); gl3Technique->graphicsApiFilter()->setProfile(QGraphicsApiFilter::CoreProfile); // Create a FilterKey QFilterKey *filterKey = new QFilterKey(); filterKey->setName(QStringLiteral("name")); fitlerKey->setValue(QStringLiteral("zFillPass")); // Add the FilterKey to the Technique gl3Technique->addFilterKey(filterKey); // Create a QParameter QParameter *colorParameter = new QParameter(QStringLiteral("color"), QColor::fromRgbF(0.0f, 0.0f, 1.0f, 1.0f)); // Add parameter to technique gl3Technique->addParameter(colorParameter);
See also QEffect, QRenderPass, and QTechniqueFilter.
Property Documentation
graphicsApiFilter : Qt3DRender::QGraphicsApiFilter * const
Specifies the graphics API filter being used
Access functions:
QGraphicsApiFilter * | graphicsApiFilter() |
Member Function Documentation
QTechnique::QTechnique(Qt3DCore::QNode *parent = nullptr)
Default constructs an instance of QTechnique.
[protected]
QTechnique::QTechnique(QTechniquePrivate &dd, Qt3DCore::QNode *parent = nullptr)
Copy constructor.
void QTechnique::addFilterKey(QFilterKey *filterKey)
Add filterKey to the Qt3DRender::QTechnique local filter keys.
void QTechnique::addParameter(QParameter *parameter)
Add parameter to the technique's parameters.
void QTechnique::addRenderPass(QRenderPass *pass)
Appends a pass to the technique.
QVector<QFilterKey *> QTechnique::filterKeys() const
Returns the list of Qt3DCore::QFilterKey key objects making up the filter keys of the Qt3DRender::QTechnique.
QVector<QParameter *> QTechnique::parameters() const
Returns a vector of the techniques current parameters
void QTechnique::removeFilterKey(QFilterKey *filterKey)
Removes filterKey from the Qt3DRender::QTechnique local filter keys.
void QTechnique::removeParameter(QParameter *parameter)
Remove parameter from the technique's parameters.
void QTechnique::removeRenderPass(QRenderPass *pass)
Removes a pass from the technique.
QVector<QRenderPass *> QTechnique::renderPasses() const
Returns the list of render passes contained in the technique.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qt3drender-qtechnique.html