[page:Object3D] →

# [name]

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

## 代码示例

`const light = new THREE.HemisphereLight( 0xffffbb, 0x080820, 1 ); const helper = new THREE.HemisphereLightHelper( light, 5 ); scene.add( helper );`

## 构造函数

### [name]( [param:HemisphereLight light], [param:Number sphereSize], [param:Hex color] )

[page:HemisphereLight light] -- 被模拟的光源.
[page:Number size] -- 用于模拟光源的网格尺寸.
[page:Hex color] -- (可选的) 如果没有赋值辅助对象将使用光源的颜色.

## 属性

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

### [property:HemisphereLight light]

被模拟的半球形光源.

### [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:Object3D] 页面查看公共方法.

### [method:undefined dispose]()

销毁该半球形光源辅助对象.

### [method:undefined update]()

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

## 源码

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