Browse Source

zh doc: translate some page about the light probe.

gogoend 5 years ago
parent
commit
5df6f5e82a

+ 10 - 10
docs/api/zh/lights/AmbientLightProbe.html

@@ -10,33 +10,33 @@
 	<body>
 		[page:Object3D] &rarr; [page:Light] &rarr; [page:LightProbe]
 
-		<h1>[name]</h1>
+		<h1>环境光探针([name]</h1>
 
 		<p class="desc">
-			Light probes are an alternative way of adding light to a 3D scene. AmbientLightProbe is the light estimation data 
-			of a single ambient light in the scene. For more information about light probes, go to [page:LightProbe].
+			光照探针是一种在3D场景中添加光源的另一种方法。 AmbientLightProbe 是场景中单个环境光的光照估算数据。
+			有关光照探针的更多信息,请转到 [page:LightProbe] 。
 		</p>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name]( [param:Color color], [param:Float intensity] )</h3>
 		<p>
-		[page:Color color] - (optional) An instance of Color, string representing a color or a number representing a color.<br />
-		[page:Float intensity] - (optional) Numeric value of the light probe's intensity. Default is 1.<br /><br />
+		[page:Color color] - (可选)一个表示颜色的 Color 的实例、字符串或数字。<br />
+		[page:Float intensity] - (可选)光照探针强度的数值。默认值为1。<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name]。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 		<p>
 				See the base [page:LightProbe LightProbe] class for common properties.
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 		<p>
 				See the base [page:LightProbe LightProbe] class for common methods.
 		</p>
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		<p>
 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

+ 11 - 11
docs/api/zh/lights/HemisphereLightProbe.html

@@ -10,34 +10,34 @@
 	<body>
 		[page:Object3D] &rarr; [page:Light] &rarr; [page:LightProbe]
 
-		<h1>[name]</h1>
+		<h1>半球光探针[name]</h1>
 
 		<p class="desc">
-			Light probes are an alternative way of adding light to a 3D scene. HemisphereLightProbe is the light estimation data 
-			of a single hemisphere light in the scene. For more information about light probes, go to [page:LightProbe].
+			光照探针是一种在3D场景中添加光源的另一种方法。 HemisphereLightProbe 是场景中单个半球光的光照估算数据。
+			有关光照探针的更多信息,请转到 [page:LightProbe] 。
 		</p>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name]( [param:Color skyColor], [param:Color groundColor], [param:Float intensity] )</h3>
 		<p>
-			[page:Color skyColor] - (optional) An instance of Color, string representing a color or a number representing a color.<br />
-			[page:Color groundColor] - (optional) An instance of Color, string representing a color or a number representing a color.<br />
-			[page:Float intensity] - (optional) Numeric value of the light probe's intensity. Default is 1.<br /><br />
+			[page:Color skyColor] - (可选)一个表示颜色的 Color 的实例、字符串或数字。<br />
+			[page:Color groundColor] - (可选)一个表示颜色的 Color 的实例、字符串或数字。<br />
+			[page:Float intensity] - (可选)光照探针强度的数值。默认值为1。<br /><br />
 
-			Creates a new [name].
+			创建一个新的 [name]。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 		<p>
 				See the base [page:LightProbe LightProbe] class for common properties.
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 		<p>
 				See the base [page:LightProbe LightProbe] class for common methods.
 		</p>
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		<p>
 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

+ 21 - 21
docs/api/zh/lights/LightProbe.html

@@ -10,58 +10,58 @@
 	<body>
 		[page:Object3D] &rarr; [page:Light] &rarr;
 
-		<h1>[name]</h1>
+		<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.
+			光照探针是一种在3D场景中添加光源的另一种方法。与经典光源(平行光、点光、聚光)不同,
+			光照探针不发光。相反,光照探针存储着有关穿过3D空间的光线的信息。
+			渲染过程中,通过使用来自光照探针的数据,来逼近打到3D物体上的光线。
 		</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.
+			光照探针通常从(辐射)环境贴图中创建。 [page:LightProbeGenerator] 类可以根据 [page:CubeTexture] 或
+			[page:WebGLCubeRenderTarget] 的实例来创建光照探针。
+			但是,光照估算数据同样可以以其他形式提供,例如,通过WebXR。
+			这将能够渲染可对真实世界的光照做出反应的增强现实内容。
 		</p>
 
 		<p class="desc">
-			The current probe implementation in three.js supports so-called diffuse light probes. This type of light probe
-			is functionally equivalent to an irradiance environment map.
+			three.js中,当前的探针实现支持所谓的漫反射光照探针。
+			这种类型的光照探针功能上等效于辐照环境贴图。
 		</p>
 
