QEasingCurve

La classe QEasingCurve fournit un assouplissement des courbes pour le contr�le d'animations. Plus d'informations...

#include <QEasingCurve>

Voir la position dans l'arbre des classes.

Description d�taill�e

La classe QEasingCurve fournit un assouplissement des courbes pour le contr�le d'animations.

L'assouplissement des courbes d�crit une fonction qui contr�le la vitesse de l'interpolation entre 0 et 1. Il permet d'obtenir des transitions d'une valeur � une autre plus naturelles qu'une simple vitesse constante. La classe QEasingCurve est g�n�ralement utilis�e en conjonction avec les classes QVariantAnimation et QPropertyAnimation mais peut �tre utilis�e toute seule. Elle est g�n�ralement utilis�e pour acc�l�rer l'interpolation � partir d'une vitesse nulle (ease in) ou d�c�l�rer jusqu'� une vitesse nulle (ease out). Ease in et ease out peuvent �galement �tre combin�s dans le m�me assouplissement.

Pour calculer la vitesse de l'interpolation, l'assouplissement de la courbe fournit la fonction valueForProgress(), o� l'argument progress sp�cifie la progression de l'interpolation : 0 est la valeur de d�part de l'interpolation, 1 est la valeur de fin. La valeur retourn�e est la progression effective de l'interpolation. Si la valeur retourn�e est respectivement la m�me que toutes les valeurs d'entr�es, l'assouplissement de la courbe est lin�aire. Il s'agit du comportement par d�faut.

Par exemple, ceci affichera la progression effective de l'interpolation entre 0 et 1 :

QEasingCurve easing(QEasingCurve::InOutQuad);
 
for(qreal t = 0.0; t < 1.0; t+=0.1)
    qWarning() << "Effective progress" << t << " is
               << easing.valueForProgress(t);

Quand vous utilisez une QPropertyAnimation, l'assouplissement de la courbe associ�e sera utilis� pour contr�ler la progression de l'interpolation entre startValue et endValue :

QPropertyAnimation animation;
animation.setStartValue(0);
animation.setEndValue(1000);
animation.setDuration(1000);
animation.setEasingCurve(QEasingCurve::InOutQuad);

La possibilit� de d�finir une amplitude, un d�passement, ou une p�riode d�pend du type de QEasingCurve. L'acc�s � l'amplitude est disponible pour les courbes qui se comportent comme des ressorts tels que les courbes de rebond �lastique. Changer l'amplitude change la hauteur de la courbe. L'acc�s � la p�riode n'est disponible que pour les courbes �lastiques et d�finir une p�riode sup�rieur ralentit le taux de rebond. Seuls les courbes avec un comportement de � boomerang � tels que InBack, OutBack, InOutBack et OutInBack ont des param�tres de d�passement. Ces courbes vont au-del� du point d'interpolation finale et reviennent � ce point tel un boomerang.

L'exemple Easing Curves contient des �chantillons de types QEasingCurve et vous permet de modifier les param�tres de la courbe.

Types membres

typedef QEasingCurve::EasingFunction

Il s'agit d'un typedef pour un pointeur vers une fonction avec la signature suivante :

qreal myEasingFunction(qreal progress);

enum QEasingCurve::Type

Le type d'assouplissement de courbe.

