DistantLight Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Una fuente de luz lejana infinitamente grande que emite luz en una sola dirección. Por ejemplo, se podría usar una luz lejana para representar la luz solar.
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- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)
|
Ejemplos
_distantLight = _compositor.CreateDistantLight();
_distantLight.Color = Colors.Yellow;
_distantLight.Direction = new Vector3(0,-1, 0);
_distantLight.CoordinateSpace = root;
_distantLight.Targets.Add(root);
Comentarios
Direcciónde soporte de DistantLight s y SpotLight.
DistantLight es uno de los cuatro tipos de luz derivados de CompositionLight.
| Claro | Descripción |
|---|---|
| AmbientLight | Fuente de luz que emite luz no direccional que parece haber sido reflejada por todo en la escena. |
| DistantLight | Una fuente de luz lejana infinitamente grande que emite luz en una sola dirección. |
| PointLight | Una fuente de luz puntual que emite luz en todas las direcciones. |
| Foco | Fuente de luz que emite conos internos y externos de luz. |
Nota
Un objeto visual no puede ser dirigido por más de dos luces no ambientales (PointLight, SpotLight o DistantLight).
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1709 | 16299 | Intensidad |
Propiedades
| Color |
Color del objeto DistantLight emitido. |
| Comment |
Cadena que se va a asociar con CompositionObject. (Heredado de CompositionObject) |
| Compositor |
Compositor usado para crear este CompositionObject. (Heredado de CompositionObject) |
| CoordinateSpace |
Objeto visual utilizado para determinar la dirección de la luz. La propiedad Direction de la luz es relativa al espacio de coordenadas de este objeto visual. es una propiedad obligatoria. Si no se establece CoordinateSpace , la clase DistantLight no se representará. |
| Direction |
Dirección en la que apunta la luz, especificada en relación con su objeto visual CoordinateSpace . |
| Dispatcher |
Distribuidor del compositionObject. (Heredado de CompositionObject) |
| DispatcherQueue |
Obtiene dispatcherQueue para CompostionObject. (Heredado de CompositionObject) |
| ExclusionsFromTargets |
Obtiene una colección de objetos visuales que no están dirigidos por la luz. (Heredado de CompositionLight) |
| ImplicitAnimations |
Colección de animaciones implícitas adjuntas a este objeto. (Heredado de CompositionObject) |
| Intensity |
Obtiene o establece la intensidad de la luz. |
| IsEnabled |
Obtiene o establece un valor que determina si la luz de composición está activada. (Heredado de CompositionLight) |
| Properties |
Colección de propiedades asociadas a CompositionObject. (Heredado de CompositionObject) |
| Targets |
Colección de objetos visuales dirigidos por la luz. (Heredado de CompositionLight) |
Métodos
| Close() |
Cierra compositionObject y libera los recursos del sistema. (Heredado de CompositionObject) |
| ConnectAnimation(String, CompositionAnimation) |
Conecta y animación. (Heredado de CompositionObject) |
| DisconnectAnimation(String) |
Desconecta una animación. (Heredado de CompositionObject) |
| Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de CompositionObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Define una propiedad que se puede animar. (Heredado de CompositionObject) |
| StartAnimation(String, CompositionAnimation, AnimationController) |
Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
Inicia un grupo de animación. El método StartAnimationGroup en CompositionObject le permite iniciar CompositionAnimationGroup. Todas las animaciones del grupo se iniciarán al mismo tiempo en el objeto . (Heredado de CompositionObject) |
| StopAnimation(String) |
Desconecta una animación de la propiedad especificada y detiene la animación. (Heredado de CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
Detiene un grupo de animación. (Heredado de CompositionObject) |
| TryGetAnimationController(String) |
Devuelve un AnimationController para la animación que se ejecuta en la propiedad especificada. (Heredado de CompositionObject) |