-		<h2>Examples</h2>
+		<h2>例子</h2>
 		<p>
 			[example:webgl_lightprobe WebGL / light probe ]<br />
 			[example:webgl_lightprobe_cubecamera WebGL / light probe / cube camera ]
 		</p>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</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 />
+		[page:SphericalHarmonics3 sh] - (可选)一个[page:SphericalHarmonics3]的实例。<br />
+		[page:Float intensity] - (可选)光照探针强度的数值。默认值为1。<br /><br />
 
-		Creates a new [name].
+		创建一个新的 [name] 。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</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.
+				See the base [page:Light Light] class for common properties. 
+				[page:Light.color color] 属性当前未做评估,因此不生效。
 		</p>
 
 		<h3>[property:SphericalHarmonics3 sh]</h3>
 		<p>
-			A light probe uses spherical harmonics to encode lighting information.
+			光照探针使用球面谐波(spherical harmonic)来编码光照信息。
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 		<p>
 				See the base [page:Light Light] class for common methods.
 		</p>
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		<p>
 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

+ 10 - 10
docs/examples/zh/helpers/LightProbeHelper.html

@@ -13,7 +13,7 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Renders a sphere to visualize a light probe in the scene.
+			在场景中渲染一个球来可视化光照探针。
 		<p>
 
 		<h2>代码示例</h2>
@@ -27,33 +27,33 @@
 
 		<p>[example:webgl_lightprobe_cubecamera WebGL / lightprobe / cubecamera]</p>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 
 		<h3>[name]( [param:LightProbe lightProbe], [param:Number size] )</h3>
 		<p>
-		[page:LightProbe lightProbe] -- the light probe.<br />
-		[page:Number size] -- size of the helper sphere
+		[page:LightProbe lightProbe] -- 光照探针。<br />
+		[page:Number size] -- 辅助球体的大小。
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 		<p>See the base [page:Mesh] class for common properties.</p>
 
 		<h3>[property:LightProbe lightProbe]</h3>
-		<p>The light probe.</p>
+		<p>光照探针。</p>
 
 		<h3>[property:Number size]</h3>
-		<p>The size of the helper sphere.</p>
+		<p>辅助球体的大小。</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 		<p>See the base [page:Mesh] class for common methods.</p>
 
 		<h3>[method:null dispose]()</h3>
-		<p>Frees internal resources.</p>
+		<p>释放内部资源。</p>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		<p>
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/helpers/LightProbeHelper.js examples/jsm/helpers/LightProbeHelper.js]

+ 8 - 8
docs/examples/zh/lights/LightProbeGenerator.html

@@ -9,35 +9,35 @@
 	</head>
 	<body>
 
-		<h1>[name]</h1>
+		<h1>光照探针生成器([name]</h1>
 
 		<p class="desc">
-			Utility class for creating instances of [page:LightProbe].
+			用于创建 [page:LightProbe] 实例的工具类。
 		</p>
 
-		<h2>Examples</h2>
+		<h2>例子</h2>
 
 		<p>
 			[example:webgl_lightprobe WebGL / light probe ]<br />
 			[example:webgl_lightprobe_cubecamera WebGL / light probe / cube camera ]
 		</p>
 
-		<h2>Static Methods</h2>
+		<h2>静态方法</h2>
 
 		<h3>[method:LightProbe fromCubeTexture] ( [param:CubeTexture cubeTexture] )</h3>
 		<p>
-			Creates a light probe from the given (radiance) environment map. The method expects that the environment map is represented as a cube texture.
+			从传入的(辐射)环境贴图创建一个光照探针。该方法期望将环境贴图表示为一个立方体纹理。
 		</p>
 
 		<h3>[method:LightProbe fromCubeRenderTarget] ( [param:WebGLRenderer renderer], [param:WebGLCubeRenderTarget cubeRenderTarget] )</h3>
 		<p>
-			Creates a light probe from the given (radiance) environment map. The method expects that the environment map is represented as a cube render target.
+			从传入的(辐射)环境贴图创建一个光照探针。该方法期望将环境贴图表示为一个立方体渲染目标。
 		</p>
 		<p>
-			The [page:Texture.format format] of the cube render target must be set to *RGBA*.
+			立方体渲染目标的 [page:Texture.format format] 必须被设为 *RGBA*。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		<p>
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/lights/LightProbeGenerator.js examples/jsm/lights/LightProbeGenerator.js]