Constante	Valeur	Description
QEasingCurve::Linear	0	Assouplissement de la courbe pour une fonction lin�aire (t) : la vitesse est constante.
QEasingCurve::InQuad	1	Assouplissement de la courbe pour une fonction quadratique (t2) : acc�l�ration � partir d'une vitesse nulle.
QEasingCurve::OutQuad	2	Assouplissement de la courbe pour une fonction quadratique (t2) : d�c�l�ration jusqu'� une vitesse nulle.
QEasingCurve::InOutQuad	3	Assouplissement de la courbe pour une fonction quadratique (t2) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInQuad	4	Assouplissement de la courbe pour une fonction quadratique (t2) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::InCubic	5	Assouplissement de la courbe pour une fonction cubique (t3) : acc�l�ration � partir d'une vitesse nulle.
QEasingCurve::OutCubic	6	Assouplissement de la courbe pour une fonction cubique (t3) : d�c�l�ration jusqu'� une vitesse nulle.
QEasingCurve::InOutCubic	7	Assouplissement de la courbe pour une fonction cubique (t3) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInCubic	8	Assouplissement de la courbe pour une fonction cubique (t3) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::InQuart	9	Assouplissement de la courbe pour une fonction quartique (t4) : acc�l�ration � partir d'une vitesse nulle.
QEasingCurve::OutQuart	10	Assouplissement de la courbe pour une fonction quartique (t4) : d�c�l�ration jusqu'� une vitesse nulle.
QEasingCurve::InOutQuart	11	Assouplissement de la courbe pour une fonction quartique (t4) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInQuart	12	Assouplissement de la courbe pour une fonction quartique (t4) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::InQuint	13	Assouplissement de la courbe pour une fonction quintique (t5) : acc�l�ration � partir d'une vitesse nulle.
QEasingCurve::OutQuint	14	Assouplissement de la courbe pour une fonction quintique (t5) : d�c�l�ration jusqu'� une vitesse nulle.
QEasingCurve::InOutQuint	15	Assouplissement de la courbe pour une fonction quintique (t5) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInQuint	16	Assouplissement de la courbe pour une fonction quintique (t5) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::InSine	17	Assouplissement de la courbe pour une fonction sinuso�dal (sin(t)) : acc�l�ration � partir d'une vitesse nulle.
QEasingCurve::OutSine	18	Assouplissement de la courbe pour une fonction sinuso�dal (sin(t)) : d�c�l�ration jusqu'� une vitesse nulle.
QEasingCurve::InOutSine	19	Assouplissement de la courbe pour une fonction sinuso�dal (sin(t)) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInSine	20	Assouplissement de la courbe pour une fonction sinuso�dal (sin(t)) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::InExpo	21	Assouplissement de la courbe pour une fonction exponentielle (2t) : acc�l�ration � partir d'une vitesse nulle.
QEasingCurve::OutExpo	22	Assouplissement de la courbe pour une fonction exponentielle (2t) : d�c�l�ration jusqu'� une vitesse nulle.
QEasingCurve::InOutExpo	23	Assouplissement de la courbe pour une fonction exponentielle (2t) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInExpo	24	Assouplissement de la courbe pour une fonction exponentielle (2t) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::InCirc	25	Assouplissement de la courbe pour une fonction circulaire (sqrt(1-t2)) : acc�l�ration � partir d'une vitesse nulle.
QEasingCurve::OutCirc	26	Assouplissement de la courbe pour une fonction circulaire (sqrt(1-t2)) : d�c�l�ration jusqu'� une vitesse nulle.
QEasingCurve::InOutCirc	27	Assouplissement de la courbe pour une fonction circulaire (sqrt(1-t2)) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInCirc	28	Assouplissement de la courbe pour une fonction circulaire (sqrt(1-t2)) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::InElastic	29	Assouplissement de la courbe pour une fonction �lastique (Onde sinuso�dale qui d�cro�t de fa�on exponentielle) : acc�l�ration � partir d'une vitesse nulle. Le pic de l'amplitude peut �tre d�fini avec la param�tre amplitude, et la d�croissance de la p�riode par le param�tre period.
QEasingCurve::OutElastic	30	Assouplissement de la courbe pour une fonction �lastique (Onde sinuso�dale qui d�cro�t de fa�on exponentielle) : d�c�l�ration jusqu'� une vitesse nulle. Le pic de l'amplitude peut �tre d�fini avec la param�tre amplitude, et la d�croissance de la p�riode par le param�tre period.
QEasingCurve::InOutElastic	31	Assouplissement de la courbe pour une fonction �lastique (Onde sinuso�dale qui d�cro�t de fa�on exponentielle) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInElastic	32	Assouplissement de la courbe pour une fonction �lastique (Onde sinuso�dale qui d�cro�t de fa�on exponentielle) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::InBack	33	Assouplissement de la courbe pour un retour easing in (d�passement de fonction cubique : (s+1)*t3 - s*t2) : acc�l�ration � partir d'une vitesse nulle.
QEasingCurve::OutBack	34	Assouplissement de la courbe pour un retour easing out (d�passement de fonction cubique : (s+1)*t3 - s*t2) : d�c�l�ration jusqu'� une vitesse nulle.
QEasingCurve::InOutBack	35	Assouplissement de la courbe pour un retour easing in/out (d�passement de fonction cubique : (s+1)*t3 - s*t2) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInBack	36	Assouplissement de la courbe pour un retour easing out/in (d�passement de fonction cubique : (s+1)*t3 - s*t2) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::InBounce	37	Assouplissement de la courbe pour une fonction � rebond (Rebond parabolique qui d�cro�t de fa�on exponentielle) : acc�l�ration � partir d'une vitesse nulle.
QEasingCurve::OutBounce	38	Assouplissement de la courbe pour une fonction � rebond (Rebond parabolique qui d�cro�t de fa�on exponentielle) : d�c�l�ration jusqu'� une vitesse nulle.
QEasingCurve::InOutBounce	39	Assouplissement de la courbe pour une fonction � rebond easing in/out (Rebond parabolique qui d�cro�t de fa�on exponentielle) : acc�l�ration jusqu'� la moiti�, puis d�c�l�ration.
QEasingCurve::OutInBounce	40	Assouplissement de la courbe pour une fonction � rebond easing out/in (Rebond parabolique qui d�cro�t de fa�on exponentielle) : d�c�l�ration jusqu'� la moiti�, puis acc�l�ration.
QEasingCurve::Custom	45	Ce type est retourn� si l'utilisateur sp�cifie un type de courbe personnalis� avec setCustomType(). Notez que vous ne pouvez pas appeler setType() avec cette valeur, mais type() peut la retourner.

