SpotLight 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
投射内外锥光的光源。 例如，手电筒。
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 : CompositionLightPublic NotInheritable Class SpotLight
Inherits CompositionLight- 继承
- 属性
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, AnimationController) |
使用 对象的指定属性连接动画并启动动画。 (继承自 CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
使用 对象的指定属性连接动画并启动动画。 (继承自 CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
启动动画组。 CompositionObject 上的 StartAnimationGroup 方法可用于启动 CompositionAnimationGroup。 组中的所有动画将同时在 对象上启动。 (继承自 CompositionObject) |
| StopAnimation(String) |
断开动画与指定属性的连接并停止动画。 (继承自 CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
停止动画组。 (继承自 CompositionObject) |
| TryGetAnimationController(String) |
返回指定属性上运行的动画的 AnimationController。 (继承自 CompositionObject) |