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) (26 种模式中的 21 种)	合并 2 个图像。 此效果具有 26 种混合模式，其中 21 种当前受 Compositon API 支持。 当前未实现的 5 种混合模式是溶解、色调、饱和度、颜色和亮度。
ColorSourceEffect WinAppSDK (WinUI 3) UWP (WinUI 2)	颜色源效果生成指定的纯色。 它作为其他效果的源很有用，例如使用混合颜色源着色图像。
饱和度Effect WinAppSDK (WinUI 3) UWP (WinUI 2)	更改图像的饱和度。 如果将其设置为 1，则输出图像将完全饱和。 如果将其设置为 0，则输出图像为单色。
Transform2DEffect WinAppSDK (WinUI 3) UWP (WinUI 2)	2D 仿射转换效果基于 3X2 矩阵对图像应用空间转换。 此效果可用于旋转、缩放、倾斜或平移图像。 或者，可以合并这些操作。 仿射传输保留平行线和图像中任意三点之间的距离比率。

另请参阅

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

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)