SpotLight 类

定义

命名空间:

Windows.UI.Composition

投射内外锥光的光源。 例如，手电筒。

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

继承

Object Platform::Object IInspectable CompositionObject CompositionLight SpotLight

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

示例

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

注解

SpotLight 是派生自 CompositionLight 的四种光类型之一。

亮	说明
AmbientLight	发出非定向光的光源，该光线似乎已被场景中所有内容反射。
DistantLight	在一个方向上发出光的无限远的光源。
PointLight	在所有方向上发出光的点光源。
SpotLight	发出内部和外部光锥的光源。

注意

(PointLight、SpotLight 或 DistantLight) ，一个视觉对象不能成为两个以上非环境光的目标。

版本历史记录

Windows 版本	SDK 版本	已添加值
1709	16299	InnerConeIntensity
1709	16299	OuterConeIntensity
1803	17134	MaxAttenuationCutoff
1803	17134	MinAttenuationCutoff

属性

Comment	要与 CompositionObject 关联的字符串。 (继承自 CompositionObject)
Compositor	用于创建此 CompositionObject 的 Compositor。 (继承自 CompositionObject)
ConstantAttenuation	光的衰减公式中的常量系数。 控制光强度。 可动画处理。
CoordinateSpace	用于确定光线方向和偏移量的视觉对象。 光线的偏移量和方向属性相对于此视觉对象的坐标空间。 SpotLight.坐标空间 是必需属性。 如果未设置 SpotLight.坐标空间 ，则 SpotLight 将不会呈现。
Direction	光线指向的方向，相对于其坐标空间视觉对象指定。
Dispatcher	CompositionObject 的调度程序。 (继承自 CompositionObject)
DispatcherQueue	获取 CompostionObject 的 DispatcherQueue 。 (继承自 CompositionObject)
ExclusionsFromTargets	获取不以光线为目标的视觉对象的集合。 (继承自 CompositionLight)
ImplicitAnimations	附加到此对象的隐式动画集合。 (继承自 CompositionObject)
InnerConeAngle	SpotLight 的内锥角，以弧度表示为半垂直角度。 可动画处理。
InnerConeAngleInDegrees	SpotLight 的内锥角，表示为以度为单位的半垂直角度。 可动画处理。
InnerConeColor	聚光灯内部圆锥的颜色。 可动画处理。
InnerConeIntensity	获取或设置聚光内锥中的光线强度。
IsEnabled	获取或设置一个值，该值确定是否打开合成灯。 (继承自 CompositionLight)
LinearAttenuation	光衰减公式中的线性系数，用于确定光线如何随距离下降。 可动画处理。
MaxAttenuationCutoff	获取或设置此光有效的最大范围。
MinAttenuationCutoff	获取或设置此光有效时的最小范围。
Offset	光源相对于其 坐标空间 视觉对象的偏移量。 可动画处理。
OuterConeAngle	SpotLight 的外锥角度，以弧度表示为半垂直角度。 可动画处理。
OuterConeAngleInDegrees	SpotLight 外部锥形的半垂直角度（以度为单位）。 可动画处理。
OuterConeColor	聚光灯外锥的颜色。 可动画处理。
OuterConeIntensity	获取或设置聚光灯外锥中的光线强度。
Properties	与 CompositionObject 关联的属性的集合。 (继承自 CompositionObject)
QuadraticAttenuation	衰减公式的二次部分，用于确定光线如何随距离下降。 可动画处理。
Targets	以光线为目标的视觉对象的集合。 (继承自 CompositionLight)

方法

Close()	关闭 CompositionObject 并释放系统资源。 (继承自 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	连接和动画。 (继承自 CompositionObject)
DisconnectAnimation(String)	断开动画的连接。 (继承自 CompositionObject)
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定义可进行动画处理的属性。 (继承自 CompositionObject)
StartAnimation(String, CompositionAnimation)	使用 对象的指定属性连接动画并启动动画。 (继承自 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	使用 对象的指定属性连接动画并启动动画。 (继承自 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	启动动画组。 CompositionObject 上的 StartAnimationGroup 方法可用于启动 CompositionAnimationGroup。 组中的所有动画将同时在 对象上启动。 (继承自 CompositionObject)
StopAnimation(String)	断开动画与指定属性的连接并停止动画。 (继承自 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止动画组。 (继承自 CompositionObject)
TryGetAnimationController(String)	返回指定属性上运行的动画的 AnimationController。 (继承自 CompositionObject)

另请参阅

• CompositionLight
• Targets
• CreateSpotLight()