SpotLight Klasse

Referenz

Definition

Namespace:: Windows.UI.Composition

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Eine Lichtquelle, die innere und äußere Lichtkegel wirft. Beispiel: Eine Taschenlampe.

public ref class SpotLight sealed : CompositionLight

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpotLight final : CompositionLight

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpotLight : CompositionLight

Public NotInheritable Class SpotLight
Inherits CompositionLight

Vererbung: Object Platform::Object IInspectable CompositionObject CompositionLight SpotLight

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Beispiele

_spotLight = _compositor.CreateSpotLight(); 
_spotLight.CoordinateSpace = root; 
_spotLight.InnerConeAngleInDegrees = 30; 
_spotLight.InnerConeColor = Colors.Red; 
_spotLight.OuterConeAngleInDegrees = 45; 
_spotLight.OuterConeColor = Colors.Yellow; 
_spotLight.Offset = new Vector3(30, 30, 200); 
_spotLight.Targets.Add(root);

Hinweise

SpotLight ist einer der vier Lichttypen, die von CompositionLight abgeleitet sind.

Hell	BESCHREIBUNG
Ambientlight	Eine Lichtquelle, die nicht direktionales Licht ausgibt, das von allem in der Szene reflektiert zu sein scheint.
DistantLight	Eine unendlich große, weit entfernte Lichtquelle, die Licht in eine einzige Richtung abgibt.
Pointlight	Eine Punktlichtquelle, die Licht in alle Richtungen abgibt.
Spotlight	Eine Lichtquelle, die innere und äußere Lichtkegel abgibt.

Hinweis

Ein Visual kann nicht von mehr als zwei Nicht-Umgebungslichtern (PointLight, SpotLight oder DistantLight) ausgerichtet werden.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1709	16299	InnerConeIntensity
1709	16299	OuterConeIntensity
1803	17134	MaxAttenuationCutoff
1803	17134	MinAttenuationCutoff

Eigenschaften

Comment	Eine Zeichenfolge, die dem CompositionObject zugeordnet werden soll. (Geerbt von CompositionObject)
Compositor	Der Compositor , der zum Erstellen dieses CompositionObject verwendet wird. (Geerbt von CompositionObject)
ConstantAttenuation	Der konstante Koeffizient in der Dämpfungsgleichung des Lichts. Steuert die Lichtintensität. Animatable.
CoordinateSpace	Das Visual, das verwendet wird, um die Richtung und den Offset des Lichts zu bestimmen. Die Offset- und Richtungseigenschaften des Lichts sind relativ zum Koordinatenraum dieses Visuals. SpotLight.CoordinateSpace ist eine erforderliche Eigenschaft. Wenn SpotLight.CoordinateSpace nicht festgelegt ist, wird SpotLight nicht gerendert.
Direction	Die Richtung, in die das Licht zeigt, wird relativ zum CoordinateSpace-Visual angegeben.
Dispatcher	Der Dispatcher für das CompositionObject. (Geerbt von CompositionObject)
DispatcherQueue	Ruft den DispatcherQueue für das CompostionObject ab. (Geerbt von CompositionObject)
ExclusionsFromTargets	Ruft eine Auflistung von Visuals ab, die nicht für das Licht bestimmt sind. (Geerbt von CompositionLight)
ImplicitAnimations	Die Auflistung impliziter Animationen, die diesem Objekt angefügt sind. (Geerbt von CompositionObject)
InnerConeAngle	Der innere Kegelwinkel des SpotLight, ausgedrückt als halb vertikaler Winkel in Bogenmaßen. Animatable.
InnerConeAngleInDegrees	Der innere Kegelwinkel des SpotLight, ausgedrückt als halb vertikaler Winkel in Grad. Animatable.
InnerConeColor	Farbe des inneren Kegels des Strahlers. Animatable.
InnerConeIntensity	Ruft die Intensität des Lichts im inneren Kegel des Spotlights ab oder legt diese fest.
IsEnabled	Ruft einen Wert ab, der bestimmt, ob das Kompositionslicht eingeschaltet ist, oder legt diesen fest. (Geerbt von CompositionLight)
LinearAttenuation	Der lineare Koeffizient in der Dämpfungsgleichung des Lichts, der bestimmt, wie das Licht mit der Entfernung abfällt. Animatable.
MaxAttenuationCutoff	Ruft den maximalen Bereich ab, in dem dieses Licht wirksam ist, oder legt diesen fest.
MinAttenuationCutoff	Ruft den Mindestbereich ab, in dem dieses Licht wirksam ist, oder legt diesen fest.
Offset	Offset der Lichtquelle relativ zu ihrem CoordinateSpace-Visual . Animatable.
OuterConeAngle	Der äußere Kegelwinkel des SpotLight, ausgedrückt als halb vertikaler Winkel in Bogenmaßen. Animatable.
OuterConeAngleInDegrees	Der halbwinklige Winkel des äußeren Kegels des SpotLight. Animatable.
OuterConeColor	Die Farbe des äußeren Kegels des Strahlers. Animatable.
OuterConeIntensity	Ruft die Intensität des Lichts im äußeren Kegel des Spotlights ab oder legt diese fest.
Properties	Die Auflistung von Eigenschaften, die dem CompositionObject zugeordnet sind. (Geerbt von CompositionObject)
QuadraticAttenuation	Der quadratische Teil der Dämpfungsgleichung, der bestimmt, wie das Licht mit der Entfernung abfällt. Animatable.
Targets	Die Sammlung von Visuals, auf die das Licht abzielt. (Geerbt von CompositionLight)

Methoden

Close()	Schließt das CompositionObject und gibt Systemressourcen frei. (Geerbt von CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Verbindet und Animation. (Geerbt von CompositionObject)
DisconnectAnimation(String)	Trennt eine Animation. (Geerbt von CompositionObject)
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definiert eine Eigenschaft, die animiert werden kann. (Geerbt von CompositionObject)
StartAnimation(String, CompositionAnimation)	Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Startet eine Animationsgruppe. Mit der StartAnimationGroup-Methode für CompositionObject können Sie CompositionAnimationGroup starten. Alle Animationen in der Gruppe werden gleichzeitig für das Objekt gestartet. (Geerbt von CompositionObject)
StopAnimation(String)	Trennt eine Animation von der angegebenen Eigenschaft und beendet die Animation. (Geerbt von CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Beendet eine Animationsgruppe. (Geerbt von CompositionObject)
TryGetAnimationController(String)	Gibt einen AnimationController für die Animation zurück, die für die angegebene Eigenschaft ausgeführt wird. (Geerbt von CompositionObject)

Gilt für: