DirectionalBlur QML Type

Applique l'effet de flou à la direction spécifiée. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• angle : real
• cached : bool
• length : real
• samples : int
• source : variant
• transparentBorder : bool

Description détaillée

Cet effet donne l'impression que l'élément source semble se déplacer dans la direction du flou. Le flou est appliqué aux deux côtés de chaque pixel, c'est pourquoi le réglage de la direction sur 0 et 180 donne le même résultat.

Les autres effets de flou de mouvement disponibles sont ZoomBlur et RadialBlur.

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
    }

    DirectionalBlur {
        anchors.fill: bug
        source: bug
        angle: 90
        length: 32
        samples: 24
    }
}

Propriété Documentation

angle : real

Cette propriété définit la direction du flou. Le flou est appliqué aux deux côtés de chaque pixel, c'est pourquoi les valeurs 0 et 180 produisent le même résultat.

La valeur est comprise entre -180,0 et 180,0. Par défaut, la propriété est définie sur 0.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.

length : real

Cette propriété définit la quantité de mouvement perçue pour chaque pixel. Le mouvement est réparti uniformément de part et d'autre de chaque pixel.

La qualité du flou dépend de la propriété samples. Si la valeur de la longueur est élevée, davantage d'échantillons sont nécessaires pour maintenir la qualité visuelle à un niveau élevé.

La valeur est comprise entre 0,0 et inf. Par défaut, la propriété est définie sur 0.0 (pas de flou).

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.

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.