SpotLight 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í.
Fuente de luz que convierte los conos interiores y externos de la luz. Por ejemplo, una linterna.
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 : CompositionLightPublic NotInheritable Class SpotLight
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
_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);
Comentarios
SpotLight 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 | InnerConeIntensity |
| 1709 | 16299 | OuterConeIntensity |
| 1803 | 17134 | MaxAttenuationCutoff |
| 1803 | 17134 | MinAttenuationCutoff |
Propiedades
| Comment |
Cadena que se va a asociar con CompositionObject. (Heredado de CompositionObject) |
| Compositor |
Compositor usado para crear este CompositionObject. (Heredado de CompositionObject) |
| ConstantAttenuation |
Coeficiente constante en la ecuación de atenuación de la luz. Controla la intensidad de la luz. Animable. |
| CoordinateSpace |
Objeto visual utilizado para determinar la dirección y el desplazamiento de la luz. Las propiedades de desplazamiento y dirección de la luz son relativas al espacio de coordenadas de este objeto visual. SpotLight.CoordinateSpace es una propiedad necesaria. Si no se establece SpotLight.CoordinateSpace , SpotLight 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) |
| InnerConeAngle |
Ángulo de cono interno de SpotLight, expresado como un ángulo semi vertical en radianes. Animable. |
| InnerConeAngleInDegrees |
Ángulo de cono interno de SpotLight, expresado como un ángulo semi vertical en grados. Animable. |
| InnerConeColor |
Color del cono interno del foco. Animable. |
| InnerConeIntensity |
Obtiene o establece la intensidad de la luz en el cono interno del foco. |
| IsEnabled |
Obtiene o establece un valor que determina si la luz de composición está activada. (Heredado de CompositionLight) |
| LinearAttenuation |
Coeficiente lineal en la ecuación de atenuación de la luz que determina cómo cae la luz con distancia. Animable. |
| MaxAttenuationCutoff |
Obtiene o establece el intervalo máximo en el que esta luz es efectiva. |
| MinAttenuationCutoff |
Obtiene o establece el intervalo mínimo en el que esta luz es efectiva. |
| Offset |
Desplazamiento de la fuente de luz con respecto a su objeto visual CoordinateSpace . Animable. |
| OuterConeAngle |
Ángulo de cono exterior de SpotLight, expresado como un ángulo semi vertical en radianes. Animable. |
| OuterConeAngleInDegrees |
Ángulo semi vertical, en grados, del cono exterior de SpotLight. Animable. |
| OuterConeColor |
Color del cono exterior del foco. Animable. |
| OuterConeIntensity |
Obtiene o establece la intensidad de la luz en el cono exterior del foco. |
| Properties |
Colección de propiedades asociadas a CompositionObject. (Heredado de CompositionObject) |
| QuadraticAttenuation |
Parte cuadrática de la ecuación de atenuación que determina cómo cae la luz con distancia. Animable. |
| 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) |