three.js/docs/api/lights/DirectionalLight.html

[page:Object3D] → [page:Light] →

<h1>[name]</h1>

<div class="desc">
	Affects objects using [page:MeshLambertMaterial] or [page:MeshPhongMaterial].
</div>


<h2>Example</h2>

<code>// White directional light at half intensity shining from the top.

var directionalLight = new THREE.DirectionalLight( 0xffffff, 0.5 );
directionalLight.position.set( 0, 1, 0 );
scene.add( directionalLight );</code>


<h2>Constructor</h2>

<h3>[name]( [page:Float hex], [page:Float intensity], [page:Float distance] )</h3>


<h2>Properties</h2>

<h3>.[page:Vector3 position]</h3>
<div>
	Direction of the light is normalized vector from *position* to *(0,0,0)*.<br />
	Default — *new THREE.Vector3()*.
</div>

<h3>.[page:Object3D target]</h3>
<div>
	Target used for shadow camera orientation.
</div>

<h3>.[page:Float intensity]</h3>
<div>
	Light's intensity.<br />
	Default — *1.0*.
</div>

<h3>.[page:Float distance]</h3>
<div>
	If non-zero, light will attenuate linearly from maximum intensity at light *position* down to zero at *distance*.<br />
	Default — *0.0*.
</div>

<h3>.[page:Boolean castShadow]</h3>
<div>
	If set to *true* light will cast dynamic shadows. *Warning*: This is expensive and requires tweaking to get shadows looking right.<br />
	Default — *false*.
</div>

<h3>.[page:Boolean onlyShadow]</h3>
<div>
	If set to *true* light will only cast shadow but not contribute any lighting (as if *intensity* was 0 but cheaper to compute).<br />
	Default — *false*.
</div>

<h3>.[page:Float shadowCameraNear]</h3>
<div>
	Orthographic shadow camera frustum parameter.<br />
	Default — *50*.
</div>

<h3>.[page:Float shadowCameraFar]</h3>
<div>
	Orthographic shadow camera frustum parameter.<br />
	Default — *5000*.
</div>

<h3>.[page:Float shadowCameraLeft]</h3>
<div>
	Orthographic shadow camera frustum parameter.<br />
	Default — *-500*.
</div>

<h3>.[page:Float shadowCameraRight]</h3>
<div>
	Orthographic shadow camera frustum parameter.<br />
	Default — *500*.
</div>

<h3>.[page:Float shadowCameraTop]</h3>
<div>
	Orthographic shadow camera frustum parameter.<br />
	Default — *500*.
</div>

<h3>.[page:Float shadowCameraBottom]</h3>
<div>
	Orthographic shadow camera frustum parameter.<br />
	Default — *-500*.
</div>

<h3>.[page:Boolean shadowCameraVisible]</h3>
<div>
	Show debug shadow camera frustum.<br />
	Default — *false*.
</div>

<h3>.[page:Float shadowBias]</h3>
<div>
	Shadow map bias.<br />
	Default — *0*.
</div>

<h3>.[page:Float shadowDarkness]</h3>
<div>
	Darkness of shadow casted by this light (from *0* to *1*).<br />
	Default — *0.5*.
</div>

<h3>.[page:Integer shadowMapWidth]</h3>
<div>
	Shadow map texture width in pixels.<br />
	Default — *512*.
</div>

<h3>.[page:Integer shadowMapHeight]</h3>
<div>
	Shadow map texture height in pixels.<br />
	Default — *512*.
</div>

<h3>.[page:Boolean shadowCascade]</h3>

<h3>.[page:Vector3 shadowCascadeOffset]</h3>

<h3>.[page:Integer shadowCascadeCount]</h3>

<h3>.[page:Array shadowCascadeBias]</h3>

<h3>.[page:Array shadowCascadeWidth]</h3>

<h3>.[page:Array shadowCascadeHeight]</h3>

<h3>.[page:Array shadowCascadeNearZ]</h3>

<h3>.[page:Array shadowCascadeFarZ]</h3>

<h3>.[page:Array shadowCascadeArray]</h3>

<h3>.[page:RenderTarget shadowMap]</h3>

<h3>.[page:Integer shadowMapSize]</h3>

<h3>.[page:Camera shadowCamera]</h3>

<h3>.[page:Matrix shadowMatrix]</h3>


<h2>Source</h2>

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