PointLight

继承自Light

点光源，从一个点向各个方向发射的光源。如一个灯泡发出的光。

该光源可以投射阴影 - 跳转至 PointLightShadow 查看更多细节。

1.构造函数

PointLight( 
    color: THREE.Color, 
    intensity: Float,
    distance: Number,
    decay: Float
)

参数：

• color-（可选）一个表示颜色的 Color 的实例、字符串或数字，默认为一个白色（0xffffff）的 Color 对象。
• distance - 光源照射的最大距离。默认值为 0（无限远）。
• intensity -（可选）光照强度。默认值为 1。
• decay - 沿着光照距离的衰退量。默认值为 2。

const light = new THREE.PointLight( 0xff0000, 1, 100 );
light.position.set( 50, 50, 50 );
scene.add( light );

2.属性

公共属性请查看基类 Light。

castShadow

类型：Boolean

此属性设置为 true 灯光将投射阴影。

注意：这样做的代价比较高，需要通过调整让阴影看起来正确。 查看 PointLightShadow 了解详细信息。 默认值为 false。

decay

类型：Float

光线随着距离增加变暗的衰减量。默认值为 2。 在物理正确渲染的上下文中，不应更改默认值。

distance

类型：Float

当值为零时，光线将根据平方反比定律衰减到无限远。 当值不为零时，光线会先按照平方反比定律衰减，直到距离截止点附近，然后线性衰减到 0。

默认值为 0.0。

intensity

类型：Float

光源的强度。默认值为 1。 单位是坎德拉（cd）。

改变该值会影响到 power 的值。

power

类型：Float

光源的功率。 单位为流明（lm）。

改变该值会影响到 intensity 的值。

shadow

类型：PointLightShadow

PointLightShadow 对象，用与计算此光照的阴影。

此对象的摄像机为：一个 fov 值为90度、aspect 值为 1、 near 值为 0、far 值为 500 的透视摄像机（PerspectiveCamera）。

3.方法

公共方法请查看基类 Light。

dispose()

作用：释放由该实例分配的 GPU 相关资源。 当这个实例不再在你的应用中使用时，调用这个方法。

语法：

pointLight.dispose(): undefined

copy()

将所有属性的值从源 source 复制到此点光源对象。

语法：

pointLight.copy(): undefined