PointLight Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Source de lumière ponctuelle qui émane de la lumière dans toutes les directions.
public ref class PointLight 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 PointLight 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 PointLight : CompositionLightPublic NotInheritable Class PointLight
Inherits CompositionLight- Héritage
- 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)
|
Remarques
Un PointLight dégage la lumière de façon égale dans toutes les directions.
PointLight 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 infiniment grande 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 de lumière intérieurs et externes. |
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é |
| 1803 | 17134 | MaxAttenuationCutoff |
| 1803 | 17134 | MinAttenuationCutoff |
Propriétés
| Color |
Couleur de la lumière. |
| Comment |
Chaîne à associer à l’objet CompositionObject. (Hérité de CompositionObject) |
| Compositor |
Compositeur 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. |
| CoordinateSpace |
Visuel utilisé pour déterminer le décalage de la lumière. La propriété de décalage de la lumière est relative à l’espace de coordonnées de ce visuel. PointLight.CoordinateSpace est une propriété obligatoire. Si PointLight.CoordinateSpace n’est pas défini, pointLight ne s’affiche pas. |
| Dispatcher |
Répartiteur de l’objet CompositionObject. (Hérité de CompositionObject) |
| DispatcherQueue |
Obtient 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 activé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. |
| 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 effective. |
| Offset |
Décalage de la source de lumière par rapport à son espace de coordonnées Visuel. |
| 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 comment la lumière tombe avec la distance. |
| 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) |
Se 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 avec la propriété spécifiée de l’objet et démarre l’animation. (Hérité de CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
Connecte une animation avec 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 sont 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) |