ShaderEffectSource QML Type

Rendert ein Qt Quick Element in eine Textur um und zeigt es an. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Methoden

• void scheduleUpdate()

Ausführliche Beschreibung

Der Typ „ShaderEffectSource“ rendert „ sourceItem “ in eine Textur und zeigt diese in der Szene an. „ sourceItem “ wird so in die Textur gezeichnet, als wäre es ein vollständig undurchsichtiges Root-Element. Somit kann „ sourceItem “ selbst unsichtbar sein, aber dennoch in der Textur erscheinen.

Sie können „ShaderEffectSource“ wie folgt verwenden:

• Texturquelle in einem „ ShaderEffect “. Dadurch können Sie benutzerdefinierte Shader-Effekte auf jedes beliebige Qt Quick Objekt anwenden.
• einen Cache für ein komplexes Element. Das komplexe Element kann einmalig in die Textur gerendert werden, die dann frei animiert werden kann, ohne dass das komplexe Element in jedem Frame erneut gerendert werden muss.
• eine Deckkraft-Ebene. Mit „ShaderEffectSource“ kannst du die Deckkraft auf Objekte als Gruppe anwenden, anstatt jedes Objekt einzeln zu bearbeiten.

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
        }
    }
}

Der Typ „ShaderEffectSource“ leitet keine Maus- oder Tastatureingaben an „ sourceItem “ weiter. Wenn Sie die „ sourceItem “ ausblenden, indem Sie „ visible “ auf „false“ oder „ opacity “ auf Null setzen, reagiert sie nicht mehr auf Eingaben. In Fällen, in denen die „ShaderEffectSource“ die „ sourceItem “ ersetzen soll, möchten Sie in der Regel die „ sourceItem “ ausblenden, während Sie weiterhin Eingaben verarbeiten. Hierfür können Sie die Eigenschaft „ hideSource “ verwenden.

Sie können den „ ShaderEffectSource “ und den „ MultiEffect “ kombinieren:

• Um dasselbe Quellelement in mehreren Effekten zu verwenden und es unverändert zu belassen.
• Um einen Teil des Quellelements zu verwenden, nutzen Sie „ ShaderEffectSource.sourceRect “.
• Um die Auflösung des Quellelements zu verringern, beispielsweise zur Verbesserung der Leistung, mithilfe der Eigenschaft „ ShaderEffectSource.textureSize “.

Dokumentation der Eigenschaften

format : enumeration

Diese Eigenschaft legt das Format der Hintergrundtextur fest. Eine Änderung dieser Eigenschaft ist vor allem dann sinnvoll, wenn das Element als Quelltextur für ein „ ShaderEffect “ verwendet wird.

hideSource : bool

Ist diese Eigenschaft auf „true“ gesetzt, wird die „ sourceItem “ ausgeblendet, wird jedoch weiterhin in die Textur gerendert. Im Gegensatz zum Ausblenden der „ sourceItem “ durch Setzen von „ visible “ auf „false“ verhindert das Setzen dieser Eigenschaft auf „true“ nicht, dass Maus- oder Tastatureingaben an „ sourceItem “ weitergeleitet werden. Die Eigenschaft ist nützlich, wenn die „ ShaderEffectSource “ über der „ sourceItem “ verankert ist und diese ersetzen soll.

live : bool

Ist diese Eigenschaft auf „true“ gesetzt, wird die Textur aktualisiert, sobald „ sourceItem “ aktualisiert wird. Andernfalls bleibt es bei einem statischen Bild, selbst wenn „ sourceItem “ ein neues Element zugewiesen wird. Die Eigenschaft ist standardmäßig auf „true“ gesetzt.

mipmap : bool

Wenn diese Eigenschaft auf „true“ gesetzt ist, werden für die Textur Mipmaps generiert.

recursive : bool

