[page:Object3D] →

# [name]

用于模拟场景中平行光 [page:DirectionalLight] 的辅助对象. 其中包含了表示光位置的平面和表示光方向的线段.

## 代码示例

`const light = new THREE.DirectionalLight( 0xFFFFFF ); scene.add( light ); const helper = new THREE.DirectionalLightHelper( light, 5 ); scene.add( helper );`

## 构造函数

### [name]( [param:DirectionalLight light], [param:Number size], [param:Hex color] )

[page:DirectionalLight light]-- 被模拟的光源.
[page:Number size] -- (可选的) 平面的尺寸. 默认为 *1*.
[page:Hex color] -- (可选的) 如果没有设置颜色将使用光源的颜色.

## 属性

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

### [property:Line lightPlane]

包含表示平行光方向的线网格.

### [property:DirectionalLight light]

被模拟的光源. 请参考 [page:DirectionalLight directionalLight] .

### [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 directionalLight] 光源的位置和方向保持一致.

## 源码

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