QEasingCurve Class
La clase QEasingCurve proporciona curvas de aceleración y desaceleración para controlar la animación. Más información...
| Encabezado: | #include <QEasingCurve> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QEasingCurve forma parte de Animation Framework.
Tipos públicos
| EasingFunction | |
| enum | Type { Linear, InQuad, OutQuad, InOutQuad, OutInQuad, …, Custom } |
Funciones públicas
| QEasingCurve(QEasingCurve::Type type = Linear) | |
| QEasingCurve(const QEasingCurve &other) | |
| QEasingCurve(QEasingCurve &&other) | |
| ~QEasingCurve() | |
| void | addCubicBezierSegment(const QPointF &c1, const QPointF &c2, const QPointF &endPoint) |
| void | addTCBSegment(const QPointF &nextPoint, qreal t, qreal c, qreal b) |
| qreal | amplitude() const |
| QEasingCurve::EasingFunction | customType() const |
| qreal | overshoot() const |
| qreal | period() const |
| void | setAmplitude(qreal amplitude) |
| void | setCustomType(QEasingCurve::EasingFunction func) |
| void | setOvershoot(qreal overshoot) |
| void | setPeriod(qreal period) |
| void | setType(QEasingCurve::Type type) |
| void | swap(QEasingCurve &other) |
| QList<QPointF> | toCubicSpline() const |
| QEasingCurve::Type | type() const |
| qreal | valueForProgress(qreal progress) const |
| QEasingCurve & | operator=(QEasingCurve &&other) |
| QEasingCurve & | operator=(const QEasingCurve &other) |
Miembros públicos estáticos
(since 6.12) QEasingCurve | fromCubicBezier(QPointF c1, QPointF c2) |
No miembros relacionados
| bool | operator!=(const QEasingCurve &lhs, const QEasingCurve &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QEasingCurve &easing) |
| bool | operator==(const QEasingCurve &lhs, const QEasingCurve &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QEasingCurve &easing) |
Descripción detallada
Las curvas de suavización describen una función que controla cómo debe ser la velocidad de la interpolación entre 0 y 1. Las curvas de suavización permiten que las transiciones de un valor a otro parezcan más naturales de lo que permitiría una simple velocidad constante. La clase `QEasingCurve` se suele utilizar junto con las clases ` QVariantAnimation ` y ` QPropertyAnimation `, aunque también puede utilizarse de forma independiente. Se suele emplear para acelerar la interpolación desde una velocidad cero (aceleración inicial) o para desacelerar hasta una velocidad cero (desaceleración final). La aceleración inicial y la desaceleración final también pueden combinarse en una misma curva de suavizado.
Para calcular la velocidad de la interpolación, la curva de suavizado proporciona la función valueForProgress(), donde el argumento progress especifica el progreso de la interpolación: 0 es el valor inicial de la interpolación y 1 es el valor final de la misma. El valor devuelto es el progreso efectivo de la interpolación. Si el valor devuelto es igual al valor de entrada para todos los valores de entrada, la curva de aceleración es una curva lineal. Este es el comportamiento por defecto.
Por ejemplo,
QEasingCurve easing(QEasingCurve::InOutQuad);
for (qreal t = 0,0; t < 1,0; t+= 0,1)
qWarning() << "Effective progress" << t << "is"
<< easing.valueForProgress(t);imprimirá el progreso efectivo de la interpolación entre 0 y 1.
Al utilizar un ` QPropertyAnimation`, se empleará la curva de suavización asociada para controlar el progreso de la interpolación entre `startValue` y `endValue`:
QPropertyAnimation animation;
animation.setStartValue(0);
animation.setEndValue(1000);
animation.setDuration(1000);
animation.setEasingCurve(QEasingCurve::InOutQuad);La posibilidad de establecer una amplitud, un sobreimpulso o un período depende del tipo de QEasingCurve. El acceso a la amplitud está disponible para las curvas que se comportan como resortes, como las curvas elásticas y de rebote. Al cambiar la amplitud, se modifica la altura de la curva. El acceso al período solo está disponible para las curvas elásticas, y establecer un período mayor ralentiza la velocidad de rebote. Solo las curvas que presentan comportamientos de «boomerang», como InBack, OutBack, InOutBack y OutInBack, disponen de ajustes de sobreimpulso. Estas curvas se interpolarán más allá de los puntos finales y volverán al punto final, actuando de forma similar a un boomerang.
El ejemplo «Easing Curves » contiene muestras de tipos QEasingCurve y te permite modificar los parámetros de las curvas.
Documentación sobre tipos de miembros
QEasingCurve::EasingFunction
Se trata de una definición de tipo (typedef) para un puntero a una función con la siguiente firma:
enum QEasingCurve::Type
El tipo de curva de atenuación.
| Constante | Valor |
|---|---|
QEasingCurve::Linear | 0 |

