Qt WidgetsにおけるQPinchGesture::lastCenterPoint解説

Qt WidgetsにおけるQPinchGesture::lastCenterPoint解説

QPinchGesture::lastCenterPointは、Qt WidgetsフレームワークにおけるクラスQPinchGestureのメンバー関数であり、前回のピンチジェスチャーの中心点を取得します。ピンチジェスチャーとは、2本の指で画面を拡大・縮小したり、回転させたりする操作です。

// QPinchGestureオブジェクトの生成
QPinchGesture gesture(this);

// ジェスチャーの開始を検知
void onPinchGestureStarted(QPinchGesture *gesture) {
  // 最初のピンチ中心点を取得
  QPointF startCenterPoint = gesture->centerPoint();
}

// ジェスチャーの更新を検知
void onPinchGestureUpdated(QPinchGesture *gesture) {
  // 前回のピンチ中心点を取得
  QPointF lastCenterPoint = gesture->lastCenterPoint();

  // 現在のピンチ中心点と前回のピンチ中心点の差を計算
  QPointF delta = lastCenterPoint - gesture->centerPoint();

  // ... 処理 ...
}

詳細

• QPinchGesture::lastCenterPointは、QPointF型の値を返します。QPointFは、2次元空間における点の位置を表す構造体です。
• lastCenterPointは、ジェスチャーの更新イベントが発生した時点における中心点座標を取得します。
• 最初のピンチジェスチャー開始時の中心点座標を取得するには、QPinchGesture::centerPointを使用します。
• QPinchGestureクラスは、以下の情報も提供します。
  • scaleFactor: 現在のスケールファクター
  • rotationAngle: 現在の回転角度
  • changeFlags: ジェスチャーの状態変化フラグ

補足

• QPinchGestureクラスは、Qt Widgetsモジュールの一部です。
• Qt Widgetsモジュールを使用するには、Qtアプリケーションを構築する際にQt5Widgetsモジュールをリンクする必要があります。

• 上記のサンプルコードは、基本的な使い方を示すものです。実際のアプリケーションでは、必要に応じてコードを変更する必要があります。

QPinchGesture::lastCenterPointを使ったサンプルコード

class ImageWidget : public QWidget {
  Q_OBJECT

public:
  ImageWidget(QWidget *parent = nullptr) : QWidget(parent) {
    // 画像をウィジェットに設定
    m_image = QImage("image.png");
    setFixedSize(m_image.size());

    // QPinchGestureオブジェクトの生成
    m_pinchGesture = new QPinchGesture(this);

    // ジェスチャーの開始を検知
    connect(m_pinchGesture, &QPinchGesture::started, [this](QPinchGesture *gesture) {
      m_startScaleFactor = gesture->scaleFactor();
    });

    // ジェスチャーの更新を検知
    connect(m_pinchGesture, &QPinchGesture::updated, [this](QPinchGesture *gesture) {
      // スケールファクターを計算
      qreal scaleFactor = m_startScaleFactor * gesture->scaleFactor();

      // 画像を拡大・縮小
      m_image = m_image.scaled(m_image.size() * scaleFactor);

      // ウィジェットを更新
      update();
    });
  }

protected:
  void paintEvent(QPaintEvent *event) override {
    QPainter painter(this);
    painter.drawImage(QPoint(0, 0), m_image);
  }

private:
  QImage m_image;
  QPinchGesture *m_pinchGesture;
  qreal m_startScaleFactor;
};

キャンバスの回転

class CanvasWidget : public QWidget {
  Q_OBJECT

public:
  CanvasWidget(QWidget *parent = nullptr) : QWidget(parent) {
    // キャンバスの初期化
    m_canvas = QPixmap(QSize(400, 400));
    m_canvas.fill(Qt::white);

    // QPinchGestureオブジェクトの生成
    m_pinchGesture = new QPinchGesture(this);

    // ジェスチャーの開始を検知
    connect(m_pinchGesture, &QPinchGesture::started, [this](QPinchGesture *gesture) {
      m_startRotationAngle = gesture->rotationAngle();
    });

    // ジェスチャーの更新を検知
    connect(m_pinchGesture, &QPinchGesture::updated, [this](QPinchGesture *gesture) {
      // 回転角度を計算
      qreal rotationAngle = m_startRotationAngle + gesture->rotationAngle();

      // キャンバスを回転
      QPainter painter(&m_canvas);
      painter.translate(m_canvas.width() / 2, m_canvas.height() / 2);
      painter.rotate(rotationAngle);
      painter.drawRect(-m_canvas.width() / 2, -m_canvas.height() / 2, m_canvas.width(), m_canvas.height());

      // ウィジェットを更新
      update();
    });
  }

protected:
  void paintEvent(QPaintEvent *event) override {
    QPainter painter(this);
    painter.drawPixmap(QPoint(0, 0), m_canvas);
  }

private:
  QPixmap m_canvas;
  QPinchGesture *m_pinchGesture;
  qreal m_startRotationAngle;
};

