QGraphicsTransform Class

Description détaillée

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

QGraphicsItem permet d’assigner un nombre illimité d’instances de QGraphicsTransform à une seule instance d’ QGraphicsItem. Chaque instance de QGraphicsTransform est appliquée dans l’ordre, une à la fois, à l’ QGraphicsItem auquel elle est assignée.

QGraphicsTransform est particulièrement utile pour les animations. Alors que la méthode QGraphicsItem::setTransform() vous permet d’attribuer n’importe quelle transformation directement à un élément, il n’existe aucun moyen direct d’interpoler entre deux transformations différentes (par exemple, lors d’une transition entre deux états, pour chacun desquels l’élément se voit attribuer une transformation arbitraire différente). En utilisant QGraphicsTransform, vous pouvez interpoler les valeurs des propriétés de chaque transformation indépendante. L’opération qui en résulte est ensuite combinée en une seule transformation qui est appliquée à l’ QGraphicsItem.

Les transformations sont calculées dans un véritable espace 3D à l’aide de ` QMatrix4x4`. Lorsque la transformation est appliquée à un ` QGraphicsItem`, elle est projetée en 2D sur une ` QTransform`. Lorsque plusieurs objets `QGraphicsTransform` sont appliqués à un ` QGraphicsItem`, toutes les transformations sont calculées dans un véritable espace 3D, la projection en 2D n’ayant lieu qu’après l’application du dernier `QGraphicsTransform`. La seule exception à cette règle est ` QGraphicsRotation`, qui effectue une projection en 2D après chaque rotation afin de préserver l’effet de perspective autour des axes X et Y.

Si vous souhaitez créer votre propre transformation configurable, vous pouvez créer une sous-classe de `QGraphicsTransform` (ou de l’une des sous-classes existantes) et réimplémenter la fonction virtuelle pure ` applyTo()`, qui prend un pointeur vers un ` QMatrix4x4`. Chaque opération que vous souhaitez 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 en conséquence.

QGraphicsTransform peut être utilisé conjointement avec les méthodes QGraphicsItem::setTransform(), QGraphicsItem::setRotation() et QGraphicsItem::setScale().