Curva de atenuación para una función lineal (t): la velocidad es constante.
| Constante | Valor |
|---|---|
QEasingCurve::InQuad | 1 |

Curva de aceleración para una función cuadrática (t²): aceleración partiendo de una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::OutQuad | 2 |

Curva de atenuación para una función cuadrática (t^2): desacelerando hasta una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::InOutQuad | 3 |

Curva de atenuación para una función cuadrática (t²): aceleración hasta la mitad del recorrido, seguida de desaceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInQuad | 4 |

Curva de suavizado para una función cuadrática (t^2): desaceleración hasta la mitad del recorrido, seguida de aceleración.
| Constante | Valor |
|---|---|
QEasingCurve::InCubic | 5 |

Curva de atenuación para una función cúbica (t^3): aceleración partiendo de una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::OutCubic | 6 |

Curva de atenuación para una función cúbica (t^3): desacelerando hasta una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::InOutCubic | 7 |

Curva de aceleración/desaceleración para una función cúbica (t^3): aceleración hasta la mitad, seguida de desaceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInCubic | 8 |

Curva de suavizado para una función cúbica (t³): desaceleración hasta la mitad y, a continuación, aceleración.
| Constante | Valor |
|---|---|
QEasingCurve::InQuart | 9 |

Curva de atenuación para una función de cuarto grado (t^4): aceleración partiendo de una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::OutQuart | 10 |

Curva de atenuación para una función cuártica (t^4): desaceleración hasta velocidad cero.
| Constante | Valor |
|---|---|
QEasingCurve::InOutQuart | 11 |

Curva de suavizado para una función cuártica (t^4): aceleración hasta la mitad del recorrido, seguida de desaceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInQuart | 12 |

Curva de atenuación para una función cuártica (t^4): desaceleración hasta la mitad del recorrido, seguida de aceleración.
| Constante | Valor |
|---|---|
QEasingCurve::InQuint | 13 |

Curva de aceleración para una función quíntica (t^5): aceleración partiendo de una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::OutQuint | 14 |

Curva de atenuación para una función quíntica (t^5): desaceleración hasta velocidad cero.
| Constante | Valor |
|---|---|
QEasingCurve::InOutQuint | 15 |

Curva de atenuación para una función quíntica (t^5): aceleración hasta la mitad del recorrido, seguida de desaceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInQuint | 16 |

Curva de suavizado para una función quíntica (t^5): desaceleración hasta la mitad y, a continuación, aceleración.
| Constante | Valor |
|---|---|
QEasingCurve::InSine | 17 |

Curva de suavizado para una función sinusoidal (sin(t)): aceleración partiendo de una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::OutSine | 18 |

Curva de atenuación para una función sinusoidal (sin(t)): desacelerando hasta una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::InOutSine | 19 |

Curva de atenuación para una función sinusoidal (sin(t)): aceleración hasta la mitad del recorrido, seguida de desaceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInSine | 20 |

Curva de atenuación para una función sinusoidal (sin(t)): desaceleración hasta la mitad y, a continuación, aceleración.
| Constante | Valor |
|---|---|
QEasingCurve::InExpo | 21 |

Curva de atenuación para una función exponencial (2^t): aceleración partiendo de una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::OutExpo | 22 |

Curva de atenuación para una función exponencial (2^t): desacelerando hasta una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::InOutExpo | 23 |

Curva de atenuación para una función exponencial (2^t): aceleración hasta la mitad del recorrido, seguida de desaceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInExpo | 24 |

