QGraphicsTransform

La classe QGraphicsTransform est une classe abstraite destinée à la construction de transformations avancées sur des QGraphicsItem. Plus d'informations...

#include <QGraphicsTransform>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QObject.

Hérité par QGraphicsRotation and QGraphicsScale.

Cette classe a été introduite dans Qt 4.6.

Description détaillée

La classe QGraphicsTransform est une classe abstraite destinée à la construction de transformations avancées sur des QGraphicsItem.

En tant qu'alternative à QGraphicsItem::transform, QGraphicsTransform vous permet de créer et de contrôler des transformations avancées pouvant être configurées indépendamment en utilisant des propriétés spécialisées.

QGraphicsItem vous autorise à associer plusieurs instances de QGraphicsTransform à un QGraphicsItem. Chaque QGraphicsTransform est appliquée dans l'ordre, une par une, au QGraphicsItem à laquelle elle est associée.

QGraphicsTransform est particulièrement utile pour les animations. Comme QGraphicsItem::setTransform() vous fait affecter les transformations directement aux éléments, elle ne donne pas de moyen direct d'interpolation entre deux transformations différentes (par exemple, pour une transition entre deux états, pour chacun desquels l'élément a une transformation distincte affectée). En utilisant QGraphicsTransform, vous pouvez interpoler indépendamment les valeurs de propriété de chaque transformation. L'opération résultante est alors combinée dans une transformation unique qui est appliquée à QGraphicsItem.

Les transformations sont d'abord calculées dans un espace 3D en utilisant QMatrix4x4. Lorsque la transformation est appliquée à un QGraphicsItem, elle est ensuite projetée sur une QTransform 2D. Quand plusieurs objets QGraphicsTransform sont appliqués à un QGraphicsItem, toutes les transformations sont calculées dans un espace 3D, la projection en 2D étant effectuée seulement après l'application de la dernière QGraphicsTransform. L'exception est QGraphicsRotation, qui est projetée en 2D après chaque rotation pour préserver l'effet de perspective autour des axes X et Y.

Si vous voulez créer votre propre transformation configurable, vous pouvez créer une classe dérivée de QGraphicsTransform (ou d'une classe dérivée déjà existante) et réimplémenter la fonction virtuelle pure applyTo(), qui prend comme paramètre un pointeur vers une QMatrix4x4. Chaque opération que vous voulez appliquer doit être exposée sous forme de propriétés (par exemple, customTransform->setVerticalShear(2.5)). Dans votre réimplémentation de applyTo(), vous pouvez modifier la transformation fournie.

QGraphicsTransform peut être utilisée en même temps que QGraphicsItem::setTransform(), QGraphicsItem::setRotation() et QGraphicsItem::setScale().

Voir aussi QGraphicsItem::transform(), QGraphicsScale et QGraphicsRotation.

Fonctions membres

QGraphicsTransform::QGraphicsTransform ( QObject * parent = 0 )

Construit un nouveau QGraphicsTransform avec le parent donné.

QGraphicsTransform::~QGraphicsTransform ()

Détruit l'objet.

void QGraphicsTransform::applyTo ( QMatrix4x4 * matrix ) const [pure virtual]

Cette méthode virtuelle pure doit être réimplémentée dans les classes dérivées.

Elle applique cette transformation à matrix.

Voir aussi QGraphicsItem::transform() et QMatrix4x4::toTransform().

void QGraphicsTransform::update () [protected slot]

Prévient que cette opération de transformation a modifié ses paramètres et qu'en conséquence applyTo() renverra un résultat différent.

Si vous implémentez vos propres transformations graphiques, vous devez appeler cette fonction à chaque fois que vous modifiez un paramètre, pour que QGraphicsItem sache que sa transformation doit être mise à jour.

Voir aussi applyTo().

Remerciements

Merci à Ilya Diallo pour la traduction et à Dimitry Ernot ainsi qu'à Jacques Thery pour leur relecture !