PointLight 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
一种点光源，可向所有方向发出光。
public ref class PointLight 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 PointLight 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 PointLight : CompositionLightPublic NotInheritable Class PointLight
Inherits CompositionLight- 继承
- 属性
Windows 要求
| 设备系列 |
Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v3.0 中引入)
|
注解
PointLight 在所有方向上均匀地发光。
PointLight 是派生自 CompositionLight 的四种光类型之一。
| 亮 | 说明 |
|---|---|
| AmbientLight | 发出非定向光的光源，该光似乎已由场景中的所有内容反射。 |
| DistantLight | 在一个方向上发出光的无限远的光源。 |
| PointLight | 在所有方向上发出光的点光源。 |
| SpotLight | 发出内部和外部光锥的光源。 |
注意
一个视觉对象不能被两个以上的非环境光 (PointLight、SpotLight 或 DistantLight) 作为目标。
版本历史记录
| Windows 版本 | SDK 版本 | 增值 |
|---|---|---|
| 1709 | 16299 | 强度 |
| 1803 | 17134 | MaxAttenuationCutoff |
| 1803 | 17134 | MinAttenuationCutoff |
属性
| Color |
光的颜色。 |
| Comment |
要与 CompositionObject 关联的字符串。 (继承自 CompositionObject) |
| Compositor |
用于创建此 CompositionObject 的 Compositor。 (继承自 CompositionObject) |
| ConstantAttenuation |
光衰减等式中的常量系数。 控制光强度。 |
| CoordinateSpace |
用于确定光线偏移量的视觉对象。 光的偏移量属性相对于此视觉对象的坐标空间。 PointLight.CoordinateSpace 是必需属性。 如果未设置 PointLight.CoordinateSpace ，则 PointLight 将不会呈现。 |
| Dispatcher |
CompositionObject 的调度程序。 (继承自 CompositionObject) |
| DispatcherQueue |
获取 CompostionObject 的 DispatcherQueue 。 (继承自 CompositionObject) |
| ExclusionsFromTargets |
获取不以光线为目标的视觉对象的集合。 (继承自 CompositionLight) |
| ImplicitAnimations |
附加到此 对象的隐式动画的集合。 (继承自 CompositionObject) |
| Intensity |
获取或设置光线的强度。 |
| IsEnabled |
获取或设置一个值，该值确定合成灯是否亮起。 (继承自 CompositionLight) |
| LinearAttenuation |
光衰减等式中的线性系数，用于确定光如何随距离下降。 |
| MaxAttenuationCutoff |
获取或设置此光有效的最大范围。 |
| MinAttenuationCutoff |
获取或设置此光有效时的最小范围。 |
| Offset |
光源相对于其坐标空间视觉对象的偏移量。 |
| 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) |