Freigeben über


SpotLight Klasse

Definition

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

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, AnimationController)

Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation.

(Geerbt von CompositionObject)
StartAnimation(String, CompositionAnimation)

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:

Weitere Informationen