Fonctions membres

QEasingCurve::QEasingCurve ( Type type = Linear )

Construit un assouplissement de la courbe du type donn�.

QEasingCurve::QEasingCurve ( const QEasingCurve & other )

Construit une copie d'une autre courbe.

QEasingCurve::~QEasingCurve ()

Destructeur.

qreal QEasingCurve::amplitude () const

Retourne l'amplitude. Cela n'est pas applicable � tous les types de courbes, seulement pour les courbes �lastiques et � rebonds (courbe du type() QEasingCurve::InBounce, QEasingCurve::OutBounce, QEasingCurve::InOutBounce, QEasingCurve::OutInBounce, QEasingCurve::InElastic, QEasingCurve::OutElastic, QEasingCurve::InOutElastic ou QEasingCurve::OutInElastic).

Voir aussi setAmplitude().

EasingFunction QEasingCurve::customType () const

Retourne un pointeur vers la fonction de l'assouplissement de la courbe personnalis�e. Si type() ne retourne pas QEasingCurve::Custom, cette fonction retournera 0.

Voir aussi setCustomType().

qreal QEasingCurve::overshoot () const

Retourne le d�passement. Cela n'est pas applicable � tous les types de courbes, seulement si type() est QEasingCurve::InBack, QEasingCurve::OutBack, QEasingCurve::InOutBack ou QEasingCurve::OutInBack.

Voir aussi setOvershoot().

qreal QEasingCurve::period () const

Retourne la p�riode. Cela n'est pas applicable � tous les types de courbes, seulement si type() est QEasingCurve::InElastic, QEasingCurve::OutElastic, QEasingCurve::InOutElastic ou QEasingCurve::OutInElastic.

Voir aussi setPeriod().

void QEasingCurve::setAmplitude ( qreal amplitude )

D�finit l'amplitude � la valeur de amplitude.

Cela va r�gler l'amplitude du rebond ou l'amplitude de l'effet �lastique « spring ». Plus le nombre est �lev�, plus l'amplitude l'est.

Voir aussi amplitude().

void QEasingCurve::setCustomType ( EasingFunction func )

D�finit un assouplissement de la courbe personnalis�e qui est donn� par l'utilisateur dans la fonction func. La signature de la fonction est qreal myEasingFunction(qreal progress), o� progress et la valeur retourn�e sont consid�r�s comme normalis�s entre 0 et 1 ; dans certains cas, la valeur retourn�e peut �tre en dehors des limites. Apr�s avoir appel� cette fonction, type() retournera QEasingCurve::Custom. func ne peut pas �tre nulle.

Voir aussi customType() et valueForProgress().

void QEasingCurve::setOvershoot ( qreal overshoot )

D�finit le d�passement � overshoot.

0 ne produit aucun d�passement et la valeur par d�faut, 1.70158, produit un d�passement de 10 pour cent.

Voir aussi overshoot().

void QEasingCurve::setPeriod ( qreal period )

D�finit la p�riode � period. Fixer une petite valeur pour la p�riode donnera une fr�quence �lev�e de la courbe. Une grande p�riode donnera une fr�quence faible.

Voir aussi period().

void QEasingCurve::setType ( Type type )

D�finit le type de l'assouplissement de la courbe � la valeur de type.

Voir aussi type().

Type QEasingCurve::type () const

Retourne le type d'assouplissement de la courbe.

Voir aussi setType().

qreal QEasingCurve::valueForProgress ( qreal progress ) const

Retourne la progression effective pour l'assouplissement de la courbe � progress. Bien que progress doive �tre compris entre 0 et 1, la progression effective retourn�e peut �tre en dehors de ces limites. Par exemple, QEasingCurve::InBack retournera des valeurs n�gatives au d�but de la fonction.

bool QEasingCurve::operator!= ( const QEasingCurve & other ) const

Compare cet assouplissement de la courbe avec other et retourne true si les valeurs ne sont pas �gales. Elle comparera �galement les propri�t�s d'une courbe.

Voir aussi operator==().

QEasingCurve & QEasingCurve::operator= ( const QEasingCurve & other )

Copie other.

bool QEasingCurve::operator== ( const QEasingCurve & other ) const

Compare cet assouplissement de la courbe avec other et retourne true si les valeurs sont �gales. Elle comparera �galement les propri�t�s d'une courbe.

En relation mais non membres de la classe

QDataStream & operator<< ( QDataStream & stream, const QEasingCurve & easing )

�crit la courbe easing donn�e dans le flux stream donn� et retourne une r�f�rence sur le flux.

Voir aussi s�rialisation des type de donn�es Qt.

Remerciements

Merci � Jonathan Courtois pour la traduction et � Thibaut Cuvelier ainsi qu'� Jacques Thery pour leur relecture !