Compartilhar via


SpotLight Classe

Definição

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

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, AnimationController)

Conecta uma animação com a propriedade especificada do objeto e inicia a animação.

(Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation)

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)

Aplica-se a

Confira também