Setzen Sie diese Eigenschaft auf „true“, wenn die „ ShaderEffectSource “ eine Abhängigkeit von sich selbst aufweist. „ShaderEffectSources“ bilden eine Abhängigkeitskette, in der eine „ ShaderEffectSource “ Teil der „ sourceItem “ einer anderen sein kann. Wenn in dieser Kette eine Schleife vorliegt, könnte ein „ ShaderEffectSource “ versuchen, in dieselbe Textur zu rendern, die er als Quelle verwendet, was von OpenGL nicht zugelassen wird. Wenn diese Eigenschaft auf „true“ gesetzt ist, wird eine zusätzliche Textur zugewiesen, sodass „ ShaderEffectSource “ eine Kopie der Textur aus dem vorherigen Frame behalten kann. So kann es in eine Textur rendern und dabei die Textur aus dem vorherigen Frame als Quelle verwenden.

Werden sowohl diese Eigenschaft als auch „ live “ auf „true“ gesetzt, wird der Szenenbaum kontinuierlich gerendert. Da der „ ShaderEffectSource “ von sich selbst abhängt, bedeutet eine Aktualisierung, dass er sofort wieder als „dirty“ markiert wird.

samples : int

Diese Eigenschaft ermöglicht die Anforderung einer Multisampling-Darstellung.

Standardmäßig ist Multisampling immer dann aktiviert, wenn es für das gesamte Fenster aktiviert ist, vorausgesetzt, der verwendete Szenengraph-Renderer und die zugrunde liegende Grafik-API unterstützen dies.

Durch Setzen des Werts auf 2, 4 usw. kann Multisampling-Rendering für einen Teil der Szene angefordert werden, ohne Multisampling für die gesamte Szene zu aktivieren. Auf diese Weise wird Multisampling nur auf einen bestimmten Teilbaum angewendet, was zu erheblichen Leistungssteigerungen führen kann, da Multisampling nicht auf andere Teile der Szene angewendet wird.

sourceItem : Item

Diese Eigenschaft enthält das Element, das in die Textur gerendert werden soll. Wenn dieser Wert auf „null“ gesetzt wird, während „ live “ auf „true“ gesetzt ist, werden die Texturressourcen freigegeben.

sourceRect : rect

Diese Eigenschaft legt fest, welcher rechteckige Bereich des „ sourceItem “ in die Textur gerendert werden soll. Das Quellrechteck kann größer sein als das „ sourceItem “ selbst. Ist das Rechteck null (Standardeinstellung), wird das gesamte „ sourceItem “ in die Textur gerendert.

textureMirroring : enumeration

Diese Eigenschaft legt fest, wie die generierte OpenGL-Textur gespiegelt werden soll. Der Standardwert ist „ ShaderEffectSource.MirrorVertically “. Eine benutzerdefinierte Spiegelung kann nützlich sein, wenn auf die generierte Textur direkt von benutzerdefinierten Shadern zugegriffen wird, wie beispielsweise den unter ShaderEffect angegebenen. Die Spiegelung hat keine Auswirkungen auf die Darstellung des Elements „ ShaderEffectSource “ in der Benutzeroberfläche.

textureSize : size

Diese Eigenschaft enthält die angeforderte Pixelgröße der Textur. Ist sie leer (was der Standard ist), wird die Größe des Quellrechtecks verwendet.

wrapMode : enumeration

Diese Eigenschaft definiert die mit der Textur verbundenen OpenGL-Wrap-Modi. Eine Änderung dieser Eigenschaft ist vor allem dann sinnvoll, wenn das Element als Quelltextur für ein „ ShaderEffect “ verwendet wird.

Der Standardwert ist „ ShaderEffectSource.ClampToEdge “.

Methodendokumentation

void scheduleUpdate()

Plant eine Neu-Rendering der Textur für das nächste Bild ein. Verwenden Sie diese Funktion, um die Textur zu aktualisieren, wenn „ live “ auf „false“ gesetzt ist.