Curva de suavizado para una función exponencial (2^t): desaceleración hasta la mitad y, a continuación, aceleración.
| Constante | Valor |
|---|---|
QEasingCurve::InCirc | 25 |

Curva de atenuación para una función circular (sqrt(1-t^2)): aceleración partiendo de una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::OutCirc | 26 |

Curva de atenuación para una función circular (sqrt(1-t^2)): desacelerando hasta una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::InOutCirc | 27 |

Curva de aceleración/deceleración para una función circular (sqrt(1-t^2)): aceleración hasta la mitad del recorrido, seguida de deceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInCirc | 28 |

Curva de atenuación para una función circular (sqrt(1-t^2)): desaceleración hasta la mitad del recorrido, seguida de aceleración.
| Constante | Valor |
|---|---|
QEasingCurve::InElastic | 29 |

Curva de aceleración/deceleración para una función elástica (onda sinusoidal con decaimiento exponencial): aceleración partiendo de una velocidad nula. La amplitud máxima se puede ajustar con el parámetro «amplitud», y el periodo de decaimiento con el parámetro «periodo ».
| Constante | Valor |
|---|---|
QEasingCurve::OutElastic | 30 |

Curva de atenuación para una función elástica (onda sinusoidal con decaimiento exponencial): desacelerando hasta una velocidad nula. La amplitud máxima se puede ajustar con el parámetro «amplitud», y el periodo de decaimiento con el parámetro «periodo ».
| Constante | Valor |
|---|---|
QEasingCurve::InOutElastic | 31 |

Curva de atenuación para una función elástica (onda sinusoidal con decaimiento exponencial): aceleración hasta la mitad del recorrido, seguida de desaceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInElastic | 32 |

Curva de atenuación para una función elástica (onda sinusoidal con decaimiento exponencial): desaceleración hasta la mitad y, a continuación, aceleración.
| Constante | Valor |
|---|---|
QEasingCurve::InBack | 33 |

Curva de atenuación para una función cúbica de retroceso (con sobreimpulso: (s+1)*t^3 - s*t^2): aceleración desde la velocidad cero.
| Constante | Valor |
|---|---|
QEasingCurve::OutBack | 34 |

Curva de atenuación para una función cúbica con sobreimpulso: (s+1)*t^3 - s*t^2, con atenuación de salida: desacelerando hasta velocidad cero.
| Constante | Valor |
|---|---|
QEasingCurve::InOutBack | 35 |

Función InOutBack}
Curva de aceleración/desaceleración para un retroceso (función cúbica con sobreimpulso: (s+1)*t^3 - s*t^2) con aceleración/desaceleración: aceleración hasta la mitad, luego desaceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInBack | 36 |

Curva de aceleración/desaceleración para un retroceso (aceleración/desaceleración cúbica con sobreimpulso: (s+1)*t^3 - s*t^2): desaceleración hasta la mitad y, a continuación, aceleración.
| Constante | Valor |
|---|---|
QEasingCurve::InBounce | 37 |

Curva de aceleración para un rebote (rebote parabólico con decaimiento exponencial): aceleración partiendo de una velocidad nula.
| Constante | Valor |
|---|---|
QEasingCurve::OutBounce | 38 |

Curva de atenuación para una función de rebote (rebote parabólico con decaimiento exponencial): desacelerando desde velocidad cero.
| Constante | Valor |
|---|---|
QEasingCurve::InOutBounce | 39 |

Curva de aceleración/desaceleración para una función de rebote (rebote parabólico con decaimiento exponencial) con aceleración/desaceleración de entrada y salida: aceleración hasta la mitad del recorrido, seguida de desaceleración.
| Constante | Valor |
|---|---|
QEasingCurve::OutInBounce | 40 |

