CompositionEffectBrush Classe

Definizione

public ref class CompositionEffectBrush sealed : CompositionBrush

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [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.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionEffectBrush : CompositionBrush

Public NotInheritable Class CompositionEffectBrush
Inherits CompositionBrush

Ereditarietà

Object Platform::Object IInspectable CompositionObject CompositionBrush CompositionEffectBrush

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Esempio

// 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); 

Commenti

Le API di gestione degli effetti consentono agli sviluppatori di personalizzare la modalità di rendering dell’interfaccia utente. Questo può essere qualcosa di semplice come regolare i livelli di saturazione su un'immagine o qualcosa di più complesso come concatenare numerosi effetti insieme e animare le proprietà dell'effetto per creare transizioni di applicazioni interessanti e esperienze utente. Un effetto di composizione è un grafico di operazioni che definiscono come produrre contenuto grafico in base alle superfici di composizione. Ad esempio, il contenuto dei pixel delle immagini. Gli effetti vengono applicati agli oggetti visivi nell'albero e possono fare riferimento alle superfici esistenti.

Viene creata un'istanza di CompositionEffectBrush usando un oggetto CompositionEffectFactory in base a una descrizione dell'effetto specificata. CompositionEffectFactory usa il formato di descrizione dell'effetto Win2D nello spazio dei nomi Microsoft.Graphics.Canvas.Effects .

Un oggetto CompositionEffectBrush viene applicato a uno SpriteVisual nell'albero della composizione.

Le origini a CompositionEffectBrush possono essere una superficie o una trama esistente o un altro effetto che abilita la concatenazione degli effetti.

CompositionEffectBrush.Properties (ereditato da CompositionObject.Properties) consente di impostare o animare le proprietà animabili specificate nella chiamata a Compositor. CreateEffectFactory usando il nome completo "EffectName.PropertyName".

Le origini degli effetti possono essere impostate in modo indipendente da altre istanze di CompositionEffectBrush e le proprietà possono essere animate in modo indipendente da altre istanze di CompositionEffectBrush.

Una volta dichiarato un grafico degli effetti, il sistema compila l'effetto usando shader predefiniti. Non è possibile specificare shader personalizzati.

Creazione di una composizioneEffect

Per creare e applicare un effetto, è necessario eseguire la procedura seguente:

1. Creare una descrizione dell'effetto. Per i tipi di effetto validi, vedere lo spazio dei nomi Win2D , Microsoft.Graphics.Canvas.Effects.
2. Impostare qualsiasi origine effetto con un'istanza di CompositionEffectSourceParameter o un altro effetto. Se si specifica un altro effetto, viene creata una catena di effetti.
3. Creare un oggetto CompositionEffectFactory con Compositor. CreateEffectFactory usando la descrizione dell'effetto come input.
4. Creare un'istanza dell'effetto usando CompositorEffectFactory. CreateBrush.
5. Impostare qualsiasi CompositionEffectSourceParameter usando CompositionEffectBrush. SetSourceParameter e il nome del parametro di origine come specificato in precedenza usando un oggetto CompositionEffectSourceParameter.
6. Creare un'istanza di SpriteVisual usando Compositor. CreateSpriteVisual.
7. Impostare la proprietà Brush dell'oggetto SpriteVisual sull'effetto creato.
8. Aggiungere SpriteVisual all'albero di composizione usando la proprietà Children di un ContenitoreVisual.

Proprietà

Metodi

Si applica a

Vedi anche

• CompositionBrush
• IClosable
• Panoramica dei pennelli di composizione
• Panoramica degli effetti di composizione