Home Explore Help
Sign In
javascript
/
three.js
mirror of https://github.com/tazdij/three.js.git
2
0
Fork 0
Files Issues 0 Wiki
Browse Source

Docs: Add page for LightProbe.

Mugen87 5 years ago
parent
1e1f2624ab
commit
b7c13f89bc
3 changed files with 144 additions and 0 deletions
Unified View Show Diff Stats
  1. 71 0
      docs/api/en/lights/LightProbe.html
  2. 71 0
      docs/api/zh/lights/LightProbe.html
  3. 2 0
      docs/list.js

+ 71 - 0
docs/api/en/lights/LightProbe.html
View File 

@@ -0,0 +1,71 @@
 
+<!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>
 
+
 
+		<p class="desc">
 
+			Light probes are an alternative way of adding light to a 3D scene. Unlike classical light sources (e.g. directional,
 
+			point or spot lights), light probes do not emit light. Instead they store information about light passing through
 
+			3D space. During rendering, the light that hits a 3D object is approximated by using the data from the light probe.
 
+		</p>
 
+
 
+		<p class="desc">
 
+			Light probes are usually created from (radiance) environment maps. The class [page:LightProbeGenerator] can
 
+			be used to create light probes from instances of [page:CubeTexture] or [page:WebGLCubeRenderTarget].
 
+			However, light estimation data could also be provided in other forms e.g. by WebXR. This enables the rendering
 
+			of augmented reality content that reacts to real world lighting.
 
+		</p>
 
+
 
+		<p class="desc">
 
+			The current probe implementation in three.js only supports so called diffuse light probes. This type of light probe
 
+			is a different representation of an irradiance environment map. Other types of light probes like reflection probes
 
+			are not yet supported.
 
+		</p>
 
+
 
+		<h2>Examples</h2>
 
+		<p>
 
+			[example:webgl_lightprobe WebGL / light probe ]<br />
 
+			[example:webgl_lightprobe_cubecamera WebGL / light probe / cube camera ]
 
+		</p>
 
+
 
+		<h2>Constructor</h2>
 
+
 
+		<h3>[name]( [param:SphericalHarmonics3 sh], [param:Float intensity] )</h3>
 
+		<p>
 
+		[page:SphericalHarmonics3 sh] - (optional) An instance of [page:SphericalHarmonics3].<br />
 
+		[page:Float intensity] - (optional) Numeric value of the light probe's intensity. Default is 1.<br /><br />
 
+
 
+		Creates a new [name].
 
+		</p>
 
+
 
+		<h2>Properties</h2>
 
+		<p>
 
+				See the base [page:Light Light] class for common properties. The [page:Light.color color] property is currently
 
+				not evaluated and thus has no effect.
 
+		</p>
 
+
 
+		<h3>[property:SphericalHarmonics3 sh]</h3>
 
+		<p>
 
+			A light probe uses spherical harmonics to encode lighting information.
 
+		</p>
 
+
 
+		<h2>Methods</h2>
 
+		<p>
 
+				See the base [page:Light Light] class for common methods.
 
+		</p>
 
+		<h2>Source</h2>
 
+
 
+		<p>
 
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 
+		</p>
 
+	</body>
 
+</html>

+ 71 - 0
docs/api/zh/lights/LightProbe.html
View File 

@@ -0,0 +1,71 @@
 
+<!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>
 
+
 
+		<p class="desc">
 
+			Light probes are an alternative way of adding light to a 3D scene. Unlike classical light sources (e.g. directional,
 
+			point or spot lights), light probes do not emit light. Instead they store information about light passing through
 
+			3D space. During rendering, the light that hits a 3D object is approximated by using the data from the light probe.
 
+		</p>
 
+
 
+		<p class="desc">
 
+			Light probes are usually created from (radiance) environment maps. The class [page:LightProbeGenerator] can
 
