SpotLight Classe

Definizione

Spazio dei nomi:

Windows.UI.Composition

Sorgente di luce che proietta i coni interni ed esterni della luce. Ad esempio, una torcia.

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

Ereditarietà

Object Platform::Object IInspectable CompositionObject CompositionLight SpotLight

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

_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);          

Commenti

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

Chiaro	Descrizione
AmbientLight	Sorgente di luce che emette luce non direzionale che sembra essere stata riflessa da tutto il resto della scena.
DistantLight	Sorgente di luce lontana infinitamente grande che emette luce in una sola direzione.
Pointlight	Fonte di luce che emette luce in tutte le direzioni.
Riflettori	Sorgente di luce che emette coni interni ed esterni di luce.

Nota

Un oggetto visivo non può essere indirizzato da più di due luci non ambientali (PointLight, SpotLight o DistantLight).

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1709	16299	InnerConeIntensity
1709	16299	OuterConeIntensity
1803	17134	MaxAttenuationCutoff
1803	17134	MinAttenuationCutoff

Proprietà

Comment	Stringa da associare a CompositionObject. (Ereditato da CompositionObject)
Compositor	Compositor utilizzato per creare questo CompositionObject. (Ereditato da CompositionObject)
ConstantAttenuation	Coefficiente costante nell'equazione di attenuazione della luce. Controlla l'intensità della luce. Animatable.
CoordinateSpace	Oggetto visivo utilizzato per determinare la direzione e l'offset della luce. Le proprietà di offset e direzione della luce sono relative allo spazio delle coordinate di questo oggetto visivo. SpotLight.CoordinateSpace è una proprietà obbligatoria. Se SpotLight.CoordinateSpace non è impostato, il rendering di SpotLight non verrà eseguito.
Direction	Direzione in cui punta la luce, 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 interessati dalla luce. (Ereditato da CompositionLight)
ImplicitAnimations	Raccolta di animazioni implicite associate a questo oggetto. (Ereditato da CompositionObject)
InnerConeAngle	Angolo cono interno di SpotLight, espresso come angolo semi verticale in radianti. Animatable.
InnerConeAngleInDegrees	Angolo cono interno di SpotLight, espresso come angolo semi verticale in gradi. Animatable.
InnerConeColor	Colore del cono interno del riflettore. Animatable.
InnerConeIntensity	Ottiene o imposta l'intensità della luce nel cono interno del riflettore.
IsEnabled	Ottiene o imposta un valore che determina se la luce di composizione è attiva. (Ereditato da CompositionLight)
LinearAttenuation	Coefficiente lineare nell'equazione di attenuazione della luce che determina come la luce cade fuori dalla distanza. Animatable.
MaxAttenuationCutoff	Ottiene o imposta l'intervallo massimo in corrispondenza del quale la luce è effettiva.
MinAttenuationCutoff	Ottiene o imposta l'intervallo minimo in base al quale la luce è effettiva.
Offset	Offset della sorgente di luce rispetto all'oggetto visivo CoordinateSpace . Animatable.
OuterConeAngle	Angolo del cono esterno di SpotLight, espresso come angolo semi verticale in radianti. Animatable.
OuterConeAngleInDegrees	Angolo semi verticale, in gradi, del cono esterno di SpotLight. Animatable.
OuterConeColor	Colore del cono esterno del riflettore. Animatable.
OuterConeIntensity	Ottiene o imposta l'intensità della luce nel cono esterno del riflettore.
Properties	Raccolta di proprietà associate a CompositionObject. (Ereditato da CompositionObject)
QuadraticAttenuation	Parte quadratica dell'equazione di attenuazione che determina la modalità di caduta della luce con distanza. Animatable.
Targets	Raccolta di oggetti visivi di destinazione della luce. (Ereditato da CompositionLight)

Metodi

Close()	Chiude 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)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	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 nel 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 sulla proprietà specificata. (Ereditato da CompositionObject)

Vedi anche

• CompositionLight
• Targets
• CreateSpotLight()