QRadialGradient::setCenterRadius() 関数の詳細解説

Qt GUIにおけるQRadialGradient::setCenterRadius()の解説

概要

• クラス: QRadialGradient
• 関数: setCenterRadius()
• 役割: 放射状グラデーションの中心点からの半径を設定
• 引数:
• 戻り値: なし

詳細解説

QRadialGradientは、中心点から放射状に広がるグラデーションを生成するクラスです。setCenterRadius()関数は、このグラデーションの中心点からの半径を設定します。半径の値は、グラデーションの拡散範囲に影響を与えます。

例

// 中心点座標と半径を設定
QRadialGradient gradient(QPointF(50, 50), 100);

// グラデーションの色を設定
gradient.setColorAt(0, Qt::red);
gradient.setColorAt(1, Qt::blue);

// グラデーションを適用する
QPainter painter;
painter.setBrush(gradient);
painter.drawRect(QRect(0, 0, 100, 100));

この例では、中心点座標(50, 50)と半径100の放射状グラデーションを作成し、赤から青へのグラデーションを適用しています。

補足

• setCenterRadius()関数は、グラデーション生成後に呼び出すこともできます。
• グラデーションの中心点は、QRadialGradient::setCenter()関数で設定できます。

QRadialGradient::setCenterRadius()を使用したサンプルコード

円形のグラデーション

QRadialGradient gradient(QPointF(50, 50), 100);
gradient.setColorAt(0, Qt::red);
gradient.setColorAt(1, Qt::blue);

QPainter painter;
painter.setBrush(gradient);
painter.drawEllipse(QPoint(50, 50), 50, 50);

楕円形のグラデーション

QRadialGradient gradient(QPointF(50, 50), 100, 50);
gradient.setColorAt(0, Qt::red);
gradient.setColorAt(1, Qt::blue);

QPainter painter;
painter.setBrush(gradient);
painter.drawEllipse(QPoint(50, 50), 50, 25);

このコードは、中心点(50, 50)と半径100, 50の楕円形グラデーションを作成し、赤から青へのグラデーションを描画します。

矩形形のグラデーション

QRadialGradient gradient(QPointF(50, 50), 100);
gradient.setColorAt(0, Qt::red);
gradient.setColorAt(1, Qt::blue);

QPainter painter;
painter.setBrush(gradient);
painter.drawRect(QRect(25, 25, 100, 50));

このコードは、中心点(50, 50)と半径100の矩形形グラデーションを作成し、赤から青へのグラデーションを描画します。

線形グラデーションとの組み合わせ

QRadialGradient gradient(QPointF(50, 50), 100);
gradient.setColorAt(0, Qt::red);
gradient.setColorAt(1, Qt::blue);

QLinearGradient linearGradient(QPoint(0, 0), QPoint(100, 100));
linearGradient.setColorAt(0, Qt::green);
linearGradient.setColorAt(1, Qt::yellow);

QPainter painter;
painter.setBrush(gradient);
painter.drawRect(QRect(25, 25, 100, 50));

painter.setBrush(linearGradient);
painter.drawRect(QRect(125, 25, 100, 50));

このコードは、中心点(50, 50)と半径100の放射状グラデーションと、緑から黄色への線形グラデーションをそれぞれ描画します。

グラデーションの拡散

QRadialGradient gradient(QPointF(50, 50), 100);
gradient.setColorAt(0, Qt::red);
gradient.setColorAt(1, Qt::blue);

gradient.setSpread(QGradient::Spread);

QPainter painter;
painter.setBrush(gradient);
painter.drawRect(QRect(25, 25, 100, 50));

このコードは、中心点(50, 50)と半径100の放射状グラデーションを作成し、拡散効果を適用して描画します。

上記のサンプルコードは基本的な使い方を示していますが、様々なパラメータを設定することで、様々なグラデーション表現を

QRadialGradient::setCenterRadius() 以外の方法

QRadialGradient::setFocalPoint()

QRadialGradient::setFocalPoint() 関数は、グラデーションの焦点点を設定します。焦点点は、グラデーションの中心点と一致している必要はありません。焦点点から中心点までの距離が、グラデーションの拡散範囲に影響を与えます。

QRadialGradient gradient(QPointF(50, 50), 100);
gradient.setColorAt(0, Qt::red);
gradient.setColorAt(1, Qt::blue);

// 焦点点を設定
gradient.setFocalPoint(QPointF(75, 75));

QPainter painter;
painter.setBrush(gradient);
painter.drawRect(QRect(25, 25, 100, 50));

このコードは、中心点(50, 50)と半径100, 焦点点(75, 75)の放射状グラデーションを作成し、赤から青へのグラデーションを描画します。

QRadialGradient::setRadius()

QRadialGradient::setRadius() 関数は、グラデーションの半径を設定します。この関数は、setCenterRadius() と同じ機能を提供しますが、引数が異なる点が注意が必要です。

QRadialGradient gradient(QPointF(50, 50));
gradient.setColorAt(0, Qt::red);
gradient.setColorAt(1, Qt::blue);

// 半径を設定
gradient.setRadius(100);

QPainter painter;
painter.setBrush(gradient);
painter.drawRect(QRect(25, 25, 100, 50));

このコードは、中心点(50, 50)と半径100の放射状グラデーションを作成し、赤から青へのグラデーションを描画します。

上記の方法以外にも、以下の方法で放射状グラデーションの中心点からの半径を設定することができます。

• QGradient::setStops() 関数を使って、グラデーションの色と位置を個別に設定
• QGradient::setCoordinateMode() 関数を使って、グラデーション座標系を設定