Qt Widgetsにおけるアニメーション中のアイテムの垂直方向移動量を取得：QGraphicsItemAnimation::yTranslationAt()を徹底解説

QGraphicsItemAnimation::yTranslationAt()関数は、指定されたステップ値におけるアイテムの垂直方向の移動量を取得するために使用されます。これは、アニメーション中にアイテムがどのように垂直方向に移動するかを判断するのに役立ちます。

構文

qreal QGraphicsItemAnimation::yTranslationAt(qreal step) const

パラメータ

step: アニメーションのステップ値。0.0はアニメーションの開始、1.0はアニメーションの終了を表します。

戻り値

指定されたステップ値におけるアイテムの垂直方向の移動量。

QGraphicsItemAnimation* animation = new QGraphicsItemAnimation;
animation->setTargetItem(item);
animation->setDuration(1000);

// アニメーション中にアイテムを垂直方向に100ピクセル移動させる
animation->setTranslationAt(1.0, 0, 100);

// アニメーションを開始する
animation->start();

// アニメーション中にアイテムの垂直方向の移動量を取得する
for (qreal step = 0.0; step <= 1.0; step += 0.1) {
    qreal yTranslation = animation->yTranslationAt(step);
    // yTranslationを使用してアイテムの位置を更新する
}

アイテムのトータルな変換を取得するには、QGraphicsItemAnimation::transformAt()関数を使用できます。
アイテムの垂直方向の移動量を取得するには、QGraphicsItemAnimation::xTranslationAt()関数も使用できます。
QGraphicsItemAnimation::yTranslationAt()関数は、アニメーションが実行中のみ有効です。アニメーションが停止している場合は、0.0を返します。

アニメーションを効果的に使用することで、ユーザーインターフェースをより魅力的でインタラクティブにすることができます。
上記以外にも、Qt Widgetsにはアニメーションを操作するための様々な機能が用意されています。詳細は、Qt Widgetsのドキュメントを参照してください。

QGraphicsItemAnimation* animation = new QGraphicsItemAnimation;
animation->setTargetItem(item);
animation->setDuration(1000);

// アニメーション中にアイテムを垂直方向に100ピクセル移動させる
animation->setTranslationAt(1.0, 0, 100);

// アニメーションを開始する
animation->start();

例2：アニメーション中にアイテムの垂直方向の移動量を取得する

QGraphicsItemAnimation* animation = new QGraphicsItemAnimation;
animation->setTargetItem(item);
animation->setDuration(1000);

// アニメーション中にアイテムを垂直方向に100ピクセル移動させる
animation->setTranslationAt(1.0, 0, 100);

// アニメーションを開始する
animation->start();

// アニメーション中にアイテムの垂直方向の移動量を取得する
for (qreal step = 0.0; step <= 1.0; step += 0.1) {
    qreal yTranslation = animation->yTranslationAt(step);
    // yTranslationを使用してアイテムの位置を更新する
}

例3：アイテムを波のように垂直方向に移動させる

QGraphicsItemAnimation* animation = new QGraphicsItemAnimation;
animation->setTargetItem(item);
animation->setDuration(2000);

// アイテムを波のように垂直方向に移動させる
for (qreal step = 0.0; step <= 1.0; step += 0.1) {
    qreal yTranslation = 50 * sin(2 * M_PI * step);
    animation->setTranslationAt(step, 0, yTranslation);
}

// アニメーションを開始する
animation->start();

Qt Widgetsには、アニメーションを操作するための様々な機能が用意されています。詳細は、Qt Widgetsのドキュメントを参照してください。
アニメーションを効果的に使用することで、ユーザーインターフェースをより魅力的でインタラクティブにすることができます。

QTransform::mapPointToTarget() を使う

QGraphicsItemAnimation オブジェクトは、QTransform オブジェクトを使用してアイテムを変換します。QTransform::mapPointToTarget() 関数を使用して、特定のステップにおけるアイテムの位置を計算できます。

QGraphicsItemAnimation* animation = new QGraphicsItemAnimation;
animation->setTargetItem(item);
animation->setDuration(1000);

// アニメーション中にアイテムを垂直方向に100ピクセル移動させる
animation->setTranslationAt(1.0, 0, 100);

// アニメーションを開始する
animation->start();

// アニメーション中にアイテムの垂直方向の移動量を取得する
for (qreal step = 0.0; step <= 1.0; step += 0.1) {
    QPointF startPoint(0, 0);
    QPointF targetPoint = animation->targetItem()->transformAt(step).mapPointToTarget(startPoint);
    qreal yTranslation = targetPoint.y() - startPoint.y();
    // yTranslationを使用してアイテムの位置を更新する
}

カスタムアニメーションクラスを作成する

独自のアニメーションクラスを作成することで、QGraphicsItemAnimation::yTranslationAt() 関数よりも柔軟な制御が可能になります。

class MyYTranslationAnimation : public QGraphicsItemAnimation {
public:
    MyYTranslationAnimation(QGraphicsItem* item, qreal duration, qreal startValue, qreal endValue)
        : QGraphicsItemAnimation(item, duration) {
        setStartValue(startValue);
        setEndValue(endValue);
    }

    qreal yTranslationAt(qreal step) const override {
        qreal yTranslation = startValue() + (endValue() - startValue()) * step;
        return yTranslation;
    }

private:
    qreal startValue_;
    qreal endValue_;
};

// ...

MyYTranslationAnimation* animation = new MyYTranslationAnimation(item, 1000, 0, 100);
animation->start();

シグナルとスロットを使用する

QGraphicsItemAnimation オブジェクトは、valueChanged() シグナルを発行します。このシグナルを接続して、アニメーション中のアイテムの位置を更新できます。

QGraphicsItemAnimation* animation = new QGraphicsItemAnimation;
animation->setTargetItem(item);
animation->setDuration(1000);

// アニメーション中にアイテムを垂直方向に100ピクセル移動させる
animation->setTranslationAt(1.0, 0, 100);

// アニメーション中にアイテムの位置を更新する
connect(animation, &QGraphicsItemAnimation::valueChanged, this, [this](qreal value) {
    qreal yTranslation = value * 100;
    // yTranslationを使用してアイテムの位置を更新する
});

// アニメーションを開始する
animation->start();

アニメーション中のアイテムの位置を常に把握する必要がある場合は、シグナルとスロットを使用します。
より柔軟な制御が必要な場合は、QTransform::mapPointToTarget() 関数を使用するか、カスタムアニメーションクラスを作成します。
シンプルなアニメーションの場合は、QGraphicsItemAnimation::yTranslationAt() 関数を使用するのが最も簡単です。