【初心者向け】Qt Widgetsで画像を拡大縮小！ QPinchGestureクラスの使い方を徹底解説

QPinchGestureクラスは、Qt Widgetsライブラリで提供されるタッチジェスチャ認識機能の一つであり、ユーザーが画面上の2つのポイントを同時に触れ、指を近づけたり離したりする「ピンチジェスチャ」を検出します。このジェスチャは、画像の拡大縮小や地図のズームなどの操作によく用いられます。

主な機能

ピンチジェスチャの回転角度を取得する
ピンチジェスチャの中心点を取得する
ピンチジェスチャの拡大縮小倍率を取得する
ピンチジェスチャの開始位置と終了位置を取得する
ピンチジェスチャの開始と終了を検出する

コード例

#include <QtWidgets/QApplication>
#include <QtWidgets/QLabel>
#include <QtGestures/QGesture>
#include <QtGestures/QPinchGesture>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  QLabel label("Qt Widgets QPinchGesture Example");
  label.setFixedSize(200, 200);

  // ピンチジェスチャの検出を有効にする
  label.grabGesture(Qt::PinchGesture);

  // ピンチジェスチャシグナルに接続する
  QObject::connect(&label, &QLabel::gesture, &label, &QLabel::handleGesture);

  label.show();

  return app.exec();
}

void QLabel::handleGesture(QGesture *gesture) {
  if (gesture->state() == QGesture::Started) {
    qDebug() << "Pinch gesture started";
  } else if (gesture->state() == QGesture::Updated) {
    QPinchGesture *pinchGesture = static_cast<QPinchGesture *>(gesture);
    qDebug() << "Scale factor:" << pinchGesture->scaleFactor();
    qDebug() << "Center point:" << pinchGesture->centerPoint();
  } else if (gesture->state() == QGesture::Finished) {
    qDebug() << "Pinch gesture finished";
  }
}

QPinchGestureクラスは、他のジェスチャクラスと組み合わせて使用できます。
QPinchGestureクラスは、マルチタッチスクリーンデバイスでのみ使用できます。
QPinchGestureクラスは、Qt Gesturesモジュールの一部です。Qt Gesturesモジュールを使用するには、Qt Widgetsモジュールに加えてQt Gesturesモジュールをインストールする必要があります。

この解説が、Qt WidgetsにおけるQPinchGestureクラスの理解に役立つことを願っています。

QPinchGestureクラスは、Qt 5.0以降で使用できます。
QPinchGestureクラスは、C++言語で記述されています。

コード例

#include <QtWidgets/QApplication>
#include <QtWidgets/QLabel>
#include <QtWidgets/QGraphicsScene>
#include <QtWidgets/QGraphicsPixmapItem>
#include <QtGestures/QGesture>
#include <QtGestures/QPinchGesture>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  // 画像を表示するQLabelを作成
  QLabel label("Qt Widgets QPinchGesture Example");
  label.setFixedSize(200, 200);

  // 画像を読み込む
  QPixmap pixmap("image.png");

  // 画像をQGraphicsSceneに追加
  QGraphicsScene scene;
  QGraphicsPixmapItem *item = scene.addPixmap(pixmap);

  // QGraphicsViewを作成
  QGraphicsView view(&scene);
  view.setFixedSize(200, 200);
  view.show();

  // ピンチジェスチャの検出を有効にする
  view.grabGesture(Qt::PinchGesture);

  // ピンチジェスチャシグナルに接続する
  QObject::connect(&view, &QGraphicsView::gesture, &view, &QGraphicsView::handleGesture);

  return app.exec();
}

void QGraphicsView::handleGesture(QGesture *gesture) {
  if (gesture->state() == QGesture::Started) {
    qDebug() << "Pinch gesture started";
  } else if (gesture->state() == QGesture::Updated) {
    QPinchGesture *pinchGesture = static_cast<QPinchGesture *>(gesture);
    qreal scaleFactor = pinchGesture->scaleFactor();

    // 画像のスケーリング
    QGraphicsItem *item = scene()->items().at(0);
    item->setScale(item->scale() * scaleFactor);
  } else if (gesture->state() == QGesture::Finished) {
    qDebug() << "Pinch gesture finished";
  }
}

