QGraphicsEffect Class

メンバ関数のドキュメント

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

指定されたparent を持つ新しいQGraphicsEffectインスタンスを作成します。

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

対象からエフェクトを解除し、Graphical Effectsを破棄します。

QRectF QGraphicsEffect::boundingRect() const

このエフェクトの有効な境界矩形、すなわち、エフェクト自体によって適用されたマージンによって調整された、デバイス座標系におけるソースの境界矩形を返します。

boundingRectFor() およびupdateBoundingRect()も参照してください 。

[virtual] QRectF QGraphicsEffect::boundingRectFor(const QRectF &rect) const

指定されたrect （デバイス座標系）に基づき、このエフェクトの実効境界矩形を返します。独自のカスタムエフェクトを作成する場合、この関数が異なる値を返す原因となり得るパラメータが変更されるたびに、updateBoundingRect()を呼び出す必要があります。

sourceBoundingRect()も参照してください 。

[pure virtual protected] void QGraphicsEffect::draw(QPainter *painter)

この純粋仮想関数はエフェクトを描画するもので、ソースの描画が必要なたびに呼び出されます。

QGraphicsEffect のサブクラスでこの関数を再実装し、painter を使用してエフェクトの描画実装を提供してください。

例：

void MyGraphicsEffect::draw(QPainter *painter)
{
    //...
    QPoint offset;
    if (sourceIsPixmap()) {
        // No point in drawing in device coordinates (pixmap will be scaled anyways).
        const QPixmap pixmap = sourcePixmap(Qt::LogicalCoordinates, &offset);
        //...
        painter->drawPixmap(offset, pixmap);
    } else {
        // Draw pixmap in device coordinates to avoid pixmap scaling;
        const QPixmap pixmap = sourcePixmap(Qt::DeviceCoordinates, &offset);
        painter->setWorldTransform(QTransform());
        //...
        painter->drawPixmap(offset, pixmap);
    }
    //...
}

この関数は再実装のみを目的としているため、ユーザーが明示的に呼び出してはなりません。

[protected] void QGraphicsEffect::drawSource(QPainter *painter)

指定されたpainter を使用して、ソースを直接描画します。

この関数は、QGraphicsEffect::draw() からのみ呼び出す必要があります。

例：

void MyGraphicsOpacityEffect::draw(QPainter *painter)
{
    // Fully opaque; draw directly without going through a pixmap.
    if (qFuzzyCompare(m_opacity, 1)) {
        drawSource(painter);
        return;
    }
    //...
}

QGraphicsEffect::draw()も参照してください 。

[signal] void QGraphicsEffect::enabledChanged(bool enabled)

このシグナルは、エフェクトが有効または無効にされるたびに発火します。enabled パラメータには、エフェクトの新しい有効状態が格納されます。

関連項目 ：isEnabled()

[protected] QRectF QGraphicsEffect::sourceBoundingRect(Qt::CoordinateSystem system = Qt::LogicalCoordinates) const

指定されたsystem にマッピングされたソースのバウンディング矩形を返します。

QGraphicsEffect::draw() の外でQt::DeviceCoordinates 引数を指定してこの関数を呼び出すと、利用可能なデバイスコンテキストが存在しないため、定義されていない結果が返されます。

draw()も参照してください 。

[virtual protected] void QGraphicsEffect::sourceChanged(QGraphicsEffect::ChangeFlags flags)

この仮想関数は、QGraphicsEffect によって呼び出され、ソースが変更されたことをエフェクトに通知します。エフェクトが何らかのキャッシュを使用している場合、ソースの新しい外観を反映させるためには、このキャッシュをクリアする必要があります。

flags は、何が変更されたかを記述します。

[protected] bool QGraphicsEffect::sourceIsPixmap() const

ソースが実質的にピクマップ（例：QGraphicsPixmapItem ）である場合、true を返します。

この関数は最適化の目的で役立ちます。例えば、この関数が `true ` を返す場合、ピクマップのスケーリングを避けるためにソースをデバイス座標で描画しても意味がありません。ソースのピクマップはいずれにせよスケーリングされるからです。

[protected] QPixmap QGraphicsEffect::sourcePixmap(Qt::CoordinateSystem system = Qt::LogicalCoordinates, QPoint *offset = nullptr, QGraphicsEffect::PixmapPadMode mode = PadToEffectiveBoundingRect) const

ソースが描画されたピクマップを返します。

system は、ソースにどの座標系を使用するかを指定します。オプションのoffset パラメータは、現在のペインターを使用してピクマップを描画する際のオフセットを返します。ピクマップのパディング方法を制御するには、mode パラメータを使用します。

system がQt::DeviceCoordinates の場合、返されるピクマップは現在のペインターのデバイス矩形にクリップされます。

QGraphicsEffect::draw() の範囲外でQt::DeviceCoordinates を指定してこの関数を呼び出すと、利用可能なデバイスコンテキストが存在しないため、予期しない結果となります。

draw() およびboundingRect()も参照してください 。

[slot] void QGraphicsEffect::update()

エフェクトの再描画をスケジュールします。エフェクトの再描画が必要な場合は、いつでもこの関数を呼び出してください。この関数は、ソースの再描画をトリガーすることはありません。

updateBoundingRect()も参照してください 。

[protected] void QGraphicsEffect::updateBoundingRect()

この関数は、エフェクトの境界矩形が変更された際に、エフェクト・フレームワークに通知します。カスタム・エフェクトの作成者は、仮想関数 `boundingRectFor()` が異なる値を返す原因となるパラメータを変更するたびに、この関数を呼び出す必要があります。

この関数は、必要に応じてupdate()を呼び出します。

関連項目： boundingRectFor()、boundingRect()、およびsourceBoundingRect()。