ZoomBlur QML Type

Applique un effet de flou directionnel vers le centre des éléments source. En savoir plus…

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

Propriétés

• cached : bool
• horizontalOffset : real
• length : real
• samples : int
• source : variant
• transparentBorder : bool
• verticalOffset : real

Description détaillée

Cet effet donne l'impression que l'élément source se déplace vers le point central dans la direction Z ou que la caméra effectue un zoom rapide. D'autres effets de flou de mouvement sont disponibles : DirectionalBlur et RadialBlur.

Exemple

L'exemple suivant montre comment appliquer l'effet.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

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

    ZoomBlur {
        anchors.fill: butterfly
        source: butterfly
        samples: 24
        length: 48
    }
}

Documentation sur les 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 contenus dans le cache doivent être mis à jour. La consommation de mémoire augmente, 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, cette propriété est définie sur « false ».

horizontalOffset : real

Ces propriétés définissent un décalage en pixels du point central de la direction du flou.

Les valeurs vont de -inf à inf. Par défaut, ces propriétés sont définies sur 0.

length : real

Cette propriété définit l'amplitude maximale de mouvement perçue pour chaque pixel. Cette amplitude est plus faible près du centre et atteint la valeur spécifiée au niveau des bords.

La qualité du flou dépend de la propriété « samples ». Si la valeur de « length » est élevée, davantage d’échantillons sont nécessaires pour maintenir une qualité visuelle élevée.

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 offre une meilleure qualité, mais ralentit le rendu.

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 » (aucun échantillon).

source : variant

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

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 en dehors 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 ».

verticalOffset : real

Ces propriétés définissent un décalage en pixels pour le point central de la direction du flou.

Les valeurs vont de -inf à inf. Par défaut, ces propriétés sont définies sur 0.