Qt3DRender.QTechnique ¶

概要 ¶

详细描述 ¶

A QTechnique 指定一组 QRenderPass 对象， QFilterKey 对象， QParameter 对象和 QGraphicsApiFilter , which together define a rendering technique the given graphics API can render. The filter keys are used by QTechniqueFilter to select specific techniques at specific parts of the FrameGraph. If two QParameter instances with the same name are specified in a QTechnique 和 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.

注意

When using OpenGL as the graphics API for rendering, Qt3D relies on the QSurfaceFormat returned by 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 setDefaultFormat() . Setting the QSurfaceFormat on the view will likely have no effect on Qt3D related rendering.

注意

QTechnique node can not be disabled.

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);
											

另请参阅

QEffect QRenderPass QTechniqueFilter

class PySide2.Qt3DRender.Qt3DRender. QTechnique ( [ parent=None ] ) ¶

参数

parent – QNode

PySide2.Qt3DRender.Qt3DRender.QTechnique. addFilterKey ( filterKey ) ¶

参数

filterKey – QFilterKey

Add filterKey 到 QTechnique local filter keys.

PySide2.Qt3DRender.Qt3DRender.QTechnique. addParameter ( p ) ¶

参数

p – QParameter

Add 参数 to the technique’s parameters.

PySide2.Qt3DRender.Qt3DRender.QTechnique. addRenderPass ( pass ) ¶

参数

pass – QRenderPass

Appends a pass to the technique.

PySide2.Qt3DRender.Qt3DRender.QTechnique. filterKeys ( ) ¶

返回类型

Returns the list of Qt3DCore::QFilterKey key objects making up the filter keys of the QTechnique .

PySide2.Qt3DRender.Qt3DRender.QTechnique. graphicsApiFilter ( ) ¶

返回类型

QGraphicsApiFilter

PySide2.Qt3DRender.Qt3DRender.QTechnique. 参数 ( ) ¶

返回类型

Returns a vector of the techniques current parameters

PySide2.Qt3DRender.Qt3DRender.QTechnique. removeFilterKey ( filterKey ) ¶

参数

filterKey – QFilterKey

移除 filterKey 从 QTechnique local filter keys.

PySide2.Qt3DRender.Qt3DRender.QTechnique. removeParameter ( p ) ¶

参数

p – QParameter

移除 参数 from the technique’s parameters.

PySide2.Qt3DRender.Qt3DRender.QTechnique. removeRenderPass ( pass ) ¶

参数

pass – QRenderPass

Removes a pass from the technique.

PySide2.Qt3DRender.Qt3DRender.QTechnique. renderPasses ( ) ¶

返回类型

Returns the list of render passes contained in the technique.