画像の回転と拡大・縮小

class ImageTransformWidget : public QWidget {
  Q_OBJECT

public:
  ImageTransformWidget(QWidget *parent = nullptr) : QWidget(parent) {
    // 画像をウィジェットに設定
    m_image = QImage("image.png");
    setFixedSize(m_image.size());

    // QPinchGestureオブジェクトの生成
    m_pinchGesture = new QPinchGesture(this);

    // ジェスチャーの開始を検知
    connect(m_pinchGesture, &QPinchGesture::started, [this](QPinchGesture *gesture) {
      m_startScaleFactor = gesture->scaleFactor();
      m_startRotationAngle = gesture->rotationAngle();
    });

    // ジェスチャーの更新を検知
    connect(m_pinchGesture, &QPinchGesture::updated, [this](QPinchGesture *gesture) {
      // スケールファクターと回転角度を計算
      qreal scaleFactor = m_startScaleFactor * gesture->scaleFactor();
      qreal rotation

QPinchGesture::lastCenterPoint は、ドラッグ操作による画像の移動にも使用できます。

class ImageWidget : public QWidget {
  Q_OBJECT

public:
  ImageWidget(QWidget *parent = nullptr) : QWidget(parent) {
    // 画像をウィジェットに設定
    m_image = QImage("image.png");
    setFixedSize(m_image.size());

    // QPinchGestureオブジェクトの生成
    m_pinchGesture = new QPinchGesture(this);

    // ジェスチャーの開始を検知
    connect(m_pinchGesture, &QPinchGesture::started, [this](QPinchGesture *gesture) {
      m_startPoint = gesture->centerPoint();
    });

    // ジェスチャーの更新を検知
    connect(m_pinchGesture, &QPinchGesture::updated, [this](QPinchGesture *gesture) {
      // ドラッグによる移動量を計算
      QPointF delta = gesture->lastCenterPoint() - m_startPoint;

      // 画像を移動
      m_image = m_image.translated(delta.x(), delta.y());

      // ウィジェットを更新
      update();
    });
  }

protected:
  void paintEvent(QPaintEvent *event) override {
    QPainter painter(this);
    painter.drawImage(QPoint(0, 0), m_image);
  }

private:
  QImage m_image;
  QPinchGesture *m_pinchGesture;
  QPointF m_startPoint;
};

マルチタッチによるズームと回転

QPinchGesture は、複数の指を使って同時に操作することで、より複雑な操作を実現できます。

class MultiTouchWidget : public QWidget {
  Q_OBJECT

public:
  MultiTouchWidget(QWidget *parent = nullptr) : QWidget(parent) {
    // QPinchGestureオブジェクトの生成
    m_pinchGesture = new QPinchGesture(this);

    // ジェスチャーの更新を検知
    connect(m_pinchGesture, &QPinchGesture::updated, [this](QPinchGesture *gesture) {
      // 2本の指で操作している場合
      if (gesture->state() == QPinchGesture::PinchGestureInProgress && gesture->totalFingers() == 2) {
        // スケールファクターと回転角度を計算
        qreal scaleFactor = gesture->totalScaleFactor();
        qreal rotationAngle = gesture->totalRotationAngle();

        // ... 処理 ...
      }
    });
  }
};

ジェスチャーの状態に応じた処理

QPinchGesture::changeFlags() を使用して、ジェスチャーの状態変化を取得できます。

class GestureStateWidget : public QWidget {
  Q_OBJECT

public:
  GestureStateWidget(QWidget *parent = nullptr) : QWidget(parent) {
    // QPinchGestureオブジェクトの生成
    m_pinchGesture = new QPinchGesture(this);

    // ジェスチャーの更新を検知
    connect(m_pinchGesture, &QPinchGesture::updated, [this](QPinchGesture *gesture) {
      // スケール変化フラグを取得
      if (gesture->changeFlags() & QPinchGesture::ScaleFactorChanged) {
        // ... スケール変化処理 ...
      }

      // 回転変化フラグを取得
      if (gesture->changeFlags() & QPinchGesture::RotationAngleChanged) {
        // ... 回転変化処理 ...
      }
    });
  }
};

QGraphicsView との連携

QPinchGesture は、QGraphicsView クラスと組み合わせて、グラフィックスシーンの拡大・縮小や回転にも使用できます。

class GraphicsView : public QGraphicsView {
  Q_OBJECT

public:
  GraphicsView(QWidget *parent = nullptr) : QGraphicsView(parent) {
    // QPinchGestureオブジェクトの生成
    m_pinchGesture = new QPinchGesture(this);

    // ジェスチャーの更新を検知
    connect(m_pinchGesture, &QPinchGesture::updated, [this](QPinchGesture *gesture) {
      // スケールファクターと回転角度を