Compartir a través de


SpotLight Clase

Definición

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

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)

Se aplica a

Consulte también