+			be used to create light probes from instances of [page:CubeTexture] or [page:WebGLCubeRenderTarget].
 
+			However, light estimation data could also be provided in other forms e.g. by WebXR. This enables the rendering
 
+			of augmented reality content that reacts to real world lighting.
 
+		</p>
 
+
 
+		<p class="desc">
 
+			The current probe implementation in three.js only supports so called diffuse light probes. This type of light probe
 
+			is a different representation of an irradiance environment map. Other types of light probes like reflection probes
 
+			are not yet supported.
 
+		</p>
 
+
 
+		<h2>Examples</h2>
 
+		<p>
 
+			[example:webgl_lightprobe WebGL / light probe ]<br />
 
+			[example:webgl_lightprobe_cubecamera WebGL / light probe / cube camera ]
 
+		</p>
 
+
 
+		<h2>Constructor</h2>
 
+
 
+		<h3>[name]( [param:SphericalHarmonics3 sh], [param:Float intensity] )</h3>
 
+		<p>
 
+		[page:SphericalHarmonics3 sh] - (optional) An instance of [page:SphericalHarmonics3].<br />
 
+		[page:Float intensity] - (optional) Numeric value of the light probe's intensity. Default is 1.<br /><br />
 
+
 
+		Creates a new [name].
 
+		</p>
 
+
 
+		<h2>Properties</h2>
 
+		<p>
 
+				See the base [page:Light Light] class for common properties. The [page:Light.color color] property is currently
 
+				not evaluated and thus has no effect.
 
+		</p>
 
+
 
+		<h3>[property:SphericalHarmonics3 sh]</h3>
 
+		<p>
 
+			A light probe uses spherical harmonics to encode lighting information.
 
+		</p>
 
+
 
+		<h2>Methods</h2>
 
+		<p>
 
+				See the base [page:Light Light] class for common methods.
 
+		</p>
 
+		<h2>Source</h2>
 
+
 
+		<p>
 
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 
+		</p>
 
+	</body>
 
+</html>

+ 2 - 0
docs/list.js
View File 

@@ -205,6 +205,7 @@ var list = {
 
 				"DirectionalLight": "api/en/lights/DirectionalLight",
 
 				"DirectionalLight": "api/en/lights/DirectionalLight",
 
 				"HemisphereLight": "api/en/lights/HemisphereLight",
 
 				"HemisphereLight": "api/en/lights/HemisphereLight",
 
 				"Light": "api/en/lights/Light",
 
 				"Light": "api/en/lights/Light",
 
+				"LightProbe": "api/en/lights/LightProbe",
 
 				"PointLight": "api/en/lights/PointLight",
 
 				"PointLight": "api/en/lights/PointLight",
 
 				"RectAreaLight": "api/en/lights/RectAreaLight",
 
 				"RectAreaLight": "api/en/lights/RectAreaLight",
 
 				"SpotLight": "api/en/lights/SpotLight"
 
 				"SpotLight": "api/en/lights/SpotLight"
 
@@ -662,6 +663,7 @@ var list = {
 
 				"DirectionalLight": "api/zh/lights/DirectionalLight",
 
 				"DirectionalLight": "api/zh/lights/DirectionalLight",
 
 				"HemisphereLight": "api/zh/lights/HemisphereLight",
 
 				"HemisphereLight": "api/zh/lights/HemisphereLight",
 
 				"Light": "api/zh/lights/Light",
 
 				"Light": "api/zh/lights/Light",
 
+				"LightProbe": "api/zh/lights/LightProbe",
 
 				"PointLight": "api/zh/lights/PointLight",
 
 				"PointLight": "api/zh/lights/PointLight",
 
 				"RectAreaLight": "api/zh/lights/RectAreaLight",
 
 				"RectAreaLight": "api/zh/lights/RectAreaLight",
 
 				"SpotLight": "api/zh/lights/SpotLight"
 
 				"SpotLight": "api/zh/lights/SpotLight"