RadialBlur QML Type
Applique un flou directionnel dans une direction circulaire autour du point central de l'élément. Plus d'informations...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | Qt5Compat.GraphicalEffects 1.0 |
| Inherits: |
Propriétés
- angle : real
- cached : bool
- horizontalOffset : real
- samples : int
- source : variant
- transparentBorder : bool
- verticalOffset : real
Description détaillée
Cet effet donne l'impression que l'élément source semble tourner dans le sens du flou.
Les autres effets de flou de bougé disponibles sont ZoomBlur et DirectionalBlur.
| Source | Effet appliqué |
|---|---|
|
|
Remarque : cet effet est disponible avec OpenGL.
Exemple d'utilisation
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 } RadialBlur { anchors.fill: bug source: bug samples: 24 angle: 30 } }
Documentation sur les propriétés
angle : real
Cette propriété définit la direction du flou et en même temps le niveau de flou. Plus l'angle est grand, plus le résultat est flou. La qualité du flou dépend de la propriété samples. Si la valeur de l'angle est grande, davantage d'échantillons sont nécessaires pour maintenir la qualité visuelle à un niveau élevé.
Les valeurs autorisées sont comprises entre 0,0 et 360,0. Par défaut, la propriété est définie sur 0.0.
| Exemples de sortie avec différentes valeurs d'angle | ||
|---|---|---|
|
|
|
| angle : 0.0 | angle : 15.0 | angle : 30.0 |
| samples: 24 | samples: 24 | samples: 24 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
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 augmente, car une mémoire tampon 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.
horizontalOffset : real
Ces propriétés définissent le décalage en pixels du point central perçu de la rotation.
Les valeurs autorisées sont comprises entre -inf et inf. Par défaut, ces propriétés sont définies sur 0.
| Exemples de résultats avec différentes valeurs de horizontalOffset | ||
|---|---|---|
|
|
|
| horizontalOffset : 75.0 | décalage horizontal : 0.0 | horizontalOffset : -75.0 |
| samples: 24 | samples: 24 | samples: 24 |
| angle: 20 | angle: 20 | angle: 20 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
samples : int
Cette propriété définit le nombre d'échantillons prélevés par pixel lors du calcul du flou. Une valeur plus élevée permet d'obtenir une meilleure qualité, mais le rendu est plus lent.
Cette propriété n'est pas destinée à être animée. La modification de cette propriété peut entraîner la recompilation des shaders OpenGL sous-jacents.
Les valeurs autorisées sont comprises entre 0 et inf (le maximum pratique dépend du GPU). Par défaut, la propriété est définie sur 0 (pas d'échantillons).
source : variant
Cette propriété définit l'élément source qui sera rendu flou.
Remarque : il n'est pas possible de laisser l'effet s'inclure lui-même, par exemple en définissant la source sur le parent de l'effet.
transparentBorder : bool
Cette propriété définit le comportement du flou près des bords de l'élément, où le flou des pixels est affecté par les pixels à 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 interprétés comme étant transparents, ce qui est similaire à l'extension de la pince à la bordure d'OpenGL. Le flou est légèrement étendu en dehors de la zone de l'élément d'effet.
Si la propriété vaut false, les pixels situés à l'extérieur 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 à effet.
Par défaut, la propriété est définie sur false.
verticalOffset : real
Ces propriétés définissent le décalage en pixels du point central perçu de la rotation.
Les valeurs autorisées sont comprises entre -inf et inf. Par défaut, ces propriétés sont définies sur 0.
| Exemples de résultats avec différentes valeurs de horizontalOffset | ||
|---|---|---|
|
|
|
| horizontalOffset: 75.0 | horizontalOffset: 0.0 | horizontalOffset: -75.0 |
| samples: 24 | samples: 24 | samples: 24 |
| angle: 20 | angle: 20 | angle: 20 |
| décalage vertical : 0 | décalage vertical : 0 | décalage vertical : 0 |
© 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.







