QGraphicsEffect Class

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

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

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

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

ソースから効果を削除し、グラフィックス効果を破棄します。

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)

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

エフェクトの描画実装を提供するために、painter を使用して、QGraphicsEffect サブクラスでこの関数を再実装します。

例えば

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 である場合はtrue を返します（例:QGraphicsPixmapItem ）。

この関数は、最適化の目的に役立ちます。例えば、この関数が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()も参照してください 。