QEasingCurve Class

QEasingCurve easing(QEasingCurve::InOutQuad);

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

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

qreal myEasingFunction(qreal progress);

成员函数文档

QEasingCurve::QEasingCurve(QEasingCurve::Type type = Linear)

根据给定的type 生成一条缓动曲线。

QEasingCurve::QEasingCurve(const QEasingCurve &other)

创建other 的副本。

[noexcept] QEasingCurve::QEasingCurve(QEasingCurve &&other)

通过移动构造一个 QEasingCurve 实例，使其指向与other 所指向的相同对象。

[noexcept] QEasingCurve::~QEasingCurve()

析构函数。

void QEasingCurve::addCubicBezierSegment(const QPointF &c1, const QPointF &c2, const QPointF &endPoint)

添加一段三次贝塞尔样条，用于定义自定义缓入/缓出曲线。 仅当type()为QEasingCurve::BezierSpline 时才适用。请注意，该样条曲线默认从(0.0, 0.0)开始，且必须以(1.0, 1.0)结束，方为有效的缓动曲线。c1 和c2 是用于绘制曲线的控制点。endPoint 是曲线的终点。

另请参阅 fromCubicBezier()。

void QEasingCurve::addTCBSegment(const QPointF &nextPoint, qreal t, qreal c, qreal b)

添加一段 TCB 贝塞尔样条来定义自定义缓动曲线。仅当type() 为QEasingCurve::TCBSpline 时才适用。该样条必须明确从 (0.0, 0.0) 开始，并结束于 (1.0, 1.0)，才能构成有效的缓动曲线。 张力参数t 用于调整切线向量的长度。连续性参数c 用于调整切线之间的变化陡峭度。偏移参数b 用于调整切线向量的方向。nextPoint 表示采样位置。这三个参数的有效范围均为 -1 到 1，共同定义控制点的切线。 如果这三个参数均为 0，则生成的样条曲线为 Catmull-Rom 样条曲线。起始点和终点的偏移量始终为 -1 和 1，因为外切线未定义。

qreal QEasingCurve::amplitude() const

返回振幅。此方法并非适用于所有曲线类型，仅适用于反弹曲线和弹性曲线（即由type()QEasingCurve::InBounce 、QEasingCurve::OutBounce 、QEasingCurve::InOutBounce 、QEasingCurve::OutInBounce 、QEasingCurve::InElastic 、QEasingCurve::OutElastic 、QEasingCurve::InOutElastic 或QEasingCurve::OutInElastic 生成的曲线）。

另请参阅 setAmplitude()。

QEasingCurve::EasingFunction QEasingCurve::customType() const

返回自定义缓动曲线的函数指针。如果 `type()` 未返回 `QEasingCurve::Custom`，则该函数将返回 0。

另请参阅 setCustomType()。

[static, since 6.12] QEasingCurve QEasingCurve::fromCubicBezier(QPointF c1, QPointF c2)

返回一条具有指定控制点c1 和c2 的三次贝塞尔曲线。

一条三次贝塞尔曲线由四个控制点定义：C0、C1、C2 和 C3。其中 C0 和 C3 分别对应起始位置和终点位置。 该函数返回一条起始点 C0 固定为 (0, 0)、终点 C3 固定为 (1, 1) 三次贝塞尔曲线。

这是一个便捷辅助函数，相当于调用addCubicBezierSegment(c1, c2,QPointF(1, 1))。如果您需要构建更复杂的三次贝塞尔样条，请改用addCubicBezierSegment()函数。

该函数在 Qt 6.12 中引入。

另请参阅 addCubicBezierSegment()。

qreal QEasingCurve::overshoot() const

返回超调量。此功能并非适用于所有曲线类型。仅当type() 的参数为QEasingCurve::InBack 、QEasingCurve::OutBack 、QEasingCurve::InOutBack 或QEasingCurve::OutInBack 时才适用。

另请参阅 setOvershoot()。

qreal QEasingCurve::period() const

返回周期。此方法不适用于所有曲线类型。仅当type() 的值为QEasingCurve::InElastic 、QEasingCurve::OutElastic 、QEasingCurve::InOutElastic 或QEasingCurve::OutInElastic 时才适用。

另请参阅 setPeriod()。

void QEasingCurve::setAmplitude(qreal amplitude)

将振幅设置为amplitude 。

这将设置弹跳的振幅或弹性“弹簧”效果的振幅。数值越大，振幅越高。

另请参阅 amplitude()。

void QEasingCurve::setCustomType(QEasingCurve::EasingFunction func)

设置由用户在函数func 中定义的自定义缓动曲线。 该函数的签名是 qreal myEasingFunction(qreal progress)，其中progress和返回值被视为在 0 到 1 之间归一化。（在某些情况下，返回值可能超出该范围）调用此函数后，type() 将返回QEasingCurve::Custom 。func 不能是nullptr 。

另请参阅 customType() 和valueForProgress()。

void QEasingCurve::setOvershoot(qreal overshoot)

将超调量设置为overshoot 。

0 表示无超调，默认值 1.70158 会产生 10% 的超调。

另请参阅 overshoot()。

void QEasingCurve::setPeriod(qreal period)

将周期设置为period 。设置较小的周期值会使曲线频率较高；设置较大的周期值则会使曲线频率较低。

另请参阅 period()。

void QEasingCurve::setType(QEasingCurve::Type type)

将缓动曲线的类型设置为“type ”。

另请参阅 type()。

[noexcept] void QEasingCurve::swap(QEasingCurve &other)

将该曲线与other 进行交换。此操作速度极快，且绝不会失败。

QList<QPointF> QEasingCurve::toCubicSpline() const

返回定义自定义缓动曲线的 cubicBezierSpline 对象。如果缓动曲线没有自定义的贝塞尔缓动曲线，则该列表为空。

QEasingCurve::Type QEasingCurve::type() const

返回缓动曲线的类型。

另请参阅 ` setType()`。

qreal QEasingCurve::valueForProgress(qreal progress) const

返回progress 处缓动曲线的有效进度。虽然progress 必须在0到1之间，但返回的有效进度可以超出该范围。例如，QEasingCurve::InBack 在函数开始时会返回负值。

[noexcept] QEasingCurve &QEasingCurve::operator=(QEasingCurve &&other)

将other 通过“移动赋值”操作赋值给此QEasingCurve 实例。

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

复制other 。