|
|
@@ -12,58 +12,17 @@
|
|
|
<h1>[name]</h1>
|
|
|
|
|
|
<p class="desc">
|
|
|
- 这在 [page:PointLight PointLights] 内部用于计算阴影，也可用作其他阴影类的基类。
|
|
|
+ 该类作为其他阴影类的基类来使用。
|
|
|
</p>
|
|
|
|
|
|
|
|
|
- <h2>例子</h2>
|
|
|
- <p>
|
|
|
- <code>
|
|
|
-//Create a WebGLRenderer and turn on shadows in the renderer
|
|
|
-var renderer = new THREE.WebGLRenderer();
|
|
|
-renderer.shadowMap.enabled = true;
|
|
|
-renderer.shadowMap.type = THREE.PCFSoftShadowMap; // default THREE.PCFShadowMap
|
|
|
-
|
|
|
-//Create a PointLight and turn on shadows for the light
|
|
|
-var light = new THREE.PointLight( 0xffffff, 1, 100 );
|
|
|
-light.position.set( 0, 10, 0 );
|
|
|
-light.castShadow = true; // default false
|
|
|
-scene.add( light );
|
|
|
-
|
|
|
-//Set up shadow properties for the light
|
|
|
-light.shadow.mapSize.width = 512; // default
|
|
|
-light.shadow.mapSize.height = 512; // default
|
|
|
-light.shadow.camera.near = 0.5; // default
|
|
|
-light.shadow.camera.far = 500 // default
|
|
|
-
|
|
|
-//Create a sphere that cast shadows (but does not receive them)
|
|
|
-var sphereGeometry = new THREE.SphereBufferGeometry( 5, 32, 32 );
|
|
|
-var sphereMaterial = new THREE.MeshStandardMaterial( { color: 0xff0000 } );
|
|
|
-var sphere = new THREE.Mesh( sphereGeometry, sphereMaterial );
|
|
|
-sphere.castShadow = true; //default is false
|
|
|
-sphere.receiveShadow = false; //default
|
|
|
-scene.add( sphere );
|
|
|
-
|
|
|
-//Create a plane that receives shadows (but does not cast them)
|
|
|
-var planeGeometry = new THREE.PlaneBufferGeometry( 20, 20, 32, 32 );
|
|
|
-var planeMaterial = new THREE.MeshStandardMaterial( { color: 0x00ff00 } )
|
|
|
-var plane = new THREE.Mesh( planeGeometry, planeMaterial );
|
|
|
-plane.receiveShadow = true;
|
|
|
-scene.add( plane );
|
|
|
-
|
|
|
-//Create a helper for the shadow camera (optional)
|
|
|
-var helper = new THREE.CameraHelper( light.shadow.camera );
|
|
|
-scene.add( helper );
|
|
|
- </code>
|
|
|
- </p>
|
|
|
-
|
|
|
<h2>构造函数</h2>
|
|
|
|
|
|
<h3>[name]( [param:Camera camera] )</h3>
|
|
|
<p>
|
|
|
[page:Camera camera] - 在光的世界里<br /><br />
|
|
|
|
|
|
- 创建一个新的[name]。这不能直接调用的 - 它由[page:PointLight]在内部调用，或者由其他阴影用作基类。
|
|
|
+ 创建一个新的[name]。这不能直接调用的 - 它由其他阴影用作基类。
|
|
|
</p>
|
|
|
|
|
|
<h2>属性</h2>
|
|
|
@@ -84,7 +43,6 @@ scene.add( helper );
|
|
|
使用内置摄像头生成的深度图;超出像素深度的位置在阴影中。在渲染期间内部计算。
|
|
|
</p>
|
|
|
|
|
|
-
|
|
|
<h3>[property:Vector2 mapSize]</h3>
|
|
|
<p>
|
|
|
一个[Page:Vector2]定义阴影贴图的宽度和高度。<br /><br />
|
|
|
@@ -113,9 +71,34 @@ scene.add( helper );
|
|
|
|
|
|
|
|
|
<h2>方法</h2>
|
|
|
+
|
|
|
+ <h3>[method:Vector2 getFrameExtents]()</h3>
|
|
|
+ <p>
|
|
|
+ Used internally by the renderer to extend the shadow map to contain all viewports
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:null updateMatrices]( [param:Light light], [param:Camera viewCamera], [param:number viewportIndex])</h3>
|
|
|
+ <p>
|
|
|
+ Update the matrices for the camera and shadow, used internally by the renderer.<br /><br />
|
|
|
+
|
|
|
+ light -- the light for which the shadow is being rendered.<br />
|
|
|
+ viewCamera -- the camera view for which the shadow is being rendered.<br />
|
|
|
+ viewportIndex -- calculates the matrix for this viewport
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:Frustum getFrustum]()</h3>
|
|
|
+ <p>
|
|
|
+ Gets the shadow cameras frustum. Used internally by the renderer to cull objects.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:number getViewportCount]()</h3>
|
|
|
+ <p>
|
|
|
+ Used internally by the renderer to get the number of viewports that need to be rendered for this shadow.
|
|
|
+ </p>
|
|
|
+
|
|
|
<h3>[method:LightShadow copy]( [param:LightShadow source] )</h3>
|
|
|
<p>
|
|
|
- 将[page:LightShadow]中的所有属性的值复制到 SpotLight。
|
|
|
+ 将[page:LightShadow source]中的所有属性的值复制到该Light。
|
|
|
</p>
|
|
|
|
|
|
<h3>[method:LightShadow clone]()</h3>
|
|
|
@@ -129,7 +112,8 @@ scene.add( helper );
|
|
|
</p>
|
|
|
|
|
|
<h2>源码</h2>
|
|
|
-
|
|
|
- [link:https://github.com/mrdoob/three.js/blob/master/src/lights/[name].js src/lights/[name].js]
|
|
|
+ <p>
|
|
|
+ [link:https://github.com/mrdoob/three.js/blob/master/src/lights/[name].js src/lights/[name].js]
|
|
|
+ </p>
|
|
|
</body>
|
|
|
</html>
|
gogoend