CompositionEffectBrush Klasse

Definition

public ref class CompositionEffectBrush sealed : CompositionBrush

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionEffectBrush final : CompositionBrush

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class CompositionEffectBrush final : CompositionBrush

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionEffectBrush : CompositionBrush

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class CompositionEffectBrush : CompositionBrush

Public NotInheritable Class CompositionEffectBrush
Inherits CompositionBrush

Vererbung

Object Platform::Object IInspectable CompositionObject CompositionBrush CompositionEffectBrush

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

// Create an effect description 
GaussianBlurEffect blurEffect = new GaussianBlurEffect() 
{ 
    Name = "Blur", 
    BlurAmount = 1.0f, 
    BorderMode = EffectBorderMode.Hard, 
    Optimization = EffectOptimization.Balanced 
}; 

blurEffect.Source = new CompositionEffectSourceParameter("source"); 

CompositionEffectFactory blurEffectFactory = _compositor.CreateEffectFactory(blurEffect); 
CompositionEffectBrush blurBrush = blurEffectFactory.CreateBrush(); 
// Create a BackdropBrush and bind it to the EffectSourceParameter “source” 
CompositionBackdropBrush backdropBrush = _compositor.CreateBackdropBrush(); 
blurBrush.SetSourceParameter("source", backdropBrush); 

// The SpriteVisual to apply the blur BackdropBrush to 
// This will cause everything behind this SpriteVisual to be blurred 
SpriteVisual blurSprite = _compositor.CreateSpriteVisual(); 
blurSprite.Brush = blurBrush; 

// Set blurSprite as a child visual of a XAML element 
ElementCompositionPreview.SetElementChildVisual(blurArea, blurSprite); 

Hinweise

Mit den Effekt-APIs können Entwickler anpassen, wie ihre Benutzeroberfläche gerendert wird. Dies kann so einfach sein, wie das Anpassen von Sättigungsebenen auf einem Bild oder etwas komplexer ist, z. B. das Verketten zahlreicher Effekte und das Animieren der Effekteigenschaften, um interessante Anwendungsübergänge und Benutzererfahrungen zu erzeugen. Ein Kompositionseffekt ist ein Diagramm von Vorgängen, die definieren, wie grafische Inhalte basierend auf Kompositionsoberflächen erzeugt werden. Beispielsweise der Pixelinhalt von Bildern. Effekte werden auf visuelle Elemente in der Struktur angewendet und können auf vorhandene Oberflächen verweisen.

Eine Instanz von CompositionEffectBrush wird mithilfe einer CompositionEffectFactory basierend auf einer angegebenen Effektbeschreibung erstellt. CompositionEffectFactory verwendet das Win2D-Effektbeschreibungsformat im Microsoft. Graphics.Canvas.Effects-Namespace (Windows App SDK (WinUI 3) / UWP (WinUI 2)).

Ein CompositionEffectBrush wird auf ein SpriteVisual in der Kompositionsstruktur angewendet.

Quellen für CompositionEffectBrush können eine vorhandene Oberfläche oder Textur oder ein anderer Effekt sein, der die Effektkette ermöglicht.

CompositionEffectBrush.Properties (geerbt von CompositionObject.Properties) ermöglicht das Festlegen oder Animieren der animierbaren Eigenschaften, die im Aufruf von Compositor angegeben wurden. CreateEffectFactory mit dem vollständigen Namen 'EffectName.PropertyName'

Effektquellen können unabhängig von anderen CompositionEffectBrush-Instanzen festgelegt werden, und Eigenschaften können unabhängig von anderen CompositionEffectBrush-Instanzen animiert werden.

Nachdem ein Effektdiagramm deklariert wurde, kompiliert das System den Effekt mithilfe integrierter Shader. Benutzerdefinierte Shader können nicht angegeben werden.

Erstellen eines CompositionEffect

Zum Erstellen und Anwenden eines Effekts müssen Sie die folgenden Schritte ausführen:

1. Erstellen Sie eine Effektbeschreibung. Weitere Informationen finden Sie im Win2D-NamespaceMicrosoft. Graphics.Canvas.Effects-Namespace (Windows App SDK (WinUI 3) / UWP (WinUI 2)) für gültige Effekttypen.
2. Legen Sie alle Effektquellen mit einer Instanz von CompositionEffectSourceParameter oder einem anderen Effekt fest. Wenn Sie einen anderen Effekt angeben, wird eine Effektkette erstellt.
3. Erstellen Sie eine CompositionEffectFactory mit Kompositor. CreateEffectFactory mithilfe der Effektbeschreibung als Eingabe.
4. Erstellen Sie eine Instanz des Effekts mithilfe von CompositorEffectFactory. CreateBrush.
5. Legen Sie "CompositionEffectSourceParameter" mithilfe von CompositionEffectBrush fest. SetSourceParameter und der Name des Quellparameters, wie zuvor mithilfe eines CompositionEffectSourceParameter angegeben.
6. Erstellen Sie eine Instanz von SpriteVisual mithilfe von Compositor. CreateSpriteVisual.
7. Legen Sie die Brush-Eigenschaft des SpriteVisual auf den erstellten Effekt fest.
8. Fügen Sie spriteVisual der Kompositionsstruktur mithilfe der Children-Eigenschaft eines ContainersVisual hinzu.

Weitere Informationen

• CompositionBrush
• Übersicht über Kompositionspinsel
• Übersicht über Kompositionseffekte