Sur cette page

FastBlur QML Type

Applique un effet de flou rapide à un ou plusieurs éléments source. En savoir plus...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Propriétés

Description détaillée

Remarque : le composant « MultiEffect » offre un effet de flou présentant certains avantages en termes de performances. Pour les nouveaux codes, il convient de le considérer comme une alternative à l'utilisation de Qt Graphical Effects.

L'effet FastBlur adoucit le contenu source en le rendant flou grâce à un algorithme qui utilise la réduction d'échelle du contenu source et un filtrage bilinéaire.

SourceEffet appliqué

Coléoptère noir sur une feuille

Coléoptère avec un effet de flou rapide appliqué

Exemple

L'exemple suivant montre comment appliquer l'effet.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    FastBlur {
        anchors.fill: bug
        source: bug
        radius: 32
    }
}

Documentation des propriétés

cached : bool

Cette propriété permet de mettre en cache les pixels de sortie de l'effet afin d'améliorer les performances de rendu.

Chaque fois que les propriétés de la source ou de l'effet sont modifiées, les pixels du cache doivent être mis à jour. La consommation de mémoire est accrue, car un tampon de mémoire supplémentaire est nécessaire pour stocker la sortie de l'effet.

Il est recommandé de désactiver le cache lorsque les propriétés de la source ou de l’effet sont animées.

Par défaut, la propriété est définie sur « false ».

radius : real

Cette propriété définit la distance entre les pixels voisins qui influencent le flou d’un pixel donné. Un rayon plus grand augmente l’effet de flou. L’algorithme « FastBlur » peut réduire en interne la précision du rayon afin d’assurer de bonnes performances de rendu.

La valeur est comprise entre 0,0 (pas de flou) et inf. La qualité visuelle du flou diminue lorsque le rayon dépasse la valeur 64. Par défaut, la propriété est définie sur « 0.0 » (pas de flou).

Exemples de résultats avec différentes valeurs de flou

Coléoptère sans flou

Coléoptère avec un flou modéré

Coléoptère avec flou maximal

rayon : 0 rayon : 32 rayon : 64

source : variant

Cette propriété définit l'élément source qui va être flouté.

Remarque : il n'est pas possible de faire en sorte que l'effet s'applique à lui-même, par exemple en définissant la source comme étant le parent de l'effet.

transparentBorder : bool

Cette propriété définit le comportement du flou à proximité des bords de l'élément, où le flou des pixels est influencé par les pixels situés à l'extérieur des bords de la source.

Si la propriété est définie sur « true », les pixels situés à l'extérieur de la source sont considérés comme transparents, ce qui est similaire à l'extension « clamp-to-border » d'OpenGL. Le flou s'étend légèrement au-delà de la zone de l'élément concerné.

Si la propriété est définie sur « false », les pixels situés en dehors de la source sont interprétés comme contenant la même couleur que les pixels situés au bord de l’élément, ce qui est similaire au comportement « clamp-to-edge » d’OpenGL. Le flou ne s’étend pas en dehors de la zone de l’élément d’effet.

Par défaut, la propriété est définie sur « false ».

Exemples de rendu avec différentes valeurs de `transparentBorder`

Flou avec verrouillage des contours

Flou avec des bords transparents

transparentBorder : false transparentBorder : true
radius: 64radius: 64

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.