En esta página

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

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)
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:

qreal myEasingFunction(qreal progress);

enum QEasingCurve::Type

El tipo de curva de atenuación.

ConstanteValor
QEasingCurve::Linear0

Gráfica de una función lineal.

Curva de atenuación para una función lineal (t): la velocidad es constante.

ConstanteValor
QEasingCurve::InQuad1

Gráfico de una función no cuadrática.

Curva de aceleración para una función cuadrática (t²): aceleración partiendo de una velocidad nula.

ConstanteValor
QEasingCurve::OutQuad2

Gráfico de una función cuadrática de tipo «OutQuadratic»

Curva de atenuación para una función cuadrática (t^2): desacelerando hasta una velocidad nula.

ConstanteValor
QEasingCurve::InOutQuad3

Gráfica de una función cuadrática InOutquad

Curva de atenuación para una función cuadrática (t²): aceleración hasta la mitad del recorrido, seguida de desaceleración.

ConstanteValor
QEasingCurve::OutInQuad4

Gráfico de una función cuadrática de tipo OutInquad

Curva de suavizado para una función cuadrática (t^2): desaceleración hasta la mitad del recorrido, seguida de aceleración.

ConstanteValor
QEasingCurve::InCubic5

Gráfica de una función InCubic

Curva de atenuación para una función cúbica (t^3): aceleración partiendo de una velocidad nula.

ConstanteValor
QEasingCurve::OutCubic6

Gráfico de una función OutCubic

Curva de atenuación para una función cúbica (t^3): desacelerando hasta una velocidad nula.

ConstanteValor
QEasingCurve::InOutCubic7

Gráfico de una función InOutCubic.

Curva de aceleración/desaceleración para una función cúbica (t^3): aceleración hasta la mitad, seguida de desaceleración.

ConstanteValor
QEasingCurve::OutInCubic8

Gráfico de la función OutInCubic.

Curva de suavizado para una función cúbica (t³): desaceleración hasta la mitad y, a continuación, aceleración.

ConstanteValor
QEasingCurve::InQuart9

Gráfico de una función InQuartic.

Curva de atenuación para una función de cuarto grado (t^4): aceleración partiendo de una velocidad nula.

ConstanteValor
QEasingCurve::OutQuart10

Gráfico de una función «OutQuartic».

Curva de atenuación para una función cuártica (t^4): desaceleración hasta velocidad cero.

ConstanteValor
QEasingCurve::InOutQuart11

Gráfico de una función InOutQuartic.

Curva de suavizado para una función cuártica (t^4): aceleración hasta la mitad del recorrido, seguida de desaceleración.

ConstanteValor
QEasingCurve::OutInQuart12

Gráfico de una función OutInQuartic.

Curva de atenuación para una función cuártica (t^4): desaceleración hasta la mitad del recorrido, seguida de aceleración.

ConstanteValor
QEasingCurve::InQuint13

Gráfico de una función InQuintic

Curva de aceleración para una función quíntica (t^5): aceleración partiendo de una velocidad nula.

ConstanteValor
QEasingCurve::OutQuint14

Gráfico de una función OutQuintic

Curva de atenuación para una función quíntica (t^5): desaceleración hasta velocidad cero.

ConstanteValor
QEasingCurve::InOutQuint15

Gráfico de una función InOutQuintic

Curva de atenuación para una función quíntica (t^5): aceleración hasta la mitad del recorrido, seguida de desaceleración.

ConstanteValor
QEasingCurve::OutInQuint16

Gráfico de la función OutInQuintic

Curva de suavizado para una función quíntica (t^5): desaceleración hasta la mitad y, a continuación, aceleración.

ConstanteValor
QEasingCurve::InSine17

Gráfico de una función no sinusoidal

Curva de suavizado para una función sinusoidal (sin(t)): aceleración partiendo de una velocidad nula.

ConstanteValor
QEasingCurve::OutSine18

Gráfico de una función sinusoidal alterada

Curva de atenuación para una función sinusoidal (sin(t)): desacelerando hasta una velocidad nula.

ConstanteValor
QEasingCurve::InOutSine19

Gráfico de una función sinusoidal de entrada y salida

Curva de atenuación para una función sinusoidal (sin(t)): aceleración hasta la mitad del recorrido, seguida de desaceleración.

ConstanteValor
QEasingCurve::OutInSine20

Gráfica de una función sinusoidal OutIn

Curva de atenuación para una función sinusoidal (sin(t)): desaceleración hasta la mitad y, a continuación, aceleración.

ConstanteValor
QEasingCurve::InExpo21

Gráfica de una función inexponencial

Curva de atenuación para una función exponencial (2^t): aceleración partiendo de una velocidad nula.

ConstanteValor
QEasingCurve::OutExpo22

Gráfico de una función exponencial inversa

Curva de atenuación para una función exponencial (2^t): desacelerando hasta una velocidad nula.

ConstanteValor
QEasingCurve::InOutExpo23

Gráfico de una función InOutExponential

Curva de atenuación para una función exponencial (2^t): aceleración hasta la mitad del recorrido, seguida de desaceleración.

ConstanteValor
QEasingCurve::OutInExpo24

Gráfico de una función exponencial OutInExponential

Curva de suavizado para una función exponencial (2^t): desaceleración hasta la mitad y, a continuación, aceleración.

ConstanteValor
QEasingCurve::InCirc25

Gráfico de una función InCircular

Curva de atenuación para una función circular (sqrt(1-t^2)): aceleración partiendo de una velocidad nula.

ConstanteValor
QEasingCurve::OutCirc26

Gráfico de una función «OutCircular»

Curva de atenuación para una función circular (sqrt(1-t^2)): desacelerando hasta una velocidad nula.

ConstanteValor
QEasingCurve::InOutCirc27

Gráfico de la función InOutCircular

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.

ConstanteValor
QEasingCurve::OutInCirc28

Gráfico de la función OutInCircular

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

ConstanteValor
QEasingCurve::InElastic29

Gráfico de una función inelástica

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 ».

ConstanteValor
QEasingCurve::OutElastic30

Gráfico de una función OutElastic

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 ».

ConstanteValor
QEasingCurve::InOutElastic31

Gráfico de una función InOutElastic

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.

ConstanteValor
QEasingCurve::OutInElastic32

Gráfico de una función OutInElastic

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.

ConstanteValor
QEasingCurve::InBack33

Gráfico de una función InBack

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.

ConstanteValor
QEasingCurve::OutBack34

Gráfico de una función OutBack

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.

ConstanteValor
QEasingCurve::InOutBack35

Gráfico de una

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.

ConstanteValor
QEasingCurve::OutInBack36

Gráfico de la función OutInBack

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.

ConstanteValor
QEasingCurve::InBounce37

Gráfico de una función InBounce

Curva de aceleración para un rebote (rebote parabólico con decaimiento exponencial): aceleración partiendo de una velocidad nula.

ConstanteValor
QEasingCurve::OutBounce38

Gráfico de una función OutBounce

Curva de atenuación para una función de rebote (rebote parabólico con decaimiento exponencial): desacelerando desde velocidad cero.

ConstanteValor
QEasingCurve::InOutBounce39

Gráfico de la función InOutBounce

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.

ConstanteValor
QEasingCurve::OutInBounce40

Gráfico de una función OutInBounce

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.

ConstanteValorDescripción
QEasingCurve::BezierSpline45Permite definir una curva de atenuación personalizada utilizando una spline Bézier cúbica
QEasingCurve::TCBSpline46Permite definir una curva de aceleración personalizada utilizando una spline TCB
QEasingCurve::Custom47Se 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.