Compositor.CreateEffectFactory 方法

定義

命名空間:

Microsoft.UI.Composition

多載

CreateEffectFactory(IGraphicsEffect)	建立 CompositionEffectFactory的實例。
CreateEffectFactory(IGraphicsEffect, IIterable<String>)	建立 CompositionEffectFactory 的實例，指定應該可產生動畫效果的參數。

CreateEffectFactory(IGraphicsEffect)

建立 CompositionEffectFactory的實例。

public:
 virtual CompositionEffectFactory ^ CreateEffectFactory(IGraphicsEffect ^ graphicsEffect) = CreateEffectFactory;

/// [Windows.Foundation.Metadata.Overload("CreateEffectFactory")]
CompositionEffectFactory CreateEffectFactory(IGraphicsEffect const& graphicsEffect);

[Windows.Foundation.Metadata.Overload("CreateEffectFactory")]
public CompositionEffectFactory CreateEffectFactory(IGraphicsEffect graphicsEffect);

function createEffectFactory(graphicsEffect)

Public Function CreateEffectFactory (graphicsEffect As IGraphicsEffect) As CompositionEffectFactory

參數

graphicsEffect

IGraphicsEffect

要建立的效果類型。

傳回

CompositionEffectFactory

會傳回建立的 CompositionEffectFactory 物件。

屬性

OverloadAttribute

備註

建立效果處理站會編譯效果，並允許建立該效果的實例。

如需建立和使用效果的相關資訊，請參閱 CompositionEffectBrush 的備註一節。

目前支援的效果類型包括：

效果名稱	描述
ArithmeticCompositeEffect WinAppSDK (WinUI 3) UWP (WinUI 2)	使用來源影像中圖元的加權總和，結合兩個影像。
CompositeEffect WinAppSDK (WinUI 3) UWP (WinUI 2)	根據 Alpha 色板結合兩個或多個影像。 此效果有 13 種不同的複合模式。 複合效果接受 2 個或多個輸入。 當您指定 2 個影像時，目的地是第一個輸入 (索引 0) ，而來源是第二個輸入 (索引 1) 。 如果您指定 2 個以上的輸入，影像會從第一個輸入和第二個等開始複合。
BlendEffect WinAppSDK (WinUI 3) UWP (WinUI 2) ( 21)	結合 2 個影像。 此效果有 26 種混合模式，且目前由 Compositon API 支援的模式有 21 種。 目前未實作的 5 種混合模式是化學、色調、飽和度、色彩和亮度。
ColorSourceEffect WinAppSDK (WinUI 3) UWP (WinUI 2)	色彩來源效果會產生指定的純色。 它可作為其他效果的來源，例如使用混合與色彩來源來著色影像。
SaturationEffect WinAppSDK (WinUI 3) UWP (WinUI 2)	改變影像的飽和度。 如果您將其設定為 1，輸出影像會完全飽和。 如果您將其設定為 0，則輸出影像為單色。
Transform2DEffect WinAppSDK (WinUI 3) UWP (WinUI 2)	2D 貼圖轉換效果會根據 3X2 矩陣，將空間轉換套用至影像。 此效果可用來旋轉、縮放、扭曲或轉譯影像。 或者，您可以合併這些作業。 Affine 傳輸會保留平行線，以及影像中任三點之間的距離比例。

另請參閱

• CreateEffectFactory(IGraphicsEffect, IIterable<String>)
• WinAppSDK 的 Win2D 檔 (WinUI 3) 和 UWP (WinUI 2)

CreateEffectFactory(IGraphicsEffect, IIterable<String>)

建立 CompositionEffectFactory 的實例，指定應該可產生動畫效果的參數。

public:
 virtual CompositionEffectFactory ^ CreateEffectFactory(IGraphicsEffect ^ graphicsEffect, IIterable<Platform::String ^> ^ animatableProperties) = CreateEffectFactory;

/// [Windows.Foundation.Metadata.Overload("CreateEffectFactoryWithProperties")]
CompositionEffectFactory CreateEffectFactory(IGraphicsEffect const& graphicsEffect, IIterable<winrt::hstring> const& animatableProperties);

[Windows.Foundation.Metadata.Overload("CreateEffectFactoryWithProperties")]
public CompositionEffectFactory CreateEffectFactory(IGraphicsEffect graphicsEffect, IEnumerable<string> animatableProperties);

function createEffectFactory(graphicsEffect, animatableProperties)

Public Function CreateEffectFactory (graphicsEffect As IGraphicsEffect, animatableProperties As IEnumerable(Of String)) As CompositionEffectFactory

參數

graphicsEffect

IGraphicsEffect

要建立的效果類型。

animatableProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

應該可產生動畫效果的屬性清單。 屬性是使用 'EffectName.PropertyName' 格式的字串來指定，其中 'EffectName' 會依其 IGraphicsEffect.Name 屬性來識別圖形效果物件，而 'PropertyName' 會識別該物件的屬性。

傳回

CompositionEffectFactory

會傳回建立的 CompositionEffectFactory 物件。

屬性

OverloadAttribute

另請參閱

• CreateEffectFactory(IGraphicsEffect)