SpotLight Classe

Definição

Namespace:

Windows.UI.Composition

Uma fonte de luz que converte cones internos e externos de luz. Por exemplo, uma lanterna.

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

Herança

Object Platform::Object IInspectable CompositionObject CompositionLight SpotLight

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Exemplos

_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);          

Comentários

O SpotLight é um dos quatro tipos de luz derivados de CompositionLight.

Claro	Descrição
Ambientlight	Uma fonte de luz que emite luz não direcional que parece ter sido refletida por tudo na cena.
DistantLight	Uma fonte de luz distante infinitamente grande que emite luz em uma única direção.
Pointlight	Uma fonte de luz que emite luz em todas as direções.
Holofotes	Uma fonte de luz que emite cones internos e externos de luz.

Observação

Um visual não pode ser direcionado por mais de duas luzes não ambientes (PointLight, SpotLight ou DistantLight).

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1.709	16299	InnerConeIntensity
1.709	16299	OuterConeIntensity
1803	17134	MaxAttenuationCutoff
1803	17134	MinAttenuationCutoff

Propriedades

Comment	Uma cadeia de caracteres a ser associada ao CompositionObject. (Herdado de CompositionObject)
Compositor	O Compositor usado para criar este CompositionObject. (Herdado de CompositionObject)
ConstantAttenuation	O coeficiente constante na equação de atenuação da luz. Controla a intensidade da luz. Animatable.
CoordinateSpace	O Visual usado para determinar a direção e o deslocamento da luz. As propriedades de deslocamento e direção da luz são relativas ao espaço de coordenadas desse Visual. SpotLight.CoordinateSpace é uma propriedade necessária. Se SpotLight.CoordinateSpace não estiver definido, o SpotLight não será renderizado.
Direction	A direção na qual a luz está apontando, especificada em relação ao seu Visual CoordinateSpace.
Dispatcher	O dispatcher do CompositionObject. (Herdado de CompositionObject)
DispatcherQueue	Obtém o DispatcherQueue para o CompostionObject. (Herdado de CompositionObject)
ExclusionsFromTargets	Obtém uma coleção de visuais que não são direcionados pela luz. (Herdado de CompositionLight)
ImplicitAnimations	A coleção de animações implícitas anexadas a esse objeto. (Herdado de CompositionObject)
InnerConeAngle	O ângulo de cone interno do SpotLight, expresso como um ângulo semi-vertical em radianos. Animatable.
InnerConeAngleInDegrees	O ângulo de cone interno do SpotLight, expresso como um ângulo semi-vertical em graus. Animatable.
InnerConeColor	Cor do cone interno do destaque. Animatable.
InnerConeIntensity	Obtém ou define a intensidade da luz no cone interno do holofote.
IsEnabled	Obtém ou define um valor que determina se a luz de composição está ativada. (Herdado de CompositionLight)
LinearAttenuation	O coeficiente linear na equação de atenuação da luz que determina como a luz cai com distância. Animatable.
MaxAttenuationCutoff	Obtém ou define o intervalo máximo no qual essa luz é eficaz.
MinAttenuationCutoff	Obtém ou define o intervalo mínimo no qual essa luz é eficaz.
Offset	Deslocamento da fonte de luz em relação ao seu Visual CoordinateSpace . Animatable.
OuterConeAngle	O ângulo de cone externo do SpotLight, expresso como um ângulo semi-vertical em radianos. Animatable.
OuterConeAngleInDegrees	O ângulo semi-vertical, em graus, do cone externo do SpotLight. Animatable.
OuterConeColor	A cor do cone externo do holofote. Animatable.
OuterConeIntensity	Obtém ou define a intensidade da luz no cone externo do holofote.
Properties	A coleção de propriedades associadas ao CompositionObject. (Herdado de CompositionObject)
QuadraticAttenuation	A parte quadrática da equação de atenuação que determina como a luz cai com distância. Animatable.
Targets	A coleção de visuais direcionados pela luz. (Herdado de CompositionLight)

Métodos

Close()	Fecha o CompositionObject e libera os recursos do sistema. (Herdado de CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Conecta e animação. (Herdado de CompositionObject)
DisconnectAnimation(String)	Desconecta uma animação. (Herdado de CompositionObject)
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Define uma propriedade que pode ser animada. (Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Inicia um grupo de animação. O método StartAnimationGroup em CompositionObject permite iniciar CompositionAnimationGroup. Todas as animações no grupo serão iniciadas ao mesmo tempo no objeto . (Herdado de CompositionObject)
StopAnimation(String)	Desconecta uma animação da propriedade especificada e interrompe a animação. (Herdado de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Interrompe um grupo de animação. (Herdado de CompositionObject)
TryGetAnimationController(String)	Retorna um AnimationController para a animação em execução na propriedade especificada. (Herdado de CompositionObject)

Confira também

• CompositionLight
• Targets
• CreateSpotLight()