Compartilhar via


DistantLight Classe

Definição

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 : CompositionLight
Public NotInheritable Class DistantLight
Inherits CompositionLight
Herança
Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight
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.

**CoordinateSpace**

é 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)

Aplica-se a

Confira também