DistantLight Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Composition

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Una fonte di luce lontana infinitamente grande che genera luce in una singola direzione. Ad esempio, una luce lontana potrebbe essere usata per rappresentare la luce solare.

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

Ereditarietà: Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Esempio

_distantLight = _compositor.CreateDistantLight(); 
_distantLight.Color = Colors.Yellow; 
_distantLight.Direction = new Vector3(0,-1, 0); 
_distantLight.CoordinateSpace = root; 
_distantLight.Targets.Add(root);

Commenti

Direzione di supporto di DistantLights e SpotLight.

DistantLight è uno dei quattro tipi di luce derivati da CompositionLight.

Chiaro	Descrizione
AmbientLight	Una fonte di luce che genera luce non direzionale che sembra essere stata riflessa da tutto ciò che si trova nella scena.
DistantLight	Una fonte di luce lontana infinitamente grande che genera luce in una singola direzione.
Pointlight	Fonte di luce che genera luce in tutte le direzioni.
Riflettori	Fonte di luce che genera coni interni ed esterni di luce.

Nota

Un oggetto Visivo non può essere destinato a più di due luci non ambientali (PointLight, SpotLight o DistantLight).

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1709	16299	Intensità

Proprietà

Color	Colore del valore DistantLight generato.
Comment	Stringa da associare a CompositionObject. (Ereditato da CompositionObject)
Compositor	Compositore usato per creare questo oggetto CompositionObject. (Ereditato da CompositionObject)
CoordinateSpace	Oggetto visivo usato per determinare la direzione della luce. La proprietà Direction della luce è relativa allo spazio delle coordinate di questo oggetto visivo. `CoordinateSpace` è una proprietà obbligatoria. Se CoordinateSpace non è impostato, Il rendering di DistantLight non verrà eseguito.
Direction	Direzione in cui la luce punta, specificata rispetto al relativo oggetto visivo CoordinateSpace .
Dispatcher	Dispatcher per CompositionObject. (Ereditato da CompositionObject)
DispatcherQueue	Ottiene dispatcherQueue per CompostionObject. (Ereditato da CompositionObject)
ExclusionsFromTargets	Ottiene una raccolta di oggetti visivi che non sono destinati alla luce. (Ereditato da CompositionLight)
ImplicitAnimations	Raccolta di animazioni implicite associate a questo oggetto. (Ereditato da CompositionObject)
Intensity	Ottiene o imposta l'intensità della luce.
IsEnabled	Ottiene o imposta un valore che determina se la luce di composizione è attiva. (Ereditato da CompositionLight)
Properties	Raccolta di proprietà associate a CompositionObject. (Ereditato da CompositionObject)
Targets	Raccolta di oggetti visivi destinati alla luce. (Ereditato da CompositionLight)

Metodi

Close()	Chiude l'oggetto CompositionObject e rilascia le risorse di sistema. (Ereditato da CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Connette e animazione. (Ereditato da CompositionObject)
DisconnectAnimation(String)	Disconnette un'animazione. (Ereditato da CompositionObject)
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definisce una proprietà che può essere animata. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Avvia un gruppo di animazioni. Il metodo StartAnimationGroup in CompositionObject consente di avviare CompositionAnimationGroup. Tutte le animazioni del gruppo verranno avviate contemporaneamente sull'oggetto. (Ereditato da CompositionObject)
StopAnimation(String)	Disconnette un'animazione dalla proprietà specificata e arresta l'animazione. (Ereditato da CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Arresta un gruppo di animazioni. (Ereditato da CompositionObject)
TryGetAnimationController(String)	Restituisce un oggetto AnimationController per l'animazione in esecuzione nella proprietà specificata. (Ereditato da CompositionObject)

Si applica a

Condividi tramite