QGraphicsEffect Class

Dokumentation der Mitgliedsfunktionen

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

Erstellt eine neue Instanz von `QGraphicsEffect` mit dem angegebenen ` parent`.

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

Entfernt den Effekt aus der Quelle und löscht den Grafikeffekt.

QRectF QGraphicsEffect::boundingRect() const

Gibt das effektive Begrenzungsrechteck für diesen Effekt zurück, d. h. das Begrenzungsrechteck der Quelle in Gerätekoordinaten, angepasst um etwaige vom Effekt selbst angewendete Ränder.

Siehe auch boundingRectFor() und updateBoundingRect().

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

Gibt das effektive Begrenzungsrechteck für diesen Effekt zurück, basierend auf dem übergebenen „ rect “ in den Gerätekordinaten. Wenn Sie einen eigenen benutzerdefinierten Effekt erstellen, müssen Sie die Funktion „ updateBoundingRect()“ aufrufen, sobald Parameter geändert werden, die dazu führen könnten, dass diese Funktion einen anderen Wert zurückgibt.

Siehe auch ` sourceBoundingRect()`.

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

Diese rein virtuelle Funktion zeichnet den Effekt und wird immer dann aufgerufen, wenn die Quelle gezeichnet werden muss.

Implementieren Sie diese Funktion in einer Unterklasse von ` QGraphicsEffect ` neu, um die Zeichnungsimplementierung des Effekts bereitzustellen, und verwenden Sie dabei ` painter`.

Beispiel:

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);
    }
    //...
}

Diese Funktion sollte vom Benutzer nicht explizit aufgerufen werden, da sie ausschließlich zur Neuimplementierung vorgesehen ist.

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

Zeichnet die Quelle direkt unter Verwendung des angegebenen ` painter`.

Diese Funktion sollte nur von ` QGraphicsEffect::draw()` aus aufgerufen werden.

Beispiel:

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

Siehe auch ` QGraphicsEffect::draw()`.

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

Dieses Signal wird immer dann ausgelöst, wenn der Effekt aktiviert oder deaktiviert wird. Der Parameter „ enabled “ enthält den neuen Aktivierungsstatus des Effekts.

Siehe auch „ isEnabled()“.

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

Gibt das Begrenzungsrechteck der Quelle zurück, die auf die angegebene ` system` abgebildet wurde.

Der Aufruf dieser Funktion mit ` Qt::DeviceCoordinates ` außerhalb von ` QGraphicsEffect::draw()` führt zu undefinierten Ergebnissen, da kein Gerätekontext verfügbar ist.

Siehe auch ` draw()`.

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

Diese virtuelle Funktion wird von ` QGraphicsEffect ` aufgerufen, um dem Effekt mitzuteilen, dass sich die Quelle geändert hat. Wenn der Effekt einen Cache verwendet, muss dieser Cache geleert werden, damit die neue Darstellung der Quelle berücksichtigt wird.

Der ` flags ` beschreibt, was sich geändert hat.

[protected] bool QGraphicsEffect::sourceIsPixmap() const

Gibt „ true “ zurück, wenn die Quelle tatsächlich eine Pixmap ist, z. B. eine „ QGraphicsPixmapItem “.

Diese Funktion ist für Optimierungszwecke nützlich. Es macht beispielsweise keinen Sinn, die Quelle in Gerätekoodinaten zu zeichnen, um eine Skalierung der Pixmap zu vermeiden, wenn diese Funktion „ true “ zurückgibt – die Quell-Pixmap wird ohnehin skaliert.

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

Gibt eine Pixmap zurück, in die die Quelle eingezeichnet wurde.

Der Parameter „ system “ legt fest, welches Koordinatensystem für die Quelle verwendet werden soll. Der optionale Parameter „ offset “ gibt den Versatz zurück, an dem die Pixmap mit dem aktuellen Painter gezeichnet werden soll. Um zu steuern, wie die Pixmap aufgefüllt wird, verwenden Sie den Parameter „ mode “.

Die zurückgegebene Pixmap wird auf das Geräte-Rechteck des aktuellen Painters zugeschnitten, wenn system den Wert Qt::DeviceCoordinates hat.

Der Aufruf dieser Funktion mit ` Qt::DeviceCoordinates ` außerhalb von ` QGraphicsEffect::draw()` führt zu undefinierten Ergebnissen, da kein Gerätekontext verfügbar ist.

Siehe auch ` draw()` und ` boundingRect()`.

[slot] void QGraphicsEffect::update()

Plant eine Neuzeichnung des Effekts. Rufen Sie diese Funktion immer dann auf, wenn der Effekt neu gezeichnet werden muss. Diese Funktion löst keine Neuzeichnung der Quelle aus.

Siehe auch „ updateBoundingRect()“.

[protected] void QGraphicsEffect::updateBoundingRect()

Diese Funktion benachrichtigt das Effekt-Framework, wenn sich das Begrenzungsrechteck des Effekts geändert hat. Als Autor eines benutzerdefinierten Effekts müssen Sie diese Funktion immer dann aufrufen, wenn Sie Parameter ändern, die dazu führen, dass die virtuelle Funktion ` boundingRectFor()` einen anderen Wert zurückgibt.

Diese Funktion ruft bei Bedarf ` update()` auf.

Siehe auch ` boundingRectFor()`, ` boundingRect()` und ` sourceBoundingRect()`.