DistantLight 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 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 : CompositionLightPublic NotInheritable Class DistantLight
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)
|
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. 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) |