QPainter::drawChord() 以外の円弧を描画する方法

Qt GUIにおけるQPainter::drawChord()の解説

関数概要

void QPainter::drawChord(const QRectF &rect, int startAngle, int arcLength);

引数

• rect: 円弧を描画する矩形
• startAngle: 円弧の開始角度 (16進数表記)
• arcLength: 円弧の長さ (16進数表記)

コード例

#include <QtWidgets/QApplication>
#include <QtWidgets/QWidget>
#include <QtWidgets/QPainter>

class MyWidget : public QWidget {
public:
  MyWidget() {
    // ウィジェットのサイズを設定
    setFixedSize(200, 200);
  }

  // ウィジェットの描画イベント
  void paintEvent(QPaintEvent *event) override {
    // QPainterオブジェクトを作成
    QPainter painter(this);

    // 円弧を描画
    painter.drawChord(QRectF(10, 10, 180, 180), 0, 160 * 16);

    // 円弧を描画 (塗りつぶし)
    painter.setBrush(Qt::red);
    painter.drawChord(QRectF(50, 50, 100, 100), 90 * 16, 120 * 16);
  }
};

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

  // MyWidgetオブジェクトを作成して表示
  MyWidget widget;
  widget.show();

  return app.exec();
}

実行結果

QPainter::drawChord() example: [無効な URL を削除しました]

解説

• コード例では、MyWidgetクラスを継承したウィジェットを作成し、paintEvent()イベント内でQPainter::drawChord()を使用して円弧を描画しています。
• 最初のdrawChord()では、開始角度を0、円弧長を160 * 16 (160度)として、塗りつぶさない円弧を描画しています。
• 2番目のdrawChord()では、開始角度を90 * 16 (90度)、円弧長を120 * 16 (120度)として、赤色で塗りつぶした円弧を描画しています。

補足

• QPainter::drawChord()には、他にも様々な引数を指定することができます。詳細はQtドキュメントを参照してください。
• 円弧を描画する前に、QPainter::setPen()やQPainter::setBrush()を使用して、ペンやブラシの設定を変更することができます。

QPainter::drawChord() のサンプルコード

void paintEvent(QPaintEvent *event) {
  QPainter painter(this);

  painter.drawChord(QRectF(10, 10, 180, 180), 0, 160 * 16);
}

塗りつぶされた円弧

void paintEvent(QPaintEvent *event) {
  QPainter painter(this);

  painter.setBrush(Qt::red);
  painter.drawChord(QRectF(50, 50, 100, 100), 90 * 16, 120 * 16);
}

太線で描画

void paintEvent(QPaintEvent *event) {
  QPainter painter(this);

  QPen pen;
  pen.setWidth(5);
  painter.setPen(pen);

  painter.drawChord(QRectF(10, 10, 180, 180), 0, 160 * 16);
}

複数の円弧

void paintEvent(QPaintEvent *event) {
  QPainter painter(this);

  for (int i = 0; i < 10; i++) {
    painter.drawChord(QRectF(10 + i * 20, 10, 180, 180),
                      i * 36 * 16, 160 * 16);
  }
}

グラデーション付きの円弧

void paintEvent(QPaintEvent *event) {
  QPainter painter(this);

  QLinearGradient gradient(0, 0, 100, 100);
  gradient.setColorAt(0, Qt::red);
  gradient.setColorAt(1, Qt::blue);
  painter.setBrush(gradient);

  painter.drawChord(QRectF(50, 50, 100, 100), 90 * 16, 120 * 16);
}

パイチャート

void paintEvent(QPaintEvent *event) {
  QPainter painter(this);

  // データ
  const int data[] = {20, 30, 50};

  // 合計値
  int total = 0;
  for (int i : data) {
    total += i;
  }

  // 開始角度
  int startAngle = 0;

  for (int i = 0; i < 3; i++) {
    int arcLength = (data[i] * 360 * 16) / total;

    painter.setBrush(QColor::fromHsv(255 * i / 3, 255, 255));
    painter.drawChord(QRectF(50, 50, 100, 100), startAngle, arcLength);

    startAngle += arcLength;
  }
}

QPainter::drawChord() 以外の円弧を描画する方法

QPainterPath::arcTo() と QPainter::fillPath() を使用

• QPainterPath::arcTo() を使用して円弧パスを作成
• QPainter::fillPath() を使用してパスを塗りつぶす

void paintEvent(QPaintEvent *event) {
  QPainter painter(this);

  QPainterPath path;
  path.arcTo(QRectF(10, 10, 180, 180), 0, 160 * 16);

  painter.fillPath(path, Qt::red);
}

QGraphicsEllipseItem を使用

• QGraphicsEllipseItem を作成して円弧を描画
• QGraphicsScene にアイテムを追加
• QGraphicsView でシーンを表示

MyWidget::MyWidget() {
  // ウィジェットのサイズを設定
  setFixedSize(200, 200);

  // シーンを作成
  scene = new QGraphicsScene(this);

  // 円弧アイテムを作成
  QGraphicsEllipseItem *item = new QGraphicsEllipseItem(QRectF(10, 10, 180, 180));
  item->setStartAngle(0);
  item->setSpanAngle(160 * 16);
  item->setBrush(Qt::red);

  // シーンにアイテムを追加
  scene->addItem(item);

  // ビューを作成
  view = new QGraphicsView(scene, this);
  view->show();
}

QOpenGLFunctions::drawArc() を使用

• OpenGL を使用して円弧を描画
• QOpenGLWidget を使用して OpenGL コンテキストを作成

MyWidget::MyWidget() {
  // ウィジェットのサイズを設定
  setFixedSize(200, 200);

  // OpenGL コンテキストを作成
  context = new QOpenGLContext(this);
  context->create();

  // OpenGL 関数へのポインタを取得
  functions = context->functions();

  // 円弧を描画
  functions->drawArc(10, 10, 180, 180, 0, 160);
}

これらの方法はそれぞれ、異なる利点と欠点があります。

• QPainter::drawChord() は最もシンプルで使いやすい方法ですが、複雑な形状には対応できません。
• QPainterPath::arcTo() と QPainter::fillPath() は、より複雑な形状に対応できますが、コード量が増えます。
• QGraphicsEllipseItem は、視覚的に複雑な円弧を描画するのに適していますが、他の方法よりもパフォーマンスが低くなる可能性があります。
• QOpenGLFunctions::drawArc() は、最もパフォーマンスの高い方法ですが、OpenGL の知識が必要となります。