Qt GUIでポリゴンをアニメーションさせる：QPolygonF::translate() とその他のテクニック

Qt GUIにおけるQPolygonF::translate()の詳細解説

関数の概要

void QPolygonF::translate(const QPointF &offset);
void QPolygonF::translate(qreal dx, qreal dy);

引数:

• offset: ポリゴンを移動するオフセットを表す QPointF 型のオブジェクト。
• dx: ポリゴンを水平方向に移動する距離を表す浮動小数点数。

戻り値:

なし

詳細:

• translate() 関数は、ポリゴン内のすべての点を offset だけ移動します。
• dx と dy を使用して、offset を明示的に指定することもできます。
• ポリゴンは、その形状を変えずに移動されます。
• translate() 関数は、ポリゴンを画面上の別の位置に移動したり、アニメーションを作成したりするために使用できます。

使用例

// ポリゴンを (10, 20) だけ移動
QPolygonF polygon;
polygon << QPointF(0, 0) << QPointF(100, 100);
polygon.translate(10, 20);

// ポリゴンを水平方向に 50 だけ移動
polygon.translate(50, 0);

// ポリゴンを垂直方向に -10 だけ移動
polygon.translate(0, -10);

関連関数

• QPolygonF::translated(): ポリゴンを移動した新しいポリゴンを返します。
• QPointF::operator+=() and QPointF::operator-=() : ポリゴン内のすべての点にオフセットを加算または減算します。

補足

• QPolygonF::translate() は、Qt GUIフレームワークの他の関数と組み合わせて使用することができます。
• 例えば、QPainter クラスを使用して、移動したポリゴンを描画することができます。

この解説で理解できない部分や、さらに詳しく知りたい点があれば、遠慮なく質問してください。

Qt GUIにおけるQPolygonF::translate()のサンプルコード

ポリゴンを (10, 20) だけ移動

#include <QPolygonF>
#include <QPointF>

int main() {
  // ポリゴンを作成
  QPolygonF polygon;
  polygon << QPointF(0, 0) << QPointF(100, 100);

  // ポリゴンを (10, 20) だけ移動
  polygon.translate(10, 20);

  // 移動後のポリゴンの頂点を出力
  for (QPointF point : polygon) {
    qDebug() << point;
  }

  return 0;
}

QPointF(10.0, 20.0)
QPointF(110.0, 120.0)

ポリゴンを水平方向に 50 だけ移動

#include <QPolygonF>

int main() {
  // ポリゴンを作成
  QPolygonF polygon;
  polygon << QPointF(0, 0) << QPointF(100, 100);

  // ポリゴンを水平方向に 50 だけ移動
  polygon.translate(50, 0);

  // 移動後のポリゴンの頂点を出力
  for (QPointF point : polygon) {
    qDebug() << point;
  }

  return 0;
}

出力:

QPointF(50.0, 0.0)
QPointF(150.0, 100.0)

ポリゴンを垂直方向に -10 だけ移動

#include <QPolygonF>

int main() {
  // ポリゴンを作成
  QPolygonF polygon;
  polygon << QPointF(0, 0) << QPointF(100, 100);

  // ポリゴンを垂直方向に -10 だけ移動
  polygon.translate(0, -10);

  // 移動後のポリゴンの頂点を出力
  for (QPointF point : polygon) {
    qDebug() << point;
  }

  return 0;
}

出力:

QPointF(0.0, -10.0)
QPointF(100.0, 90.0)

ポリゴンを回転しながら移動

#include <QPolygonF>
#include <QPointF>
#include <QMatrix>

int main() {
  // ポリゴンを作成
  QPolygonF polygon;
  polygon << QPointF(0, 0) << QPointF(100, 100);

  // 回転行列を作成
  QMatrix matrix;
  matrix.rotate(45);

  // ポリゴンを回転しながら移動
  polygon.translate(matrix * QPointF(10, 20));

  // 移動後のポリゴンの頂点を出力
  for (QPointF point : polygon) {
    qDebug() << point;
  }

  return 0;
}

出力:

QPointF(14.1421, 27.0711)
QPointF(114.142, 127.071)

QPainterを使って移動したポリゴンを描画

#include <QPolygonF>
#include <QPainter>
#include <QWidget>

class MyWidget : public QWidget {
 public:
  MyWidget() {
    // ポリゴンを作成
    polygon << QPointF(0, 0) << QPointF(100, 100);
  }

  void paintEvent(QPaintEvent *event) override {
    // QPainterを作成
    QPainter painter(this);

    // ポリゴンを (10, 20) だけ移動
    polygon.translate(10, 20);

    // ポリゴンを描画
    painter.drawPolygon(polygon);
  }

 private:
  QPolygonF polygon;
};

int main() {
  QApplication app(argc, argv);

  MyWidget widget;
  widget.show();

  return app.exec();
}

このコードは、ウィンドウに正方形

Qt GUIにおけるQPolygonF::translate()の代替方法

QPolygonF::operator+=() and QPolygonF::operator-=()

// ポリゴンを (10, 20) だけ移動
QPolygonF polygon;
polygon << QPointF(0, 0) << QPointF(100, 100);
polygon += QPointF(10, 20);

// ポリゴンを水平方向に 50 だけ移動
polygon += QPointF(50, 0);

// ポリゴンを垂直方向に -10 だけ移動
polygon -= QPointF(0, 10);

QMatrix::translate() 関数を使用して、ポリゴンを含むすべての形状を移動することができます。

#include <QPolygonF>
#include <QMatrix>

int main() {
  // ポリゴンを作成
  QPolygonF polygon;
  polygon << QPointF(0, 0) << QPointF(100, 100);

  // 変換行列を作成
  QMatrix matrix;
  matrix.translate(10, 20);

  // ポリゴンを移動
  polygon = matrix.map(polygon);

  // 移動後のポリゴンの頂点を出力
  for (QPointF point : polygon) {
    qDebug() << point;
  }

  return 0;
}

forループを使用して、ポリゴン内のすべての点を個別に移動することができます。

#include <QPolygonF>

int main() {
  // ポリゴンを作成
  QPolygonF polygon;
  polygon << QPointF(0, 0) << QPointF(100, 100);

  // ポリゴン内のすべての点を (10, 20) だけ移動
  for (QPointF &point : polygon) {
    point += QPointF(10, 20);
  }

  // 移動後のポリゴンの頂点を出力
  for (QPointF point : polygon) {
    qDebug() << point;
  }

  return 0;
}

QGraphicsItem::translate() 関数を使用して、QGraphicsScene に追加されたポリゴンを含むすべてのアイテムを移動することができます。

#include <QPolygonF>
#include <QGraphicsScene>
#include <QGraphicsItem>

int main() {
  // ポリゴンを作成
  QPolygonF polygon;
  polygon << QPointF(0, 0) << QPointF(100, 100);

  // シーンを作成
  QGraphicsScene scene;

  // ポリゴンをシーンに追加
  QGraphicsItem *item = scene.addPolygon(polygon);

  // ポリゴンを (10, 20) だけ移動
  item->translate(10, 20);

  // シーンを表示
  QGraphicsView view(&scene);
  view.show();

  return app.exec();
}

これらの方法はすべて、Qt GUIフレームワークでポリゴンを移動するために使用できます。どの方法を選択するかは、特定の要件と好みによって異なります。