【Qt Widgets】QGraphicsItem::setOpacity()でグラフィックスアイテムの透明度を自在に操る

QGraphicsItem::setOpacity()は、Qt Widgetsにおけるグラフィックスアイテムの透明度を設定するためのメソッドです。透明度は0.0（完全に透明）から1.0（完全に不透明）までの範囲で指定できます。

使用方法

item->setOpacity(opacity);

ここで、

• opacity は、設定したい透明度（0.0～1.0）です。
• item は、透明度を設定したいグラフィックスアイテムへのポインタです。

例

次のコードは、QGraphicsPixmapItemの透明度を0.5に設定します。

QGraphicsPixmapItem* pixmapItem = new QGraphicsPixmapItem(QPixmap("image.png"));
scene->addItem(pixmapItem);
pixmapItem->setOpacity(0.5);

注意点

• アイテムの透明度が0.0の場合、アイテムは完全に表示されなくなります。
• アイテムの透明度を変更すると、アイテムが再描画されます。
• アイテムの子アイテムの透明度を設定するには、それぞれ個別にsetOpacity()を呼び出す必要があります。
• QGraphicsItem::setOpacity()は、アイテム自体の透明度のみを設定します。アイテムの子アイテムの透明度には影響しません。

• QGraphicsItem::opacityChanged()シグナルは、アイテムの透明度が変更されたときに発行されます。
• QGraphicsItem::opacity()メソッドを使用して、アイテムの現在の透明度を取得できます。

Qt Widgets以外にも、Qt ChartsやQt Quick Controlsなどの他のQtフレームワークでも、QGraphicsItem::setOpacity()メソッドと同様の機能を提供している場合があります。

---

例1：QGraphicsPixmapItemの透明度を設定する

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QGraphicsPixmapItem>

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

    QGraphicsScene scene;
    QGraphicsView view(&scene);

    QGraphicsPixmapItem* pixmapItem = new QGraphicsPixmapItem(QPixmap("image.png"));
    scene.addItem(pixmapItem);
    pixmapItem->setOpacity(0.5);

    view.resize(400, 300);
    view.show();

    return app.exec();
}

例2：アニメーションを使用してアイテムの透明度を変更する

この例では、QPropertyAnimationを使用して、QGraphicsPixmapItemの透明度を0.0から1.0まで徐々に変化させます。

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QGraphicsPixmapItem>
#include <QPropertyAnimation>

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

    QGraphicsScene scene;
    QGraphicsView view(&scene);

    QGraphicsPixmapItem* pixmapItem = new QGraphicsPixmapItem(QPixmap("image.png"));
    scene.addItem(pixmapItem);

    QPropertyAnimation* animation = new QPropertyAnimation(pixmapItem, "opacity", &app);
    animation->setDuration(2000);
    animation->setStartValue(0.0);
    animation->setEndValue(1.0);
    animation->start();

    view.resize(400, 300);
    view.show();

    return app.exec();
}

---

QGraphicsItem::setOpacity()は、Qt Widgetsにおけるグラフィックスアイテムの透明度を設定するための便利なメソッドですが、状況によっては代替方法の方が適切な場合があります。

代替方法

以下に、QGraphicsItem::setOpacity()の代替方法をいくつか紹介します。

• ブラシのアルファ値を設定する
  
  • アイテムのブラシのアルファ値を設定することで、透明度を制御できます。
  • この方法は、アイテム全体に均一な透明度を適用したい場合に適しています。
  • ブラシのアルファ値を変更すると、アイテムが再描画されます。

item->setBrush(QColor(Qt::red, 255, 128, 128)); // 半透明の赤色

• グラフィック効果を使用する
  
  • QGraphicsOpacityEffectなどのグラフィック効果を使用して、アイテムの透明度を制御できます。
  • この方法は、アイテム全体だけでなく、アイテムの一部のみの透明度を変更したい場合に適しています。
  • グラフィック効果を追加すると、アイテムが再描画されます。

QGraphicsOpacityEffect* effect = new QGraphicsOpacityEffect();
effect->setOpacity(0.5);
item->setGraphicsEffect(effect);

• カスタムペイントイベントハンドラを使用する
  
  • アイテムのpaint()イベントハンドラをオーバーライドすることで、カスタムの描画処理を行い、透明度を制御できます。
  • この方法は、高度な透明度効果を実現したい場合に適していますが、複雑なコードが必要になります。
  • paint()イベントハンドラ内で、アイテムの描画前にpainter->setOpacity()を呼び出すことで、透明度を設定できます。

void QGraphicsPixmapItem::paint(QPainter *painter) {
    painter->setOpacity(0.5);
    painter->drawPixmap(0, 0, pixmap);
}

それぞれの方法の比較

方法	利点	欠点
ブラシのアルファ値を設定する	シンプルでわかりやすい	アイテム全体に均一な透明度しか適用できない
グラフィック効果を使用する	アイテムの一部のみの透明度を変更できる	コードが複雑になる
カスタムペイントイベントハンドラを使用する	高度な透明度効果を実現できる	コードが複雑で、パフォーマンスに影響を与える可能性がある

QGraphicsItem::setOpacity()は、多くの場合において便利な方法ですが、状況によっては代替方法の方が適切な場合があります。それぞれの方法の利点と欠点を理解し、適切な方法を選択することが重要です。