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)

カスタムイージングカーブを定義するために、3次ベジエスプラインのセグメントを追加します。 これは、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 はサンプル位置です。これら3つのパラメータはすべて-1から1の範囲で有効であり、制御点の接線を定義します。 3つのパラメータすべてが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 の制御点を持つ3次ベジェ曲線を返します。

3次ベジェ曲線は、4つの制御点 C0、C1、C2、および C3 によって定義されます。C0 と C3 は、それぞれ始点と終点に対応します。 この関数は、始点 C0 が (0, 0) に、終点 C3 が (1, 1) に固定された3次ベジェ曲線を返します。

これは便利なヘルパー関数であり、addCubicBezierSegment(c1, c2,QPointF(1, 1)) を呼び出すのと同じです。より複雑な3次ベジェスプラインを構築する必要がある場合は、代わりに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 をコピー。