DistantLight 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 unendlich große, weit entfernte Lichtquelle, die Licht in eine einzige Richtung ausgibt. Beispielsweise könnte ein fernes Licht verwendet werden, um Sonnenlicht darzustellen.

public ref class DistantLight 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 DistantLight 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 DistantLight : CompositionLight

Public NotInheritable Class DistantLight
Inherits CompositionLight

Vererbung: Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight

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

_distantLight = _compositor.CreateDistantLight(); 
_distantLight.Color = Colors.Yellow; 
_distantLight.Direction = new Vector3(0,-1, 0); 
_distantLight.CoordinateSpace = root; 
_distantLight.Targets.Add(root);

Hinweise

DistantLights und SpotLights unterstützen die Richtung.

DistantLight 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 ausgibt.
Pointlight	Eine Punktlichtquelle, die Licht in alle Richtungen ausgibt.
Spotlight	Eine Lichtquelle, die innere und äußere Lichtkegel ausgibt.

Hinweis

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

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1709	16299	Intensität

Eigenschaften

Color	Farbe des ausgegebenen DistantLight.
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)
CoordinateSpace	Das Visual, das verwendet wird, um die Richtung des Lichts zu bestimmen. Die Direction-Eigenschaft des Lichts ist relativ zum Koordinatenraum dieses Visuals. `CoordinateSpace` ist eine erforderliche Eigenschaft. Wenn CoordinateSpace nicht festgelegt ist, wird distantLight nicht gerendert.
Direction	Die Richtung, in die das Licht zeigt, wird relativ zum CoordinateSpace-Visual angegeben.
Dispatcher	Der Verteiler für das CompositionObject. (Geerbt von CompositionObject)
DispatcherQueue	Ruft die DispatcherQueue für das CompostionObject ab. (Geerbt von CompositionObject)
ExclusionsFromTargets	Ruft eine Auflistung von Visuals ab, die nicht vom Licht bestimmt werden. (Geerbt von CompositionLight)
ImplicitAnimations	Die Auflistung impliziter Animationen, die an dieses Objekt angefügt sind. (Geerbt von CompositionObject)
Intensity	Ruft die Intensität des Lichts ab oder legt diese fest.
IsEnabled	Ruft einen Wert ab, der bestimmt, ob die Kompositionsleuchte leuchtet, oder legt diesen fest. (Geerbt von CompositionLight)
Properties	Die Auflistung der Eigenschaften, die dem CompositionObject zugeordnet sind. (Geerbt von CompositionObject)
Targets	Die Sammlung von Visuals, auf die das Licht ausgerichtet ist. (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: