QGraphicsEffect Class

メンバ関数ドキュメント

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

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

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

ソースからエフェクトを削除し、Graphical Effectを破棄します。

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 を使用してエフェクトの描画実装を提供します。

例えば

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() からのみ呼び出される。

例えば

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

ソースが効果的にpixmap、例えばQGraphicsPixmapItem である場合、true を返す。

この関数は最適化のために有用です。例えば、この関数がtrue を返す場合、pixmap のスケーリングを避けるためにソースをデバイス座標で描画する意味はありません。

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

ソースが描画された pixmap を返します。

system は、ソースに使用する座標系を指定します。オプションのoffset パラメータは、現在のペインタを使って pixmap を描画するオフセットを返します。pixmap の詰め方を制御するには、mode パラメータを使用します。

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

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

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

[slot] void QGraphicsEffect::update()

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

updateBoundingRect()も参照 。

[protected] void QGraphicsEffect::updateBoundingRect()

この関数は、エフェクトのバウンディングレクタングルが変更されたときに、エフェクトフレームワークに通知します。カスタム・エフェクトの作成者として、仮想boundingRectFor() 関数が異なる値を返す原因となるパラメータを変更するときはいつでも、この関数を呼び出す必要があります。

この関数が必要な場合は、update() を呼び出します。

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