SpotLight Classe

Définition

Espace de noms:

Windows.UI.Composition

Source de lumière qui projette les cônes intérieurs et externes de la lumière. Par exemple, une lampe de poche.

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

Héritage

Object Platform::Object IInspectable CompositionObject CompositionLight SpotLight

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

_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);          

Remarques

SpotLight 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	InnerConeIntensity
1709	16299	OuterConeIntensity
1803	17134	MaxAttenuationCutoff
1803	17134	MinAttenuationCutoff

Propriétés

Comment	Chaîne à associer à CompositionObject. (Hérité de CompositionObject)
Compositor	Compositor utilisé pour créer cet Objet CompositionObject. (Hérité de CompositionObject)
ConstantAttenuation	Coefficient constant dans l’équation d’atténuation de la lumière. Contrôle l’intensité lumineuse. Animatable.
CoordinateSpace	Visuel utilisé pour déterminer la direction et le décalage de la lumière. Les propriétés de décalage et de direction de la lumière sont relatives à l’espace de coordonnées de ce visuel. SpotLight.CoordinateSpace est une propriété obligatoire. Si SpotLight.CoordinateSpace n’est pas défini, le SpotLight 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)
InnerConeAngle	Angle de cône interne de SpotLight, exprimé sous forme d’angle semi-vertical en radians. Animatable.
InnerConeAngleInDegrees	Angle de cône interne de SpotLight, exprimé sous forme d’angle semi-vertical en degrés. Animatable.
InnerConeColor	Couleur du cône interne du projecteur. Animatable.
InnerConeIntensity	Obtient ou définit l’intensité de la lumière dans le cône interne du projecteur.
IsEnabled	Obtient ou définit une valeur qui détermine si la lumière de composition est allumée. (Hérité de CompositionLight)
LinearAttenuation	Coefficient linéaire dans l’équation d’atténuation de la lumière qui détermine comment la lumière tombe avec la distance. Animatable.
MaxAttenuationCutoff	Obtient ou définit la plage maximale à laquelle cette lumière est effective.
MinAttenuationCutoff	Obtient ou définit la plage minimale à laquelle cette lumière est efficace.
Offset	Décalage de la source de lumière par rapport à son visuel CoordinateSpace . Animatable.
OuterConeAngle	Angle cône externe de SpotLight, exprimé sous forme d’angle semi-vertical en radians. Animatable.
OuterConeAngleInDegrees	Angle semi-vertical, en degrés, du cône externe du SpotLight. Animatable.
OuterConeColor	Couleur du cône externe du projecteur. Animatable.
OuterConeIntensity	Obtient ou définit l’intensité de la lumière dans le cône externe du projecteur.
Properties	Collection de propriétés associées à CompositionObject. (Hérité de CompositionObject)
QuadraticAttenuation	Partie quadratique de l’équation d’atténuation qui détermine la façon dont la lumière tombe avec la distance. Animatable.
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)	Connecte une animation à la propriété spécifiée de l’objet et démarre l’animation. (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)
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)

Voir aussi

• CompositionLight
• Targets
• CreateSpotLight()