QGraphicsEffect Class

Documentation des fonctions membres

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

Crée une nouvelle instance de `QGraphicsEffect` avec l'parent` spécifié.

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

Supprime l'effet de la source et détruit l'effet graphique.

QRectF QGraphicsEffect::boundingRect() const

Renvoie le rectangle englobant effectif de cet effet, c'est-à-dire le rectangle englobant de la source en coordonnées du périphérique, ajusté en fonction des marges éventuellement appliquées par l'effet lui-même.

Voir également boundingRectFor() et updateBoundingRect().

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

Renvoie le rectangle de délimitation effectif de cet effet, à partir de l'rect fournie dans les coordonnées du périphérique. Lorsque vous écrivez votre propre effet personnalisé, vous devez appeler la fonction updateBoundingRect() chaque fois que des paramètres susceptibles d'entraîner un changement de la valeur renvoyée par cette fonction sont modifiés.

Voir également sourceBoundingRect().

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

Cette fonction purement virtuelle dessine l'effet et est appelée chaque fois que la source doit être dessinée.

Réimplémentez cette fonction dans une sous-classe de ` QGraphicsEffect ` pour fournir l'implémentation de l'affichage de l'effet, en utilisant ` painter`.

Par exemple :

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

Cette fonction ne doit pas être appelée explicitement par l'utilisateur, car elle est destinée uniquement à être réimplémentée.

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

Affiche directement la source à l'aide de l'painter fournie.

Cette fonction ne doit être appelée qu'à partir de ` QGraphicsEffect::draw()` ().

Par exemple :

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

Voir également QGraphicsEffect::draw().

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

Ce signal est émis chaque fois que l'effet est activé ou désactivé. Le paramètre « enabled » indique le nouvel état d'activation de l'effet.

Voir également isEnabled().

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

Renvoie le rectangle englobant de la source mise en correspondance avec l'system donné.

L'appel de cette fonction avec ` Qt::DeviceCoordinates ` en dehors de ` QGraphicsEffect::draw()` donnera des résultats indéfinis, car aucun contexte de périphérique n'est disponible.

Voir également draw().

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

Cette fonction virtuelle est appelée par ` QGraphicsEffect ` pour signaler que la source a changé. Si l'effet utilise un cache, celui-ci doit être vidé afin de refléter la nouvelle apparence de la source.

L'flags décrit ce qui a changé.

[protected] bool QGraphicsEffect::sourceIsPixmap() const

Renvoie « true » si la source est effectivement une image bitmap, par exemple un QGraphicsPixmapItem.

Cette fonction est utile à des fins d’optimisation. Par exemple, il est inutile de dessiner la source en coordonnées du périphérique pour éviter la mise à l’échelle de la carte de pixels si cette fonction renvoie « true » : la carte de pixels source sera de toute façon mise à l’échelle.

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

Renvoie une image pixmap sur laquelle la source a été dessinée.

L'system spécifie le système de coordonnées à utiliser pour la source. Le paramètre facultatif offset renvoie le décalage à l'endroit où la carte de pixels doit être dessinée à l'aide du peintre actuel. Pour contrôler la manière dont la carte de pixels est complétée, utilisez le paramètre mode.

La carte de pixels renvoyée est découpée selon le rectangle de périphérique du peintre actuel lorsque system vaut Qt::DeviceCoordinates.

L'appel de cette fonction avec ` Qt::DeviceCoordinates ` en dehors de ` QGraphicsEffect::draw()` donnera des résultats indéfinis, car aucun contexte de périphérique n'est disponible.

Voir également draw() et boundingRect().

[slot] void QGraphicsEffect::update()

Planifie un rafraîchissement de l'effet. Appelez cette fonction chaque fois que l'effet doit être rafraîchi. Cette fonction ne déclenche pas de rafraîchissement de la source.

Voir également updateBoundingRect().

[protected] void QGraphicsEffect::updateBoundingRect()

Cette fonction informe le framework d'effets lorsque le rectangle de délimitation de l'effet a changé. En tant qu'auteur d'effets personnalisés, vous devez appeler cette fonction chaque fois que vous modifiez des paramètres susceptibles d'entraîner un changement de la valeur renvoyée par la fonction virtuelle boundingRectFor().

Cette fonction appellera update() si cela s’avère nécessaire.

Voir également boundingRectFor(), boundingRect() et sourceBoundingRect().