Qt3DRender.QRenderPass ¶

概要 ¶

详细描述 ¶

A QRenderPass specifies a single rendering pass - an instance of shader program execution - used by QTechnique . Render pass consists of a QShaderProgram and a list of QFilterKey objects, a list of QRenderState objects and a list of QParameter 对象。

QRenderPass executes the QShaderProgram using the given QRenderState and QParameter nodes when at least one of QFilterKey nodes being referenced matches any of the QFilterKey nodes in QRenderPassFilter or when no QFilterKey nodes are specified and no QRenderPassFilter is present in the FrameGraph.

若 QRenderPass defines a QParameter , it will be overridden by a QParameter with the same name if it exists in any of the QTechnique , QEffect , QMaterial , QTechniqueFilter , QRenderPassFilter associated with the pass at runtime. This still can be useful to define sane default values.

At render time, for each leaf node of the FrameGraph a base render state is recorded by accumulating states defined by all QRenderStateSet nodes in the FrameGraph branch. Each QRenderPass can overload this base render state by specifying its own QRenderState nodes.

// Create the render passes
QRenderPass *pass = new QRenderPass();
// Create shader program
QShaderProgram *glShader = new QShaderProgram();
// Set the shader on the render pass
pass->setShaderProgram(glShader);
// Create a FilterKey
QFilterKey *filterKey = new QFilterKey();
filterKey->setName(QStringLiteral("name"));
fitlerKey->setValue(QStringLiteral("zFillPass"));
// Add the FilterKey to the pass
pass->addFilterKey(filterKey);
// Create a QParameter
QParameter *colorParameter = new QParameter(QStringLiteral("color"), QColor::fromRgbF(0.0f, 0.0f, 1.0f, 1.0f));
// Add parameter to pass
pass->addParameter(colorParameter);
// Create a QRenderState
QDepthTest *depthTest = new QDepthTest();
// Add the render state to the pass
pass->addRenderState(depthTest);
											

另请参阅

QRenderPassFilter QFilterKey QParameter QRenderState QEffect QTechnique

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

param parent

QNode

构造新 QRenderPass with the specified parent .

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

参数

filterKey – QFilterKey

添加 filterKey 到 QRenderPass local filter keys.

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

参数

p – QParameter

Add 参数 to the render pass’ parameters.

PySide2.Qt3DRender.Qt3DRender.QRenderPass. addRenderState ( state ) ¶

参数

state – QRenderState

Adds a render state to the rendering pass. That implies that when the pass is executed at render time, the globally set render state will be modified by the states defined locally by the QRenderPass .

注意

not defining any QRenderState in a pass will result in the pass using the globally set render state for a given FrameGraph branch execution path.

PySide2.Qt3DRender.Qt3DRender.QRenderPass. filterKeys ( ) ¶

返回类型

Returns the list of QFilterKey key objects making up the filter keys of the QRenderPass .

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

返回类型

Returns a vector of the render pass’ current parameters

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

参数

filterKey – QFilterKey

移除 filterKey 从 QRenderPass local filter keys.

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

参数

p – QParameter

移除 参数 from the render pass’ parameters.

PySide2.Qt3DRender.Qt3DRender.QRenderPass. removeRenderState ( state ) ¶

参数

state – QRenderState

移除 state 从 QRenderPass local render state.

PySide2.Qt3DRender.Qt3DRender.QRenderPass. renderStates ( ) ¶

返回类型

Returns the list of QRenderState state objects making up the render state of the QRenderPass .

PySide2.Qt3DRender.Qt3DRender.QRenderPass. setShaderProgram ( shaderProgram ) ¶

参数

shaderProgram – QShaderProgram

另请参阅

shaderProgram()

PySide2.Qt3DRender.Qt3DRender.QRenderPass. shaderProgram ( ) ¶

返回类型

QShaderProgram

另请参阅

setShaderProgram()

PySide2.Qt3DRender.Qt3DRender.QRenderPass. shaderProgramChanged ( shaderProgram ) ¶

参数

shaderProgram – QShaderProgram