PointLight 类

定义

一种点光源,可向所有方向发出光。

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 : CompositionLight
Public NotInheritable Class PointLight
Inherits CompositionLight
继承
Object Platform::Object IInspectable CompositionObject CompositionLight PointLight
属性

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

用于创建此 CompositionObjectCompositor

(继承自 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)

适用于

另请参阅