Partager via


DistantLight Classe

Définition

Source de lumière distante à l’infini qui émet de la lumière dans une seule direction. Par exemple, une lumière distante peut être utilisée pour représenter la lumière du soleil.

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
Héritage
Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Exemples

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

Remarques

DistantLightet SpotLightprennent en charge la direction.

DistantLight est l’un des quatre types de lumière dérivés de CompositionLight.

Clair Description
AmbientLight Source de lumière qui émet une lumière non directionnelle qui semble avoir été réfléchie par tous les éléments de la scène.
DistantLight Source de lumière distante à l’infini qui émet de la lumière dans une seule direction.
PointLight Source de lumière ponctuelle qui émet de la lumière dans toutes les directions.
Projecteur Source de lumière qui émet des cônes intérieurs et externes de lumière.

Notes

Un visuel ne peut pas être ciblé par plus de deux lumières non ambiantes (PointLight, SpotLight ou DistantLight).

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1709 16299 Intensité

Propriétés

Color

Couleur du DistantLight émis.

Comment

Chaîne à associer à CompositionObject.

(Hérité de CompositionObject)
Compositor

Compositor utilisé pour créer cet Objet CompositionObject.

(Hérité de CompositionObject)
CoordinateSpace

Visuel utilisé pour déterminer la direction de la lumière. La propriété Direction de la lumière est relative à l’espace de coordonnées de ce visuel.

**CoordinateSpace**

est une propriété obligatoire. Si CoordinateSpace n’est pas défini, l’objet DistantLight ne s’affiche pas.

Direction

Direction dans laquelle la lumière pointe, spécifiée par rapport à son élément visuel CoordinateSpace .

Dispatcher

Répartiteur pour compositionObject.

(Hérité de CompositionObject)
DispatcherQueue

Obtient le DispatcherQueue pour CompostionObject.

(Hérité de CompositionObject)
ExclusionsFromTargets

Obtient une collection de visuels qui ne sont pas ciblés par la lumière.

(Hérité de CompositionLight)
ImplicitAnimations

Collection d’animations implicites attachées à cet objet.

(Hérité de CompositionObject)
Intensity

Obtient ou définit l’intensité de la lumière.

IsEnabled

Obtient ou définit une valeur qui détermine si la lumière de composition est allumée.

(Hérité de CompositionLight)
Properties

Collection de propriétés associées à CompositionObject.

(Hérité de CompositionObject)
Targets

Collection de visuels ciblés par la lumière.

(Hérité de CompositionLight)

Méthodes

Close()

Ferme l’objet CompositionObject et libère les ressources système.

(Hérité de CompositionObject)
ConnectAnimation(String, CompositionAnimation)

Connecte et animation.

(Hérité de CompositionObject)
DisconnectAnimation(String)

Déconnecte une animation.

(Hérité de CompositionObject)
Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

(Hérité de CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Définit une propriété qui peut être animée.

(Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)

Connecte une animation à la propriété spécifiée de l’objet et démarre l’animation.

(Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation)

Connecte une animation à la propriété spécifiée de l’objet et démarre l’animation.

(Hérité de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

Démarre un groupe d’animations.

La méthode StartAnimationGroup sur CompositionObject vous permet de démarrer CompositionAnimationGroup. Toutes les animations du groupe seront démarrées en même temps sur l’objet.

(Hérité de CompositionObject)
StopAnimation(String)

Déconnecte une animation de la propriété spécifiée et arrête l’animation.

(Hérité de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

Arrête un groupe d’animations.

(Hérité de CompositionObject)
TryGetAnimationController(String)

Renvoie un AnimationController pour l’animation en cours d’exécution sur la propriété spécifiée.

(Hérité de CompositionObject)

S’applique à

Voir aussi