本页内容

Qt3DRender::QRenderPassFilter Class

class Qt3DRender::QRenderPassFilter

用于存储过滤器键和参数的向量。更多...

头文件: #include <qrenderpassfilter.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
在 QML 中: RenderPassFilter
继承自: Qt3DRender::QFrameGraphNode
状态: 已弃用

该类已弃用。我们强烈建议不要在新代码中使用它。

公共函数

QRenderPassFilter(Qt3DCore::QNode *parent = nullptr)
void addMatch(Qt3DRender::QFilterKey *filterKey)
void addParameter(Qt3DRender::QParameter *parameter)
QList<Qt3DRender::QFilterKey *> matchAny() const
QList<Qt3DRender::QParameter *> parameters() const
void removeMatch(Qt3DRender::QFilterKey *filterKey)
void removeParameter(Qt3DRender::QParameter *parameter)

详细说明

Qt3DRender::QRenderPassFilter 的FrameGraph节点用于选择哪些Qt3DRender::QRenderPass 对象将被选中进行绘制。QRenderPassFilter指定了一个Qt3DRender::QFilterKey 对象和Qt3DRender::QParameter 对象的列表。当FrameGraph中存在QRenderPassFilter时,仅会选中那些其Qt3DRender::QFilterKey 对象与QRenderPassFilter中键值匹配的QRenderPass 对象进行渲染。 如果不存在 QRenderPassFilter,则所有QRenderPass 对象都将被选中进行渲染。列表中的参数可用于设置着色器参数的值。QRenderPassFilter 中的参数将覆盖QTechniqueFilter 、QMaterial 、QEffect 、QTechnique 和QRenderPass 中的参数。

成员函数文档

[explicit] QRenderPassFilter::QRenderPassFilter(Qt3DCore::QNode *parent = nullptr)

该构造函数会根据指定的parent 创建一个实例。

void QRenderPassFilter::addMatch(Qt3DRender::QFilterKey *filterKey)

将filterKey 添加到匹配向量中。

void QRenderPassFilter::addParameter(Qt3DRender::QParameter *parameter)

将给定的parameter 添加到参数向量中。

QList<Qt3DRender::QFilterKey *> QRenderPassFilter::matchAny() const

返回一个包含该过滤器当前键值的向量。

QList<Qt3DRender::QParameter *> QRenderPassFilter::parameters() const

返回当前的参数向量。

void QRenderPassFilter::removeMatch(Qt3DRender::QFilterKey *filterKey)

从匹配向量中移除filterKey 。

void QRenderPassFilter::removeParameter(Qt3DRender::QParameter *parameter)

从参数向量中移除给定的parameter 。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.