SpotLight Clase

Definición

Espacio de nombres:

Windows.UI.Composition

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 : CompositionLight

Public NotInheritable Class SpotLight
Inherits CompositionLight

Herencia

Object Platform::Object IInspectable CompositionObject CompositionLight SpotLight

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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)	Conecta una animación con la propiedad especificada del objeto e inicia la animación. (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)
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)

Consulte también

• CompositionLight
• Targets
• CreateSpotLight()