javascript
/
three.js
mirror of https://github.com/tazdij/three.js.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213
							<!DOCTYPE html>
<html lang="en">
	<head>
		<meta charset="utf-8" />
		<script src="../../list.js"></script>
		<script src="../../page.js"></script>
		<link type="text/css" rel="stylesheet" href="../../page.css" />
	</head>
	<body>
		[page:Object3D] &rarr; [page:Light] &rarr;

		<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:Integer hex], [page:Float intensity])</h3>
		<div>
		[page:Integer hex] -- Numeric value of the RGB component of the color. <br />
		[page:Float intensity] -- Numeric value of the light's strength/intensity.
		</div>
		<div>
		Creates a light that shines from a specific direction not from a specific position.  This light will behave
		as though it is infinitely far away and the rays produced from it are all parallel.  The best
		analogy would be a light source that acts like the sun: the sun is so far away that all sunlight
		hitting objects comes from the same angle.
		</div>

		<h2>Properties</h2>

		<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: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>
		<div>
			??? <br />
			Default — *false*.
		</div>

		<h3>.[page:Vector3 shadowCascadeOffset]</h3>
		<div>
			??? <br />
			Default — *Three.Vector3( 0, 0, -1000 )*.
		</div>

		<h3>.[page:Integer shadowCascadeCount]</h3>
		<div>
			??? <br />
			Default — *2*.
		</div>

		<h3>.[page:Array shadowCascadeBias]</h3>
		<div>
			??? <br />
			Default — <strong>[ 0, 0, 0 ]</strong>.
		</div>

		<h3>.[page:Array shadowCascadeWidth]</h3>
		<div>
			??? <br />
			Default — <strong>[ 512, 512, 512 ]</strong>.
		</div>

		<h3>.[page:Array shadowCascadeHeight]</h3>
		<div>
			??? <br />
			Default — <strong>[ 512, 512, 512 ]</strong>.
		</div>

		<h3>.[page:Array shadowCascadeNearZ]</h3>
		<div>
			??? <br />
			Default — <strong>[ -1.000, 0.990, 0.998 ]</strong>.
		</div>

		<h3>.[page:Array shadowCascadeFarZ]</h3>
		<div>
			??? <br />
			Default — <strong>[ 0.990, 0.998, 1.000 ]</strong>.
		</div>

		<h3>.[page:Array shadowCascadeArray]</h3>
		<div>
			??? <br />
			Default — <strong>[ ]</strong>.
		</div>

		<h3>.[page:RenderTarget shadowMap]</h3>
		<div>
			??? <br />
			Default — *null*.
		</div>

		<h3>.[page:Integer shadowMapSize]</h3>
		<div>
			??? <br />
			Default — *null*.
		</div>

		<h3>.[page:Camera shadowCamera]</h3>
		<div>
			??? <br />
			Default — *null*.
		</div>

		<h3>.[page:Matrix shadowMatrix]</h3>
		<div>
			??? <br />
			Default — *null*.
		</div>
		
		<h2>Methods</h2>


		<h2>Source</h2>

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