QGraphicsTransform Class

詳細な説明

QGraphicsItem::transform の代替として、QGraphicsTransform を使用すると、専用のプロパティを使用して個別に設定できる高度な変形を作成および制御することができます。

QGraphicsItem を使用すると、1 つのQGraphicsItem に任意の数の QGraphicsTransform インスタンスを割り当てることができます。各 QGraphicsTransform は、割り当てられたQGraphicsItem に対して、順番に 1 つずつ適用されます。

QGraphicsTransformは、アニメーションにおいて特に有用です。QGraphicsItem::setTransform()を使用すると、任意のトランスフォームをアイテムに直接割り当てることができますが、2つの異なるトランスフォーム間を補間する直接的な方法はありません（例えば、アイテムにそれぞれ異なる任意のトランスフォームが割り当てられている2つの状態間の遷移時など）。 QGraphicsTransform を使用すると、各独立した変換のプロパティ値を補間することができます。その結果得られる操作は、単一の変換に統合され、QGraphicsItem に適用されます。

変換は、QMatrix4x4 を使用して真の3D空間で計算されます。変換がQGraphicsItem に適用されると、2DのQTransform へと投影されます。 複数の QGraphicsTransform オブジェクトがQGraphicsItem に適用される場合、すべての変換は真の 3D 空間で計算され、2D への投影は最後の QGraphicsTransform が適用された後にのみ行われます。ただし、QGraphicsRotation は例外であり、X 軸および Y 軸周りの遠近感を維持するために、各回転の後に 2D へ投影されます。

独自の設定可能な変換を作成したい場合は、QGraphicsTransform（または既存のサブクラスのいずれか）のサブクラスを作成し、QMatrix4x4 へのポインタを引数とする純仮想関数applyTo()を再実装します。 適用したい各操作は、プロパティとして公開する必要があります（例：customTransform->setVerticalShear(2.5)）。applyTo() の再実装内では、渡された変換を適宜変更することができます。

QGraphicsTransformは、QGraphicsItem::setTransform()、QGraphicsItem::setRotation()、およびQGraphicsItem::setScale()と組み合わせて使用できます。