QSGClipNode Class

QSGClipNodeクラスは、シーングラフのクリッピング機能を実装しています。詳細...

Header: #include <QSGClipNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Inherits: QSGBasicGeometryNode

パブリック関数

QSGClipNode()
virtual ~QSGClipNode() override
QRectF clipRect() const
bool isRectangular() const
void setClipRect(const QRectF &rect)
void setIsRectangular(bool rectHint)

詳細説明

クリップはノードのサブツリーに適用され、ネストすることができます。複数のクリップノードは、すべてのジオメトリを交差させることで累積されます。蓄積はレンダリングの一部として行われます。

クリップノードは、シーングラフに追加する前にジオメトリを持つ必要があります。

クリッピングは通常、ステンシル・バッファを使用して実装される。

注意: QSG 接頭辞を持つすべてのクラスは、シーングラフのレンダリングスレッドでのみ使用する必要があります。詳細については、シーングラフとレンダリングを参照してください。

メンバー関数ドキュメント

QSGClipNode::QSGClipNode()

ジオメトリなしで新しい QSGClipNode を作成します。

クリップノードは、シーングラフに追加される前に、ジオメトリを持っている必要があります。

[override virtual noexcept] QSGClipNode::~QSGClipNode()

このQSGClipNode を削除します。

フラグQSGNode::OwnsGeometry が設定されている場合、ジオメトリも削除されます。

QRectF QSGClipNode::clipRect() const

このノードのクリップ矩形を返します。

setClipRect()も参照してください

bool QSGClipNode::isRectangular() const

このクリップノードが矩形のクリップを持っているかどうかを返します。

setIsRectangular()も参照して ください。

void QSGClipNode::setClipRect(const QRectF &rect)

このクリップノードのクリップ矩形をrect に設定します。

setIsRectangular と組み合わせて矩形クリップを設定すると、レンダラーがより最適なクリップ方法を使用する場合があります。

clipRect()も参照して ください。

void QSGClipNode::setIsRectangular(bool rectHint)

このクリップノードが矩形クリップを持つかどうかをrectHint に設定します。

これは最適化のヒントで、レンダラーがステンシルの代わりにはさみを使用できることを意味し、大幅に高速化されます。

このヒントが設定されていて適用可能な場合、クリップ領域はgeometry() ではなくclipRect() から生成されます。

デフォルトでは、このプロパティはfalse です。

isRectangular()も参照してください

©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。