DistantLight 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 infinitamente grande e distante que emite luz em uma única direção. Por exemplo, uma luz distante pode ser usada para representar a luz solar.
public ref class DistantLight 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 DistantLight 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 DistantLight : CompositionLightPublic NotInheritable Class DistantLight
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
_distantLight = _compositor.CreateDistantLight();
_distantLight.Color = Colors.Yellow;
_distantLight.Direction = new Vector3(0,-1, 0);
_distantLight.CoordinateSpace = root;
_distantLight.Targets.Add(root);
Comentários
Direçãode suporte do DistantLight s e do SpotLight.
DistantLight é 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 infinitamente grande e distante 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 | Intensidade |
Propriedades
| Color |
Cor do DistantLight emitido. |
| Comment |
Uma cadeia de caracteres a ser associada ao CompositionObject. (Herdado de CompositionObject) |
| Compositor |
O Compositor usado para criar esse CompositionObject. (Herdado de CompositionObject) |
| CoordinateSpace |
O Visual usado para determinar a direção da luz. A propriedade Direction da luz é relativa ao espaço de coordenadas desse Visual. é uma propriedade necessária. Se CoordinateSpace não estiver definido, o DistantLight não será renderizado. |
| Direction |
A direção na qual a luz está apontando, especificada em relação ao visual do CoordinateSpace . |
| Dispatcher |
O dispatcher para 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) |
| Intensity |
Obtém ou define a intensidade da luz. |
| IsEnabled |
Obtém ou define um valor que determina se a luz de composição está acesa. (Herdado de CompositionLight) |
| Properties |
A coleção de propriedades associadas ao CompositionObject. (Herdado de CompositionObject) |
| Targets |
A coleção de Visuais direcionada 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) |