SpotLight Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 : CompositionLightPublic NotInheritable Class SpotLight
Inherits CompositionLight- Herança
- 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) |