画像ファイルを読み込みます。
画像をQGraphicsSceneに追加します。
QGraphicsViewを作成し、シーンを表示します。
ピンチジェスチャの検出を有効にします。
ピンチジェスチャシグナルに接続し、ジェスチャの開始、更新、終了時に処理を実行します。
ジェスチャの更新時に、画像のスケーリングを行います。

ピンチジェスチャの拡大縮小倍率は、QPinchGesture::scaleFactor()メソッドを使用して取得できます。
画像のスケーリングは、item->setScale()メソッドを使用して行っています。このメソッドは、画像アイテムのスケール係数を設定します。

QPinchGestureクラスは、Qt 5.0以降で使用できます。
QPinchGestureクラスは、C++言語で記述されています。

しかし、QPinchGestureクラスには、以下のようないくつかの制限があります。

他のジェスチャクラスと組み合わせて使用する場合、複雑になる可能性があります。
マルチタッチスクリーンデバイスでのみ使用できます。

これらの制限を克服するために、QPinchGestureクラスの代替方法がいくつかあります。

代替方法

QSimplePinchGestureクラス

QSimplePinchGestureクラスは、QPinchGestureクラスよりもシンプルなAPIを提供するQPinchGestureクラスの派生クラスです。このクラスは、ピンチジェスチャの開始と終了を検出するのみで、拡大縮小倍率や中心点などの詳細な情報を取得することはできません。

QGestureRecognizerクラス

QGestureRecognizerクラスは、ジェスチャ認識の低レベルなAPIを提供するクラスです。このクラスを使用して、QPinchGestureクラスよりも柔軟なピンチジェスチャ認識を実装することができます。

サードパーティライブラリ

Qt以外のライブラリの中には、QPinchGestureクラスよりも高度な機能を提供するピンチジェスチャ認識ライブラリが存在します。

各代替方法の詳細

QSimplePinchGestureクラス

#include <QtWidgets/QApplication>
#include <QtWidgets/QLabel>
#include <QtGestures/QSimplePinchGesture>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  QLabel label("Qt Widgets QSimplePinchGesture Example");
  label.setFixedSize(200, 200);

  // ピンチジェスチャの検出を有効にする
  QSimplePinchGesture gesture(&label);
  gesture.connect(&gesture, &QSimplePinchGesture::stateChanged, &label, &QLabel::handleGesture);

  label.show();

  return app.exec();
}

void QLabel::handleGesture(QSimplePinchGesture::State state) {
  if (state == QSimplePinchGesture::Started) {
    qDebug() << "Pinch gesture started";
  } else if (state == QSimplePinchGesture::Finished) {
    qDebug() << "Pinch gesture finished";
  }
}

QGestureRecognizerクラス

#include <QtWidgets/QApplication>
#include <QtWidgets/QLabel>
#include <QtGestures/QGesture>
#include <QtGestures/QGestureRecognizer>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  QLabel label("Qt Widgets QGestureRecognizer Example");
  label.setFixedSize(200, 200);

  // ピンチジェスチャ認識を作成
  QGestureRecognizer *recognizer = new QGestureRecognizer(&label);
  recognizer->setRecognizers({ QGestureRecognizer::Pinch });

  // ピンチジェスチャシグナルに接続する
  QObject::connect(recognizer, &QGestureRecognizer::gestureRecognized, &label, &QLabel::handleGesture);

  label.show();

  return app.exec();
}

void QLabel::handleGesture(QGesture *gesture) {
  if (gesture->state() == QGesture::Started) {
    qDebug() << "Pinch gesture started";
  } else if (gesture->state() == QGesture::Updated) {
    QPinchGesture *pinchGesture = static_cast<QPinchGesture *>(gesture);
    qDebug() << "Scale factor:" << pinchGesture->scaleFactor();
    qDebug() << "Center point:" << pinchGesture->centerPoint();
  } else if (gesture->state() == QGesture::Finished) {
    qDebug() << "Pinch gesture finished";
  }
}

サードパーティライブラリ

サードパーティライブラリの例としては、以下のものがあります。

これらのライブラリは、QPinchGestureクラスよりも高度な機能を提供する可能性があります。

QPinchGestureクラスの代替方法を選択する際には、以下の点を考慮する必要があります。

ライブラリの機能と制限
開発者のスキル
アプリケーションの要件