QSortPolicy Class
(Qt3DRender::QSortPolicy)Provides storage for the sort types to be used. More...
| Header: | #include <QSortPolicy> |
| qmake: | QT += 3drender |
| Since: | Qt 5.7 |
| Instantiated By: | SortPolicy |
| Inherits: | Qt3DRender::QFrameGraphNode |
This class was introduced in Qt 5.7.
Public Types
| enum | SortType { StateChangeCost, BackToFront, Material, FrontToBack, Texture } |
Properties
- sortTypes : QVector<int>
Public Functions
| QSortPolicy(Qt3DCore::QNode *parent = nullptr) | |
| QVector<Qt3DRender::QSortPolicy::SortType> | sortTypes() const |
| QVector<int> | sortTypesInt() const |
Public Slots
| void | setSortTypes(const QVector<int> &sortTypesInt) |
| void | setSortTypes(const QVector<Qt3DRender::QSortPolicy::SortType> &sortTypes) |
Signals
| void | sortTypesChanged(const QVector<int> &sortTypes) |
| void | sortTypesChanged(const QVector<Qt3DRender::QSortPolicy::SortType> &sortTypes) |
Detailed Description
A Qt3DRender::QSortPolicy class stores the sorting type used by the FrameGraph. The sort types determine how drawable entities are sorted before drawing to determine the drawing order. When QSortPolicy is present in the FrameGraph, the sorting mechanism is determined by the sortTypes list. Multiple sort types can be used simultaneously. If QSortPolicy is not present in the FrameGraph, entities are drawn in the order they appear in the entity hierarchy.
Member Type Documentation
enum QSortPolicy::SortType
This enum type describes the available sort types.
| Constant | Value | Description |
|---|---|---|
Qt3DRender::QSortPolicy::StateChangeCost | (1 << 0) | sort the objects so as to minimize the cost of changing from the currently rendered state |
Qt3DRender::QSortPolicy::BackToFront | (1 << 1) | sort the objects from back to front based on inverted z order. More accurately, the sorting key is the z component of the projection of the camera-to-object-center vector onto the camera's view vector. |
Qt3DRender::QSortPolicy::Material | (1 << 2) | sort the objects based on their material value |
Qt3DRender::QSortPolicy::FrontToBack | (1 << 3) | sort the objects from front to back. The opposite of BackToFront. |
Qt3DRender::QSortPolicy::Texture (since Qt 5.14) | (1 << 4) | sort the objects to minimize texture changes. |
Property Documentation
sortTypes : QVector<int>
Specifies the sorting types to be used.
Access functions:
| QVector<int> | sortTypesInt() const |
| void | setSortTypes(const QVector<Qt3DRender::QSortPolicy::SortType> &sortTypes) |
| void | setSortTypes(const QVector<int> &sortTypesInt) |
Notifier signal:
| void | sortTypesChanged(const QVector<Qt3DRender::QSortPolicy::SortType> &sortTypes) |
| void | sortTypesChanged(const QVector<int> &sortTypes) |
Member Function Documentation
QSortPolicy::QSortPolicy(Qt3DCore::QNode *parent = nullptr)
Constructs QSortPolicy with given parent.
QVector<Qt3DRender::QSortPolicy::SortType> QSortPolicy::sortTypes() const
Returns the current sort types in use
See also setSortTypes().
© 2020 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.