ShaderEffectSource QML Type

Rend un Qt Quick dans une texture et l'affiche. Plus d'informations...

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

Propriétés

• format : enumeration
• hideSource : bool
• live : bool
• mipmap : bool
• recursive : bool
• samples : int
• sourceItem : Item
• sourceRect : rect
• textureMirroring : enumeration
• textureSize : size
• wrapMode : enumeration

Méthodes

• void scheduleUpdate()

Description détaillée

Le type ShaderEffectSource rend sourceItem dans une texture et l'affiche dans la scène. sourceItem est dessiné dans la texture comme s'il s'agissait d'un élément racine totalement opaque. Ainsi, sourceItem peut être invisible, mais apparaître dans la texture.

Vous pouvez utiliser le ShaderEffectSource comme :

• une source de texture dans une ShaderEffect. Cela vous permet d'appliquer des effets de shaders personnalisés à n'importe quel élément. Qt Quick élément.
• un cache pour un élément complexe. L'élément complexe peut être rendu une fois dans la texture, qui peut ensuite être animée librement sans qu'il soit nécessaire de rendre à nouveau l'élément complexe à chaque image.
• une couche d'opacité. ShaderEffectSource vous permet d'appliquer une opacité à des éléments en tant que groupe plutôt qu'à chaque élément individuellement.

import QtQuick 2.0

Rectangle {
    width: 200
    height: 100
    gradient: Gradient {
        GradientStop { position: 0; color: "white" }
        GradientStop { position: 1; color: "black" }
    }
    Row {
        opacity: 0.5
        Item {
            id: foo
            width: 100; height: 100
            Rectangle { x: 5; y: 5; width: 60; height: 60; color: "red" }
            Rectangle { x: 20; y: 20; width: 60; height: 60; color: "orange" }
            Rectangle { x: 35; y: 35; width: 60; height: 60; color: "yellow" }
        }
        ShaderEffectSource {
            width: 100; height: 100
            sourceItem: foo
        }
    }
}

Le type ShaderEffectSource ne redirige aucune entrée de souris ou de clavier vers sourceItem. Si vous masquez sourceItem en réglant visible sur false ou opacity sur zero, il ne réagira plus aux entrées. Dans les cas où le ShaderEffectSource est destiné à remplacer le sourceItem, vous souhaitez généralement masquer le sourceItem tout en continuant à gérer les entrées. Pour ce faire, vous pouvez utiliser la propriété hideSource.

Vous pouvez combiner les propriétés ShaderEffectSource et MultiEffect:

• Pour utiliser le même élément source dans plusieurs effets et le garder inchangé.
• Pour utiliser une partie de l'élément source, en utilisant ShaderEffectSource.sourceRect.
• Pour diminuer la résolution de l'élément source, par exemple pour améliorer les performances, en utilisant la propriété ShaderEffectSource.textureSize.

Documentation sur les propriétés

format : enumeration

Cette propriété définit le format de la texture d'accompagnement. La modification de cette propriété prend tout son sens lorsque l'élément est utilisé comme texture source d'un site ShaderEffect.

hideSource : bool

Si cette propriété vaut true, le site sourceItem est caché, bien qu'il soit toujours intégré à la texture. Contrairement à ce qui se passe lorsque sourceItem est caché en attribuant à visible la valeur false, le fait d'attribuer la valeur true à cette propriété n'empêchera pas la souris ou les saisies au clavier d'atteindre sourceItem. Cette propriété est utile lorsque la page ShaderEffectSource est ancrée au-dessus de la page sourceItem et qu'elle est censée la remplacer.

live : bool

Si cette propriété est vraie, la texture est mise à jour à chaque fois que le site sourceItem est mis à jour. Sinon, il s'agira d'une image figée, même si un nouvel élément est attribué à sourceItem. La propriété est vraie par défaut.

mipmap : bool

Si cette propriété est vraie, des mipmaps sont générés pour la texture.

recursive : bool

Attribuez la valeur "true" à cette propriété si le site ShaderEffectSource est dépendant de lui-même. Les ShaderEffectSources forment une chaîne de dépendance, dans laquelle une ShaderEffectSource peut faire partie de la sourceItem d'une autre. S'il y a une boucle dans cette chaîne, une ShaderEffectSource peut finir par essayer de faire un rendu dans la même texture qu'elle utilise comme source, ce qui n'est pas autorisé par OpenGL. Lorsque cette propriété est définie sur true, une texture supplémentaire est allouée afin que ShaderEffectSource puisse conserver une copie de la texture de l'image précédente. Il peut alors effectuer un rendu dans une texture et utiliser la texture de l'image précédente comme source.

En fixant cette propriété et la valeur de live à true, le graphique de la scène sera rendu en continu. Étant donné que ShaderEffectSource dépend de lui-même, sa mise à jour signifie qu'il redevient immédiatement sale.

samples : int

Cette propriété permet de demander un rendu multi-échantillonné.

Par défaut, le multi-échantillonnage est activé chaque fois que le multi-échantillonnage est activé pour l'ensemble de la fenêtre, en supposant que le moteur de rendu de graphe de scène utilisé et l'API graphique sous-jacente le prennent en charge.

En fixant la valeur à 2, 4, etc., il est possible de demander un rendu multi-échantillonné pour une partie de la scène sans activer le multi-échantillonnage pour l'ensemble de la scène. De cette manière, le multi-échantillonnage n'est appliqué qu'à un sous-arbre donné, ce qui peut entraîner des gains de performance significatifs puisque le multi-échantillonnage n'est pas appliqué à d'autres parties de la scène.

sourceItem : Item

Cette propriété contient l'élément à rendre dans la texture. La définition de cette propriété à null lorsque live est vrai, libère les ressources de la texture.

sourceRect : rect

Cette propriété définit la zone rectangulaire de sourceItem à rendre dans la texture. Le rectangle source peut être plus grand que sourceItem lui-même. Si le rectangle est nul, ce qui est le cas par défaut, l'ensemble de sourceItem est rendu dans la texture.

textureMirroring : enumeration

Cette propriété définit comment la texture OpenGL générée doit être reflétée. La valeur par défaut est ShaderEffectSource.MirrorVertically. La mise en miroir personnalisée peut être utile si la texture générée est directement accessible par des shaders personnalisés, tels que ceux spécifiés par ShaderEffect. La mise en miroir n'a aucun effet sur la représentation de l'interface utilisateur de l'élément ShaderEffectSource lui-même.

textureSize : size

Cette propriété contient la taille en pixels demandée pour la texture. Si elle est vide, ce qui est le cas par défaut, la taille du rectangle source est utilisée.

wrapMode : enumeration

Cette propriété définit les modes d'habillage OpenGL associés à la texture. La modification de cette propriété prend tout son sens lorsque l'élément est utilisé comme texture source d'un site ShaderEffect.

La valeur par défaut est ShaderEffectSource.ClampToEdge.

Documentation de la méthode

void scheduleUpdate()

Planifie un nouveau rendu de la texture pour la prochaine image. Utilisez cette fonction pour mettre à jour la texture lorsque live est faux.