Curva de atenuación para una función de rebote (rebote parabólico con decaimiento exponencial) con atenuación de entrada/salida: desaceleración hasta la mitad y, a continuación, aceleración.
| Constante | Valor | Descripción |
|---|---|---|
QEasingCurve::BezierSpline | 45 | Permite definir una curva de atenuación personalizada utilizando una spline Bézier cúbica |
QEasingCurve::TCBSpline | 46 | Permite definir una curva de aceleración personalizada utilizando una spline TCB |
QEasingCurve::Custom | 47 | Se devuelve si el usuario ha especificado un tipo de curva personalizada con ` setCustomType()`. Ten en cuenta que no se puede llamar a ` setType()` con este valor, pero ` type()` sí puede devolverlo. |
Véase también addCubicBezierSegment() y addTCBSegment().
Documentación de funciones de miembro
QEasingCurve::QEasingCurve(QEasingCurve::Type type = Linear)
Crea una curva de aceleración a partir del valor dado type.
QEasingCurve::QEasingCurve(const QEasingCurve &other)
Crea una copia de other.
[noexcept] QEasingCurve::QEasingCurve(QEasingCurve &&other)
Crea una instancia de `QEasingCurve` mediante la construcción por movimiento, de modo que apunte al mismo objeto al que apuntaba ` other `.
[noexcept] QEasingCurve::~QEasingCurve()
Destructor.
void QEasingCurve::addCubicBezierSegment(const QPointF &c1, const QPointF &c2, const QPointF &endPoint)
Añade un segmento de una spline Bézier cúbica para definir una curva de aceleración personalizada. Solo es aplicable si type() es QEasingCurve::BezierSpline. Ten en cuenta que la spline comienza implícitamente en (0,0) y debe terminar en (1,1) para que sea una curva de aceleración válida. c1 y c2 son los puntos de control utilizados para trazar la curva. endPoint es el punto final de la curva.
Véase también fromCubicBezier().
void QEasingCurve::addTCBSegment(const QPointF &nextPoint, qreal t, qreal c, qreal b)
Añade un segmento de una spline Bézier TCB para definir una curva de aceleración personalizada. Solo es aplicable si type() es QEasingCurve::TCBSpline. Para que sea una curva de aceleración válida, la spline debe comenzar explícitamente en (0,0) y terminar en (1,0). La tensión t modifica la longitud del vector tangente. La continuidad c modifica la brusquedad del cambio entre las tangentes. El sesgo b modifica la dirección del vector tangente. nextPoint es la posición de la muestra. Los tres parámetros son válidos entre -1 y 1 y definen la tangente del punto de control. Si los tres parámetros son 0, la spline resultante es una spline de Catmull-Rom. Los puntos inicial y final siempre tienen un sesgo de -1 y 1, ya que la tangente exterior no está definida.
qreal QEasingCurve::amplitude() const
Devuelve la amplitud. Esto no es aplicable a todos los tipos de curva. Solo es aplicable a las curvas de rebote y elásticas (curvas de type() QEasingCurve::InBounce, QEasingCurve::OutBounce, QEasingCurve::InOutBounce, QEasingCurve::OutInBounce, QEasingCurve::InElastic, QEasingCurve::OutElastic, QEasingCurve::InOutElastic o QEasingCurve::OutInElastic).
Véase también setAmplitude().
QEasingCurve::EasingFunction QEasingCurve::customType() const
Devuelve el puntero a la función de la curva de aceleración personalizada. Si type() no devuelve QEasingCurve::Custom, esta función devolverá 0.
Véase también setCustomType().
[static, since 6.12] QEasingCurve QEasingCurve::fromCubicBezier(QPointF c1, QPointF c2)
Devuelve una curva Bézier cúbica con los puntos de control especificados c1 y c2.
Una curva Bézier cúbica viene definida por cuatro puntos de control: C0, C1, C2 y C3. C0 y C3 corresponden a la posición inicial y final, respectivamente. Esta función devuelve una curva Bézier cúbica cuyo punto inicial C0 está fijado en (0, 0) y cuyo punto final C3 está fijado en (1, 1).
Se trata de una función auxiliar de conveniencia, equivalente a llamar a `addCubicBezierSegment(c1, c2, QPointF(1, 1))`. Si necesitas construir una spline de Bézier cúbica más compleja, utiliza en su lugar la función ` addCubicBezierSegment()`.
Esta función se introdujo en Qt 6.12.
Véase también addCubicBezierSegment().
qreal QEasingCurve::overshoot() const
Devuelve el sobreimpulso. Esto no es aplicable a todos los tipos de curva. Solo es aplicable si type() es QEasingCurve::InBack, QEasingCurve::OutBack, QEasingCurve::InOutBack o QEasingCurve::OutInBack.
Véase también setOvershoot().
qreal QEasingCurve::period() const
Devuelve el período. Esto no es aplicable a todos los tipos de curva. Solo es aplicable si type() es QEasingCurve::InElastic, QEasingCurve::OutElastic, QEasingCurve::InOutElastic o QEasingCurve::OutInElastic.
Véase también setPeriod().
void QEasingCurve::setAmplitude(qreal amplitude)
Establece la amplitud en amplitude.
Esto establecerá la amplitud del rebote o la amplitud del efecto elástico de «resorte». Cuanto mayor sea el número, mayor será la amplitud.
Véase también amplitude().
void QEasingCurve::setCustomType(QEasingCurve::EasingFunction func)
Establece una curva de aceleración personalizada definida por el usuario en la función ` func`. La firma de la función es `qreal myEasingFunction(qreal progress)`, donde `progress` y el valor de retorno se consideran normalizados entre 0 y 1. (En algunos casos, el valor de retorno puede estar fuera de ese rango). Tras llamar a esta función, ` type()` devolverá ` QEasingCurve::Custom`. ` func ` no puede ser ` nullptr`.
Véanse también customType() y valueForProgress().
void QEasingCurve::setOvershoot(qreal overshoot)
Establece el sobreimpulso en overshoot.
El valor 0 no produce sobreimpulso, y el valor por defecto de 1,70158 produce un sobreimpulso del 10 por ciento.
Véase también overshoot().
void QEasingCurve::setPeriod(qreal period)
Establece el período en period. Si se establece un valor de período pequeño, la curva tendrá una frecuencia alta. Un período grande le dará una frecuencia baja.
Véase también period().
void QEasingCurve::setType(QEasingCurve::Type type)
Establece el tipo de curva de aceleración en « type ».
Véase también type().
[noexcept] void QEasingCurve::swap(QEasingCurve &other)
Intercambia esta curva con other. Esta operación es muy rápida y nunca falla.
QList<QPointF> QEasingCurve::toCubicSpline() const
Devuelve la «cubicBezierSpline» que define una curva de aceleración personalizada. Si la curva de aceleración no tiene una curva de aceleración Bézier personalizada, la lista estará vacía.
QEasingCurve::Type QEasingCurve::type() const
Devuelve el tipo de la curva de aceleración.
Véase también setType().
qreal QEasingCurve::valueForProgress(qreal progress) const
Devuelve el progreso efectivo de la curva de atenuación en progress. Mientras que progress debe estar comprendido entre 0 y 1, el progreso efectivo devuelto puede estar fuera de esos límites. Por ejemplo, QEasingCurve::InBack devolverá valores negativos al principio de la función.
[noexcept] QEasingCurve &QEasingCurve::operator=(QEasingCurve &&other)
Asigna « other » a esta instancia de « QEasingCurve ». . . . . . . . . . . . . . . . . . . . . . . . . .xml-ph-0001@
QEasingCurve &QEasingCurve::operator=(const QEasingCurve &other)
Copia de other.
Relacionado: No socios
[noexcept] bool operator!=(const QEasingCurve &lhs, const QEasingCurve &rhs)
Compara la curva de amortiguación lhs con rhs y devuelve true si no son iguales; en caso contrario, devuelve false. También compara las propiedades de las curvas.
Véase también operator==().
QDataStream &operator<<(QDataStream &stream, const QEasingCurve &easing)
Escribe la curva « easing » especificada en el flujo « stream » indicado y devuelve una referencia al flujo.
Advertencia: No se admitela escritura de curvas de aceleración de tipo QEasingCurve::Custom (es decir, curvas con una función de aceleración personalizada).
Véase también «Serialización detipos de datos de Qt».
[noexcept] bool operator==(const QEasingCurve &lhs, const QEasingCurve &rhs)
Compara la curva de atenuación lhs con rhs y devuelve true si son iguales; en caso contrario, devuelve false. También compara las propiedades de las curvas.
QDataStream &operator>>(QDataStream &stream, QEasingCurve &easing)
Lee una curva de atenuación desde el archivo « stream » especificado y la convierte en la curva « easing » especificada, y devuelve una referencia al flujo.
Véase también «Serialización detipos de datos de Qt».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.