QGraphicsEffect Class

Member Function Documentation

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

Construit une nouvelle instance de QGraphicsEffect ayant la valeur spécifiée parent.

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

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

QRectF QGraphicsEffect::boundingRect() const

Renvoie le rectangle de délimitation effectif pour cet effet, c'est-à-dire le rectangle de délimitation de la source en coordonnées de l'appareil, ajusté en fonction des marges 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 pour cet effet, compte tenu de l'adresse rect fournie dans les coordonnées de l'appareil. Lorsque vous écrivez votre propre effet personnalisé, vous devez appeler updateBoundingRect() chaque fois qu'un paramètre est modifié et que cette fonction peut renvoyer une valeur différente.

Voir également sourceBoundingRect().

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

Cette fonction virtuelle pure 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 du dessin de l'effet, en utilisant painter.

Par exemple :

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 n'est destinée qu'à des fins de réimplémentation.

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

Dessine la source directement en utilisant la valeur donnée painter.

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

Par exemple :

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

Voir aussi QGraphicsEffect::draw().

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

Ce signal est émis lorsque l'effet est activé ou désactivé. Le paramètre enabled contient le nouvel état activé de l'effet.

Voir également isEnabled().

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

Renvoie le rectangle de délimitation de la source mappée sur le site system.

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

Voir aussi draw().

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

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

Le site flags décrit ce qui a changé.

[protected] bool QGraphicsEffect::sourceIsPixmap() const

Renvoie true si la source est effectivement une pixmap, par exemple QGraphicsPixmapItem.

Cette fonction est utile à des fins d'optimisation. Par exemple, il est inutile de dessiner la source en coordonnées de périphérique pour éviter la mise à l'échelle de la pixmap si cette fonction renvoie true - la pixmap 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 pixmap avec la source peinte à l'intérieur.

Le paramètre system spécifie le système de coordonnées à utiliser pour la source. Le paramètre optionnel offset renvoie le décalage auquel le pixmap doit être peint en utilisant le peintre actuel. Pour contrôler la façon dont la pixmap est remplie, utilisez le paramètre mode.

La pixmap renvoyée est découpée dans le rectangle du peintre actuel lorsque system est Qt::DeviceCoordinates.

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

Voir aussi draw() et boundingRect().

[slot] void QGraphicsEffect::update()

Planifie un nouveau dessin de l'effet. Cette fonction est appelée chaque fois que l'effet doit être redessiné. Cette fonction ne déclenche pas un nouveau dessin de la source.

Voir également updateBoundingRect().

[protected] void QGraphicsEffect::updateBoundingRect()

Cette fonction notifie le cadre de l'effet lorsque le rectangle de délimitation de l'effet a changé. En tant qu'auteur d'un effet personnalisé, vous devez appeler cette fonction chaque fois que vous modifiez des paramètres qui amèneront la fonction virtuelle boundingRectFor() à renvoyer une valeur différente.

Cette fonction appellera update() si nécessaire.

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