[page:Object3D] → [page:Mesh] →

# [name]

创建一个虚拟的球形网格 [page:Mesh] 的辅助对象来模拟 点光源 [page:PointLight].

## 代码示例

`const pointLight = new THREE.PointLight( 0xff0000, 1, 100 ); pointLight.position.set( 10, 10, 10 ); scene.add( pointLight ); const sphereSize = 1; const pointLightHelper = new THREE.PointLightHelper( pointLight, sphereSize ); scene.add( pointLightHelper );`

## 例子

[example:webgl_helpers WebGL / helpers]

## 构造函数

### [name]( [param:PointLight light], [param:Float sphereSize], [param:Hex color] )

[page:PointLight light] -- 要模拟的光源.
[page:Float sphereSize] -- (可选的) 球形辅助对象的尺寸. 默认为 *1*.
[page:Hex color] -- (可选的) 如果没有赋值辅助对象将使用光源的颜色.

## 属性

请到基类 [page:Mesh] 页面查看公共属性.

### [property:PointLight light]

被模拟的点光源 [page:PointLight] .

### [property:Object matrix]

请参考点光源的世界矩阵 [page:Object3D.matrixWorld matrixWorld].

### [property:Object matrixAutoUpdate]

请查看 [page:Object3D.matrixAutoUpdate]. 这里设置为 *false* 表示辅助对象 使用点光源的 [page:Object3D.matrixWorld matrixWorld].

### [property:hex color]

构造函数中传入的颜色值. 默认为 *undefined*. 如果改变该值, 辅助对象的颜色将在下一次 [page:.update update] 被调用时更新.

## 方法

请到基类 [page:Mesh] 页面查看公共方法.

### [method:undefined dispose]()

销毁该点光源辅助对象.

### [method:undefined update]()

更新辅助对象，与 [page:.light] 属性的位置保持一致.

## 源码

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]