このページでは

Qt3DRender::QSortPolicy Class

class Qt3DRender::QSortPolicy

使用するソートタイプの保存場所を提供します。詳細...

ヘッダー: #include <qsortpolicy.h>
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)

通知シグナル:

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()も参照してください 。

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