[page:Object3D] →

# [name]

Oggetto di supporto per aiutare a visualizzare l'effetto di una [page:DirectionalLight] nella scena. Consiste in un piano e una linea che rappresentano la posizione e la direzione della luce.

## Codice di Esempio

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

## Costruttore

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

[page:DirectionalLight light]-- La luce da visualizzare.
[page:Number size] -- (opzionale) le dimensioni del piano. Il valore predefinito è `1`.
[page:Hex color] -- (opzionale) se non è impostato l'helper prenderà il colore della luce.

## Proprietà

Vedi la classe base [page:Object3D] per le proprietà in comune.

### [property:Line lightPlane]

Contiene la mesh della linea che mostra la posizione della luce direzionale.

### [property:DirectionalLight light]

Riferimento alla [page:DirectionalLight directionalLight] da visualizzare.

### [property:Object matrix]

Riferimento alla [page:Object3D.matrixWorld matrixWorld] della luce.

### [property:Object matrixAutoUpdate]

Vedi [page:Object3D.matrixAutoUpdate]. In questo caso è impostato su `false`, poiché l'helper sta usando [page:Object3D.matrixWorld matrixWorld] della telecamera.

### [property:hex color]

Il parametro colore passato nel costruttore. Il valore predefinito è `undefined`. Se viene modificato, il colore dell'helper sarà aggiornato la prossima volta che il metodo [page:.update update] venga chiamato.

## Metodi

Vedi la classe base [page:Object3D] per i metodi comuni.

### [method:undefined dispose]()

Elimina il directionalLightHelper.

### [method:undefined update]()

Aggiorna l'helper in modo che corrisponda alla posizione e alla direzione della [page:.light directionalLight] visualizzata.

## Source

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