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


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199
							<!DOCTYPE html>
<html lang="en">
	<head>
		<meta charset="utf-8" />
		<base href="../../" />
		<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">A point light that can cast shadow in one direction.</div>

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


		<h2>Example</h2>
		<div>[example:webgl_interactive_cubes_gpu interactive / cubes / gpu ]</div>
		<div>[example:webgl_interactive_draggablecubes interactive / draggablecubes ]</div>
		<div>[example:webgl_materials_bumpmap_skin materials / bumpmap / skin ]</div>
		<div>[example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic ]</div>
		<div>[example:webgl_morphtargets_md2 morphtargets / md2 ]</div>
		<div>[example:webgl_shading_physical shading / physical ]</div>

		<code>
		// white spotlight shining from the side, casting shadow

		var spotLight = new THREE.SpotLight( 0xffffff );
		spotLight.position.set( 100, 1000, 100 );

		spotLight.castShadow = true;

		spotLight.shadowMapWidth = 1024;
		spotLight.shadowMapHeight = 1024;

		spotLight.shadowCameraNear = 500;
		spotLight.shadowCameraFar = 4000;
		spotLight.shadowCameraFov = 30;

		scene.add( spotLight );
		</code>

		<div>
		[example:webgl_materials_bumpmap materials / bumpmap]<br/>
		[example:webgl_shading_physical shading / physical]<br/>
		[example:webgl_shadowmap shadowmap]<br/>
		[example:webgl_shadowmap_viewer shadowmap / performance]<br/>
		[example:webgl_shadowmap_viewer shadowmap / viewer]
		</div>


		<h2>Constructor</h2>


		<h3>[name]([page:Integer hex], [page:Float intensity], [page:Float distance], [page:Radians angle], [page:Float penumbra], [page:Float decay])</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. <br />
		[page:Float distance] -- Maximum distance from origin where light will shine whose intensity is attenuated linearly based on distance from origin. <br />
		[page:Radians angle] -- Maximum angle of light dispersion from its direction whose upper bound is Math.PI/2.<br />
		[page:Float penumbra] -- Percent of the spotlight cone that is attenuated due to penumbra. Takes values between zero and 1. Default is zero.<br />
		[page:Float decay] -- The amount the light dims along the distance of the light.
		</div>

		<h2>Properties</h2>

		<h3>[property:Object3D target]</h3>
		<div>
			Spotlight focus points at target.position.<br />
			Default position — *(0,0,0)*.<br />
			*Note*: Currently for target property to work properly, it must be part of the [page:Scene scene], e.g. this will help: <code>scene.add( light.target )</code>
		</div>

		<h3>[property:Float intensity]</h3>
		<div>
			Light's intensity.<br />
			In "physically correct" mode, the product of color * intensity is interpreted as luminous intensity measured in candela.<br/>
			Default — *1.0*.
		</div>

		<h3>[property:Float power]</h3>
		<div>
			Light's power.<br />
			In "physically correct" mode, the luminous power of the light measured in lumens.<br/>
			Default - *4PI*.
		</div>

		<h3>[property: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>[property:Float angle]</h3>
		<div>
			Maximum extent of the spotlight, in radians, from its direction. Should be no more than *Math.PI/2*.<br />
			Default — *Math.PI/3*.
		</div>

		<h3>[property:Float penumbra]</h3>
		<div>
			Percent of the spotlight cone that is attenuated due to penumbra. Takes values between zero and 1.<br />
			Default — *0.0*.
		</div>

		<h3>[property:Float decay]</h3>
		<div>
			The amount the light dims along the distance of the light<br />
			In "physically correct" mode, decay = 2 leads to physically realistic light falloff.<br/>
			Default — *1*.
		</div>

		<h3>[property: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>[property:Float shadowCameraNear]</h3>
		<div>
			Perspective shadow camera frustum <em>near</em> parameter.<br />
			Default — *50*.
		</div>

		<h3>[property:Float shadowCameraFar]</h3>
		<div>
			Perspective shadow camera frustum <em>far</em> parameter.<br />
			Default — *5000*.
		</div>

		<h3>[property:Float shadowCameraFov]</h3>
		<div>
			Perspective shadow camera frustum <em>field of view</em> parameter.<br />
			Default — *50*.
		</div>

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

		<h3>[property:Float shadowBias]</h3>
		<div>
			Shadow map bias, how much to add or subtract from the normalized depth when deciding whether a surface is in shadow.<br />
			Default — *0*.
		</div>

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

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

		<h3>[property:Vector2 shadowMapSize]</h3>
		<div>
			The shadowMapWidth and shadowMapHeight stored in a [page:Vector2 THREE.Vector2]. Set internally during rendering.
		</div>

		<h3>[property:PerspectiveCamera shadowCamera]</h3>
		<div>
			The shadow's view of the world. Computed internally during rendering from the shadowCamera* settings.
		</div>

		<h3>[property:Matrix4 shadowMatrix]</h3>
		<div>
			Model to shadow camera space, to compute location and depth in shadow map. Computed internally during rendering.
		</div>

		<h3>[property:WebGLRenderTarget shadowMap]</h3>
		<div>
		    The depth map generated using the shadowCamera; a location beyond a pixel's depth is in shadow. Computed internally during rendering.
		</div>

		<h2>Methods</h2>
		<h3>[method:SpotLight clone]()</h3>
		<div>
		<br />
		It returns a clone of SpotLight.
		</div>

		<h3>[method:JSON toJSON]()</h3>
		<div>
		Return SpotLight data in JSON format.
		</div>
		<h2>Source</h2>

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