QPainter::setCompositionMode() 完全ガイド

Qt GUI の QPainter::setCompositionMode() 解説

QPainter::setCompositionMode() は、Qt GUI で描画する際の合成モードを設定する関数です。合成モードは、複数の画像や図形を重ねた時の表示方法を決定します。この関数は、さまざまな視覚効果を作成するために使用できます。

使い方

QPainter::setCompositionMode() は、以下の形式で呼び出します。

painter->setCompositionMode(compositionMode);

ここで、

• painter は、描画対象となる QPainter オブジェクトです。
• compositionMode は、合成モードを表す QPainter::CompositionMode 型の値です。

合成モードの種類

QPainter::CompositionMode 型には、以下の合成モードが定義されています。

• CompositionMode_SourceOver: ソース画像を前面に、ターゲット画像を背面に表示します。これはデフォルトの合成モードです。
• CompositionMode_DestinationOver: ターゲット画像を前面に、ソース画像を背面に表示します。
• CompositionMode_Clear: ターゲット画像をクリアします。
• CompositionMode_Source: ソース画像のみを表示します。
• CompositionMode_Destination: ターゲット画像のみを表示します。
• CompositionMode_SourceIn: ソース画像とターゲット画像の共通部分のみを表示します。
• CompositionMode_DestinationIn: ターゲット画像とソース画像の共通部分のみを表示します。
• CompositionMode_SourceAtop: ソース画像とターゲット画像の共通部分を重ねて表示します。ソース画像が前面に表示されます。
• CompositionMode_DestinationAtop: ターゲット画像とソース画像の共通部分を重ねて表示します。ターゲット画像が前面に表示されます。
• CompositionMode_Xor: ソース画像とターゲット画像のXOR演算の結果を表示します。

例

以下のコードは、2つの矩形を重ねて表示する例です。1つ目の矩形は青色で、2つ目の矩形は赤色です。合成モードを CompositionMode_SourceAtop に設定することで、2つの矩形の共通部分のみが青色で表示されます。

QPainter painter(this);

painter.setBrush(Qt::blue);
painter.drawRect(0, 0, 100, 100);

painter.setBrush(Qt::red);
painter.setCompositionMode(QPainter::CompositionMode_SourceAtop);
painter.drawRect(50, 50, 100, 100);

補足

• Qt GUI で描画を行うには、QPainter クラスを使用する必要があります。
• QPainter::setCompositionMode() は、QPainter オブジェクトの描画状態を変更します。
• 合成モードは、さまざまな視覚効果を作成するために使用できます。

Qt GUI の QPainter::setCompositionMode() サンプルコード

QPainter painter(this);

// 青色の矩形を描画
painter.setBrush(Qt::blue);
painter.drawRect(0, 0, 100, 100);

// 赤色の矩形を描画
painter.setBrush(Qt::red);
painter.setCompositionMode(QPainter::CompositionMode_SourceAtop);
painter.drawRect(50, 50, 100, 100);

画像を重ねて表示する

QPainter painter(this);

// 画像を読み込む
QImage image1("image1.png");
QImage image2("image2.png");

// 画像1を描画
painter.drawImage(0, 0, image1);

// 画像2を描画
painter.setCompositionMode(QPainter::CompositionMode_SourceAtop);
painter.drawImage(50, 50, image2);

円形にマスクして表示する

QPainter painter(this);

// 円形のマスクを作成
QRegion region(QRect(0, 0, 100, 100), QRegion::Ellipse);

// マスクを設定
painter.setClipRegion(region);

// 画像を描画
painter.drawImage(0, 0, image);

テキストを重ねて表示する

QPainter painter(this);

// テキストを描画
painter.setPen(Qt::black);
painter.drawText(0, 0, "Hello, world!");

// 半透明の矩形を描画
painter.setBrush(QColor(0, 0, 0, 128));
painter.setCompositionMode(QPainter::CompositionMode_SourceOver);
painter.drawRect(0, 0, 100, 100);

グラデーションを重ねて表示する

QPainter painter(this);

// グラデーションを作成
QLinearGradient gradient(0, 0, 100, 100);
gradient.setColorAt(0, Qt::red);
gradient.setColorAt(1, Qt::blue);

// グラデーションを描画
painter.setBrush(gradient);
painter.drawRect(0, 0, 100, 100);

// 半透明の矩形を描画
painter.setBrush(QColor(0, 0, 0, 128));
painter.setCompositionMode(QPainter::CompositionMode_SourceOver);
painter.drawRect(0, 0, 100, 100);

これらのサンプルコードは、QPainter::setCompositionMode() 関数を使用してさまざまな視覚効果を作成する方法を示しています。

QPainter::setCompositionMode() 以外の方法

QGraphicsItem::setCompositionMode()

QGraphicsItem クラスには、setCompositionMode() メソッドがあります。このメソッドを使用すると、個々のグラフィックアイテムの合成モードを設定できます。

QGraphicsItem *item = new QGraphicsItem();
item->setCompositionMode(QPainter::CompositionMode_SourceAtop);

QGraphicsEffect::setCompositionMode()

QGraphicsEffect クラスには、setCompositionMode() メソッドがあります。このメソッドを使用すると、グラフィック効果の合成モードを設定できます。

QGraphicsEffect *effect = new QGraphicsBlurEffect();
effect->setCompositionMode(QPainter::CompositionMode_SourceAtop);

QShader::setCompositionMode()

QShader クラスには、setCompositionMode() メソッドがあります。このメソッドを使用すると、シェーダーの合成モードを設定できます。

QShader *shader = new QLinearGradientShader();
shader->setCompositionMode(QPainter::CompositionMode_SourceAtop);

これらの方法は、QPainter::setCompositionMode() よりも柔軟性がありますが、より複雑でもあります。