DistantLight Klasse
Definition
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.
Eine unendlich große entfernte Lichtquelle, die Licht in eine einzelne Richtung ausstrahlt. So könnte z. B. ein entferntes Licht verwendet werden, um Sonnenlicht darzustellen.
public ref class DistantLight sealed : CompositionLight/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [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.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class DistantLight final : CompositionLight[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DistantLight : CompositionLight[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class DistantLight : CompositionLightPublic NotInheritable Class DistantLight
Inherits CompositionLight- Vererbung
- Attribute
Beispiele
_distantLight = _compositor.CreateDistantLight();
_distantLight.Color = Colors.Yellow;
_distantLight.Direction = new Vector3(0,-1, 0);
_distantLight.CoordinateSpace = root;
_distantLight.Targets.Add(root);
Hinweise
RemoteLights und SpotLights Unterstützungsrichtung.
DistantLight ist einer der vier Lichttypen, die von CompositionLight abgeleitet sind.
| Light | Description |
|---|---|
| Ambientlight | Eine Lichtquelle, die nicht direktionales Licht ausstrahlt, das scheinbar von allem in der Szene reflektiert wurde. |
| Fernlicht | Eine unendlich große entfernte Lichtquelle, die Licht in eine einzelne Richtung ausstrahlt. |
| Pointlight | Eine Punktquelle des Lichts, die Licht in alle Richtungen ausstrahlt. |
| Spotlight | Eine Lichtquelle, die innere und äußere Lichtkegel ausstrahlt. |
Hinweis
Ein Visuelles Element kann nicht auf mehr als zwei nicht umgebungsbezogene Lichter (PointLight, SpotLight oder DistantLight) ausgerichtet werden.
Eigenschaften
| Name | Beschreibung |
|---|---|
| Color |
Farbe des ausgegebenen Fernlichts. |
| Comment |
Eine Zeichenfolge, die dem CompositionObject zugeordnet werden soll. (Geerbt von CompositionObject) |
| Compositor |
Der Kompositor , der zum Erstellen dieses CompositionObjects verwendet wurde. (Geerbt von CompositionObject) |
| CoordinateSpace |
Wird |
| Direction |
Die Richtung, in der das Licht zeigt, wird relativ zu dessen CoordinateSpace Visual angegeben. |
| DispatcherQueue |
Ruft den DispatcherQueue für das CompositionObject ab. (Geerbt von CompositionObject) |
| ExclusionsFromTargets |
Ruft eine Auflistung von visuellen Objekten ab, die nicht auf das Licht ausgerichtet sind. (Geerbt von CompositionLight) |
| ImplicitAnimations |
Die Auflistung impliziter Animationen, die diesem Objekt zugeordnet sind. (Geerbt von CompositionObject) |
| Intensity |
Ruft die Intensität des Lichts ab oder legt sie fest. |
| IsEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob die Kompositionsleuchte aktiviert ist. (Geerbt von CompositionLight) |
| Properties |
Die Auflistung der Eigenschaften, die dem CompositionObject zugeordnet sind. (Geerbt von CompositionObject) |
| Targets |
Die Sammlung von visuellen Elementen, die auf das Licht ausgerichtet sind. (Geerbt von CompositionLight) |
Methoden
| Name | Beschreibung |
|---|---|
| Close() |
Schließt das CompositionObject und gibt Systemressourcen frei. (Geerbt von CompositionObject) |
| Dispose() |
Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind. (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 auf 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 stoppt 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 auf der angegebenen Eigenschaft ausgeführt wird. (Geerbt von CompositionObject) |