Partager via


SpotLight Classe

Définition

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

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