QGraphicsItemAnimation::timeLine() vs QPropertyAnimation：比較と使い分け

Qt WidgetsにおけるQGraphicsItemAnimation::timeLine()の詳細解説

QGraphicsItemAnimation::timeLine()は、Qt Widgetsフレームワークにおけるアニメーション機能の一つで、時間経過に伴ってQGraphicsItemの状態を変化させるための強力なツールです。この関数を使用することで、直感的なコードで複雑なアニメーションを作成することができます。

機能

QGraphicsItemAnimation::timeLine()は以下の機能を提供します:

• 時間経過に伴う属性の変化:
  • 位置、サイズ、回転、不透明度など、様々な属性をアニメーション化できます。
• easing曲線による滑らかな動き:
  • 動きを滑らかにしたり、加速/減速させたりするeasing曲線を適用できます。
• ループ再生:
  • アニメーションを一定回数または無限にループさせることができます。
• シグナル/スロットによる制御:
  • アニメーションの状態変化をシグナル/スロットを使って監視・制御できます。

コード例

以下のコード例は、QGraphicsItemAnimation::timeLine()を使って、円形に移動するQGraphicsItemを作成する方法を示します:

#include <Qt>

class Example : public QGraphicsView {
  QGraphicsScene scene;
  QGraphicsItem *item;
  QGraphicsItemAnimation *animation;

 public:
  Example() {
    setScene(&scene);
    item = new QGraphicsRectItem(0, 0, 100, 100);
    scene.addItem(item);

    // タイムラインを作成
    animation = new QGraphicsItemAnimation(item);

    // アニメーションの開始と終了時間を設定
    animation->setTimeLine(QTimeLine(1000));

    // キーフレームを設定
    animation->setKeyFrame(0, QPointF(0, 0));
    animation->setKeyFrame(0.5, QPointF(50, 50));
    animation->setKeyFrame(1, QPointF(0, 0));

    // イージング曲線を設定
    animation->setEasingCurve(QEasingCurve::InOutQuad);

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

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);
  Example example;
  example.show();
  return app.exec();
}

詳細解説

1. QGraphicsItemAnimationオブジェクトを作成し、アニメーションさせたいQGraphicsItemを渡します。
2. QTimeLineオブジェクトを作成し、アニメーションの長さを設定します。
3. setKeyFrame()を使って、アニメーションの開始点、中間点、終点におけるQGraphicsItemの状態を設定します。
4. setEasingCurve()を使って、アニメーションの動きを制御するeasing曲線を設定します。
5. start()を使ってアニメーションを開始します。

補足

• 上記のコード例は基本的な使い方を示しています。より複雑なアニメーションを作成するには、QGraphicsItemAnimationクラスの他の機能も活用できます。
• Qtには、QPropertyAnimationなど、QGraphicsItemAnimation以外にもアニメーションを作成するためのクラスが用意されています。

QGraphicsItemAnimation::timeLine()について、さらに詳しく知りたい場合は、お気軽に質問してください。

Qt WidgetsにおけるQGraphicsItemAnimation::timeLine()のサンプルコード集

#include <Qt>

class Example : public QGraphicsView {
  QGraphicsScene scene;
  QGraphicsItem *item;
  QGraphicsItemAnimation *animation;

 public:
  Example() {
    setScene(&scene);
    item = new QGraphicsRectItem(0, 0, 100, 100);
    scene.addItem(item);

    // タイムラインを作成
    animation = new QGraphicsItemAnimation(item);

    // アニメーションの開始と終了時間を設定
    animation->setTimeLine(QTimeLine(1000));

    // キーフレームを設定
    animation->setKeyFrame(0, QPointF(0, 0));
    animation->setKeyFrame(0.5, QPointF(50, 50));
    animation->setKeyFrame(1, QPointF(0, 0));

    // イージング曲線を設定
    animation->setEasingCurve(QEasingCurve::InOutQuad);

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

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);
  Example example;
  example.show();
  return app.exec();
}

