LampArrayBitmapEffect 类

定义

将一系列图像呈现到设备上的所选灯索引。

public ref class LampArrayBitmapEffect sealed : ILampArrayEffect
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.Lights.Effects.ILampArrayBitmapEffectFactory, 458752, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LampArrayBitmapEffect final : ILampArrayEffect
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.Lights.Effects.ILampArrayBitmapEffectFactory), 458752, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LampArrayBitmapEffect : ILampArrayEffect
function LampArrayBitmapEffect(lampArray, lampIndexes)
Public NotInheritable Class LampArrayBitmapEffect
Implements ILampArrayEffect
继承
Object Platform::Object IInspectable LampArrayBitmapEffect
属性
实现

Windows 要求

设备系列
Windows 10, version 1809 (在 10.0.17763.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v7.0 中引入)

示例

LampArray 示例

演示如何使用 Windows.Devices.Lights 和 Windows.Devices.Lights.Effects API 控制外围设备的 RGB 照明。

AutoRGB 示例

演示如何从桌面屏幕中提取具有代表性的单一颜色,并使用它来照亮连接的 RGB 设备上的 LED 灯。

注解

效果由订阅 BitmapRequested 事件的调用方在触发时调用 UpdateBitmap 捕获一系列图像。 这允许向效果提供动态创建的图像。

将尽最大努力创建所请求的灯的 2D 合成,并放大/缩小图像。

在播放效果之前,必须将其追加到 LampArrayEffectPlaylist (请参阅 追加) 。

如果 LampArray 绑定到 LampArrayBitmapEffect 并且断开连接,则效果进度会继续为无操作。 不会引发/返回异常/错误。

构造函数

LampArrayBitmapEffect(LampArray, Int32[])

创建并初始化效果的新实例。

属性

Duration

获取或设置效果的持续时间。

StartDelay

获取或设置在开始效果之前要延迟的持续时间。

SuggestedBitmapSize

获取调用方所选灯索引的最合适的图像大小,该索引可最大程度地减少缩放/失真。

UpdateInterval

获取或设置 BitmapRequested 事件的触发间隔。 将提供的图像将一直显示,直到下一次触发事件。

ZIndex

获取或设置针对修改同一 LampArray) 上相同灯 (的两种效果) 所有播放列表 (全局优先级。

事件

BitmapRequested

由系统触发以指示应为效果提供新图像的事件。

适用于

另请参阅