Sur cette page

Qt3DRender::QSortPolicy Class

class Qt3DRender::QSortPolicy

Permet de stocker les types de tri à utiliser. En savoir plus...

En-tête : #include <qsortpolicy.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : SortPolicy
Hérite de : Qt3DRender::QFrameGraphNode
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Types publics

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

Propriétés

Fonctions publiques

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

Emplacements publics

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

Signaux

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

Description détaillée

Une classe ` Qt3DRender::QSortPolicy ` stocke le type de tri utilisé par le `FrameGraph`. Les types de tri déterminent la manière dont les entités dessinables sont triées avant le dessin afin de définir l'ordre de dessin. Lorsque `QSortPolicy` est présente dans le `FrameGraph`, le mécanisme de tri est déterminé par la liste ` sortTypes `. Plusieurs types de tri peuvent être utilisés simultanément. Si QSortPolicy n’est pas présent dans le FrameGraph, les entités sont dessinées dans l’ordre où elles apparaissent dans la hiérarchie des entités.

Documentation sur les types de membres

enum QSortPolicy::SortType

Ce type d'énumération décrit les types de tri disponibles.

ConstanteValeurDescription
Qt3DRender::QSortPolicy::StateChangeCost(1 << 0)trier les objets de manière à minimiser le coût du passage de l'état actuellement rendu
Qt3DRender::QSortPolicy::BackToFront(1 << 1)trier les objets de l'arrière vers l'avant en fonction de l’ordre z inversé. Plus précisément, la clé de tri est la composante z de la projection du vecteur « caméra-centre de l’objet » sur le vecteur de vue de la caméra.
Qt3DRender::QSortPolicy::Material(1 << 2)Trier les objets en fonction de la valeur de leur matériau (shader).
Qt3DRender::QSortPolicy::FrontToBack(1 << 3)Trier les objets de l'avant vers l'arrière. C'est l'inverse de « BackToFront ».
Qt3DRender::QSortPolicy::Texture (since Qt 5.14)(1 << 4)Trier les objets de manière à minimiser les changements de texture.
Qt3DRender::QSortPolicy::Uniform (since Qt 5.15)(1 << 5)trier les objets de manière à minimiser les changements d’uniforme.

Documentation des propriétés

sortTypes : QList<int>

Spécifie les types de tri à utiliser.

Fonctions d'accès :

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

Signal de notification :

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

Documentation des fonctions membres

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

Construit un objet `QSortPolicy` à partir de l'parent` fournie.

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

Renvoie les types de tri actuellement utilisés

Voir aussi setSortTypes().

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