拡縮アニメーション

#include <Qt>

class Example : public QGraphicsView {
  QGraphicsScene scene;
  QGraphicsItem *item;
  QGraphicsItemAnimation *animation;

 public:
  Example() {
    setScene(&scene);
    item = new QGraphicsRectItem(0, 0, 100, 100);
    scene.addItem(item);

    // タイムラインを作成
    animation = new QGraphicsItemAnimation(item);

    // アニメーションの開始と終了時間を設定
    animation->setTimeLine(QTimeLine(1000));

    // キーフレームを設定
    animation->setKeyFrame(0, QRectF(0, 0, 100, 100));
    animation->setKeyFrame(0.5, QRectF(25, 25, 50, 50));
    animation->setKeyFrame(1, QRectF(0, 0, 100, 100));

    // イージング曲線を設定
    animation->setEasingCurve(QEasingCurve::InOutQuad);

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

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);
  Example example;
  example.show();
  return app.exec();
}

回転アニメーション

#include <Qt>

class Example : public QGraphicsView {
  QGraphicsScene scene;
  QGraphicsItem *item;
  QGraphicsItemAnimation *animation;

 public:
  Example() {
    setScene(&scene);
    item = new QGraphicsRectItem(0, 0, 100, 100);
    scene.addItem(item);

    // タイムラインを作成
    animation = new QGraphicsItemAnimation(item);

    // アニメーションの開始と終了時間を設定
    animation->setTimeLine(QTimeLine(1000));

    // キーフレームを設定
    animation->setKeyFrame(0, 0.0);
    animation->setKeyFrame(0.5, 90.0);
    animation->setKeyFrame(1, 0.0);

    // イージング曲線を設定
    animation->setEasingCurve(QEasingCurve::InOutQuad);

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

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);
  Example example;
  example.show();
  return app.exec();
}

複数のアニメーションを組み合わせる

#include <Qt>

class Example : public QGraphicsView {
  QGraphicsScene scene;
  QGraphicsItem *item;
  QGraphicsItemAnimation *animation1;
  QGraphicsItemAnimation *animation2;

 public:
  Example() {
    setScene(&scene);
    item = new QGraphicsRectItem(0, 0, 100, 100);
    scene.addItem(item);

    // タイムラインを作成
    animation1

Qt WidgetsにおけるQGraphicsItemのアニメーション作成方法

QPropertyAnimationは、QGraphicsItemのプロパティを時間経過に伴って変化させるアニメーションを作成するためのクラスです。QGraphicsItemAnimation::timeLine()よりもシンプルで軽量なアニメーションを作成したい場合に適しています。

コード例

#include <Qt>

class Example : public QGraphicsView {
  QGraphicsScene scene;
  QGraphicsItem *item;
  QPropertyAnimation *animation;

 public:
  Example() {
    setScene(&scene);
    item = new QGraphicsRectItem(0, 0, 100, 100);
    scene.addItem(item);

    // アニメーションを作成
    animation = new QPropertyAnimation(item, "pos");

    // アニメーションの開始と終了時間を設定
    animation->setDuration(1000);

    // キーフレームを設定
    animation->setStartValue(QPointF(0, 0));
    animation->setEndValue(QPointF(50, 50));

    // イージング曲線を設定
    animation->setEasingCurve(QEasingCurve::InOutQuad);

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

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);
  Example example;
  example.show();
  return app.exec();
}

QSequentialAnimationGroupは、複数のアニメーションを順番に実行するためのクラスです。複雑なアニメーションを作成したい場合に適しています。

コード例

#include <Qt>

class Example : public QGraphicsView {
  QGraphicsScene scene;
  QGraphicsItem *item;
  QSequentialAnimationGroup *group;
  QPropertyAnimation *animation1;
  QPropertyAnimation *animation2;

 public:
  Example() {
    setScene(&scene);
    item = new QGraphicsRect