Freigeben über


LampArrayBitmapEffect Klasse

Definition

Rendert eine Reihe von Bildern für ausgewählte Lampenindizes auf dem Gerät.

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
Vererbung
Object Platform::Object IInspectable LampArrayBitmapEffect
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Beispiele

LampArray-Beispiel

Veranschaulicht, wie die RGB-Beleuchtung von Peripheriegeräten mithilfe der Windows.Devices.Lights - und Windows.Devices.Lights.Effects-APIs gesteuert wird.

AutoRGB-Beispiel

Veranschaulicht, wie eine einzelne, repräsentative Farbe von einem Desktopbildschirm extrahiert und zur Aktivierung von LED-Lampen auf einem verbundenen RGB-Gerät verwendet wird.

Hinweise

Effect erfasst eine Reihe von Bildern, indem der Aufrufer das BitmapRequested-Ereignis abonniert und UpdateBitmap aufruft, wenn es ausgelöst wird. Dadurch können direkt erstellte Bilder für den Effekt bereitgestellt werden.

Es wird versucht, eine 2D-Komposition der angeforderten Lampen zu erstellen und Bilder hoch-/herunterzuskalieren.

Bevor Sie einen Effekt wiedergeben können, müssen Sie ihn an eine LampArrayEffectPlaylist anfügen (siehe Anfügen).

Wenn ein LampArray an eine LampArrayBitmapEffect gebunden ist und die Verbindung getrennt wird, wird der Fortschritt des Effekts als no-op fortgesetzt. Es wird keine Ausnahme/kein Fehler ausgelöst/zurückgegeben.

Konstruktoren

LampArrayBitmapEffect(LampArray, Int32[])

Erstellt und initialisiert eine neue instance des Effekts.

Eigenschaften

Duration

Ruft die Dauer des Effekts ab oder legt sie fest.

StartDelay

Ruft die Dauer der Verzögerung ab, bevor der Effekt gestartet wird, oder legt diese fest.

SuggestedBitmapSize

Ruft die am besten geeignete Bildgröße für die vom Aufrufer ausgewählten Lampenindizes ab, die zu einer minimalen Skalierung/Verzerrung führt.

UpdateInterval

Ruft das Intervall zwischen dem Auslösen des BitmapRequested-Ereignisses ab oder legt es fest. Das angegebene Bild wird angezeigt, bis das Ereignis das nächste Mal ausgelöst wird.

ZIndex

Ruft die globale Rangfolge (über alle Wiedergabelisten hinweg) für zwei Effekte ab, die dieselbe Lampe (auf demselben LampArray) ändern, oder legt diese fest.

Ereignisse

BitmapRequested

Ereignis, das vom System ausgelöst wird, um anzugeben, dass ein neues Bild für den Effekt bereitgestellt werden soll.

Gilt für:

Weitere Informationen