Qt3DRender::QSortPolicy Class

class Qt3DRender::QSortPolicy

为要使用的排序类型提供存储空间。更多

头文件: #include <QSortPolicy>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
在 QML 中: SortPolicy
继承: Qt3DRender::QFrameGraphNode
状态:已废弃

公共类型

enum SortType { StateChangeCost, BackToFront, Material, FrontToBack, Texture, Uniform }

属性

公共功能

QSortPolicy(Qt3DCore::QNode *parent = nullptr)
QList<Qt3DRender::QSortPolicy::SortType> sortTypes() const
QList<int> sortTypesInt() const

公共插槽

void setSortTypes(const QList<Qt3DRender::QSortPolicy::SortType> &sortTypes)
void setSortTypes(const QList<int> &sortTypesInt)

信号

void sortTypesChanged(const QList<Qt3DRender::QSortPolicy::SortType> &sortTypes)
void sortTypesChanged(const QList<int> &sortTypes)

详细说明

Qt3DRender::QSortPolicy 类存储 FrameGraph 使用的排序类型。排序类型决定绘制前如何对可绘制实体进行排序,以确定绘制顺序。当 FrameGraph 中存在 QSortPolicy 时,排序机制由sortTypes 列表决定。可同时使用多种排序类型。如果 FrameGraph 中不存在 QSortPolicy,则会按照实体层次结构中出现的顺序绘制实体。

成员类型文档

enum QSortPolicy::SortType

该枚举类型描述了可用的排序类型。

常量描述
Qt3DRender::QSortPolicy::StateChangeCost(1 << 0)对对象进行排序,以尽量减少从当前渲染状态进行更改的成本
Qt3DRender::QSortPolicy::BackToFront(1 << 1)根据倒置的 Z 顺序,将对象从后往前排序。更准确地说,排序键是摄像机到对象中心矢量在摄像机视图矢量上的投影的 Z 分量。
Qt3DRender::QSortPolicy::Material(1 << 2)根据材质(着色器)值对物体进行排序。
Qt3DRender::QSortPolicy::FrontToBack(1 << 3)从前到后排序对象。与 BackToFront 相反。
Qt3DRender::QSortPolicy::Texture (since Qt 5.14)(1 << 4)对物体排序,尽量减少纹理变化。
Qt3DRender::QSortPolicy::Uniform (since Qt 5.15)(1 << 5)对物体进行排序,以尽量减少均匀度变化。

属性文档

sortTypes : QList<int>

指定要使用的排序类型。

访问功能:

QList<int> sortTypesInt() const
void setSortTypes(const QList<Qt3DRender::QSortPolicy::SortType> &sortTypes)
void setSortTypes(const QList<int> &sortTypesInt)

Notifier 信号:

void sortTypesChanged(const QList<Qt3DRender::QSortPolicy::SortType> &sortTypes)
void sortTypesChanged(const QList<int> &sortTypes)

成员函数 文档

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

使用给定的parent 构建 QSortPolicy。

QList<Qt3DRender::QSortPolicy::SortType> QSortPolicy::sortTypes() const

返回当前使用的排序类型

另请参见 setSortTypes()。

© 2025 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.