Răsfoiți Sursa

Docs: Update decay description. (#24941)

* Docs: Update decay description.

* Docs: Clean up.
Michael Herzog 2 ani în urmă
părinte
comite
877dccd24c

+ 4 - 6
docs/api/en/lights/PointLight.html

@@ -40,10 +40,9 @@ scene.add( light );
 		<h3>[name]( [param:Integer color], [param:Float intensity], [param:Number distance], [param:Float decay] )</h3>
 		<p>
 			[page:Integer color] - (optional) hexadecimal color of the light. Default is 0xffffff (white).<br />
-			[page:Float intensity] - (optional) numeric value of the light's strength/intensity. Default is 1.<br /><br />
+			[page:Float intensity] - (optional) numeric value of the light's strength/intensity. Default is 1.<br />
 			[page:Number distance] - Maximum range of the light. Default is 0 (no limit).<br />
-			[page:Float decay] - The amount the light dims along the distance of the light. Default is 1.
-			For [page:WebGLRenderer.physicallyCorrectLights physically correct] lighting, set this to 2.<br /><br />
+			[page:Float decay] - The amount the light dims along the distance of the light. Default is 2.<br /><br />
 
 			Creates a new [name].
 		</p>
@@ -55,9 +54,8 @@ scene.add( light );
 
 		<h3>[property:Float decay]</h3>
 		<p>
-			The amount the light dims along the distance of the light<br />
-			In [page:WebGLRenderer.physicallyCorrectLights physically correct] mode, decay = 2 leads to physically realistic light falloff.<br/>
-			Default is `1`.
+			The amount the light dims along the distance of the light. Default is `2`.<br />
+			In context of physically-correct rendering the default value should not be changed.
 		</p>
 
 		<h3>[property:Float distance]</h3>

+ 3 - 4
docs/api/en/lights/SpotLight.html

@@ -51,7 +51,7 @@
 		<h3>[name]( [param:Integer color], [param:Float intensity], [param:Float distance], [param:Radians angle], [param:Float penumbra], [param:Float decay] )</h3>
 		<p>
 			[page:Integer color] - (optional) hexadecimal color of the light. Default is 0xffffff (white).<br />
-			[page:Float intensity] - (optional) numeric value of the light's strength/intensity. Default is 1.<br /><br />
+			[page:Float intensity] - (optional) numeric value of the light's strength/intensity. Default is 1.<br />
 			[page:Float distance] - Maximum range of the light. Default is 0 (no limit).<br />
 			[page:Radians angle] - Maximum angle of light dispersion from its direction whose upper
 			bound is Math.PI/2.<br />
@@ -82,9 +82,8 @@
 
 		<h3>[property:Float decay]</h3>
 		<p>
-			The amount the light dims along the distance of the light.<br />
-			In [page:WebGLRenderer.physicallyCorrectLights physically correct] mode, decay = 2 leads to
-			physically realistic light falloff. The default is `1`.
+			The amount the light dims along the distance of the light. Default is `2`.<br />
+			In context of physically-correct rendering the default value should not be changed.
 		</p>
 
 		<h3>[property:Float distance]</h3>

+ 3 - 5
docs/api/it/lights/PointLight.html

@@ -42,8 +42,7 @@ scene.add( light );
 			[page:Integer color] - (opzionale) Il colore esadecimale della luce. Il valore predefinito è 0xffffff (bianco).<br />
 			[page:Float intensity] - (opzionale) Il valore numerico della forza/intensità della luce. Il valore predefinito è 1.<br />
 			[page:Number distance] - Portata massima della luce. Il valore predefinito è 0 (nessun limite).<br />
-			[page:Float decay] - La quantità di attenuazione della luce lungo la distanza della luce. Il valore predefinito è 1.
-			Per un'illuminazione [page:WebGLRenderer.physicallyCorrectLights fisicamente corretta], impostarlo a 2.<br /><br />
+			[page:Float decay] - La quantità di attenuazione della luce lungo la distanza della luce. Il valore predefinito è 2.<br /><br />
 
 			Crea una nuova [name].
 		</p>
@@ -55,9 +54,8 @@ scene.add( light );
 
 		<h3>[property:Float decay]</h3>
 		<p>
-			La quantità di attenuazione della luce lungo la distanza della luce.<br />
-			Nella modalità [page:WebGLRenderer.physicallyCorrectLights fisicamente corretta], decay = 2 porta ad una diminuzione della luce fisicamente realistica.<br/>
-			Il valore predefinito è `1`.
+			The amount the light dims along the distance of the light. Default is `2`.<br />
+			In context of physically-correct rendering the default value should not be changed.
 		</p>
 
 		<h3>[property:Float distance]</h3>

+ 3 - 4
docs/api/it/lights/SpotLight.html

@@ -51,7 +51,7 @@
 		<h3>[name]( [param:Integer color], [param:Float intensity], [param:Float distance], [param:Radians angle], [param:Float penumbra], [param:Float decay] )</h3>
 		<p>
 			[page:Integer color] - (opzionale) colore esadecimale della luce. Il valore predefinito è 0xffffff (bianco).<br />
-			[page:Float intensity] - (opzionale) il valore numerico della forza/intensità della luce. Il valore predefinito è 1.<br /><br />
+			[page:Float intensity] - (opzionale) il valore numerico della forza/intensità della luce. Il valore predefinito è 1.<br />
 			[page:Float distance] - Portata massima della luce. Il valore predefinito è 0 (nessun limite).<br />
 			[page:Radians angle] - Angolo massimo di dispersione della luce dalla sua direzione in cui il limite superiore è Math.PI/2.<br />
 			[page:Float penumbra] - Percentuale del cono del riflettore che viene attenuata a causa della penombra.
@@ -82,9 +82,8 @@
 
 		<h3>[property:Float decay]</h3>
 		<p>
-      La quantità di attenuazione della luce lungo la distanza della luce.<br />
-			Nella modalità [page:WebGLRenderer.physicallyCorrectLights fisicamente corretta], decay = 2 porta ad una diminuzione della luce fisicamente realistica.<br/>
-			Il valore predefinito è `1`.
+			The amount the light dims along the distance of the light. Default is `2`.<br />
+			In context of physically-correct rendering the default value should not be changed.
 		</p>
 
 		<h3>[property:Float distance]</h3>

+ 4 - 7
docs/api/zh/lights/PointLight.html

@@ -39,12 +39,10 @@
 		<h3>[name]( [param:Integer color], [param:Float intensity], [param:Number distance], [param:Float decay] )</h3>
 		<p>
 			[page:Integer color] - (可选参数)) 十六进制光照颜色。 缺省值 0xffffff (白色)。<br />
-			[page:Float intensity] - (可选参数) 光照强度。 缺省值 1。 <br /><br />
+			[page:Float intensity] - (可选参数) 光照强度。 缺省值 1。 <br />
 			[page:Number distance] - 这个距离表示从光源到光照强度为0的位置。
 			当设置为0时,光永远不会消失(距离无穷大)。缺省值 0.<br />
-			[page:Float decay] - 沿着光照距离的衰退量。缺省值 1。
-
-			在 [page:WebGLRenderer.physicallyCorrectLights physically correct] 模式中,decay = 2。<br /><br />
+			[page:Float decay] - 沿着光照距离的衰退量。缺省值 2。<br /><br />
 
 			创建一个新的点光源(PointLight)。
 		</p>
@@ -56,9 +54,8 @@
 
 		<h3>[property:Float decay]</h3>
 		<p>
-			沿着光照距离的衰减量<br />
-			在 [page:WebGLRenderer.physicallyCorrectLights physically correct] 模式下,decay 设置为等于2将实现现实世界的光衰减。<br/>
-			缺省值为 *1*。
+			The amount the light dims along the distance of the light. Default is `2`.<br />
+			In context of physically-correct rendering the default value should not be changed.
 		</p>
 
 		<h3>[property:Float distance]</h3>

+ 3 - 4
docs/api/zh/lights/SpotLight.html

@@ -50,7 +50,7 @@
 		<h3>[name]( [param:Integer color], [param:Float intensity], [param:Float distance], [param:Radians angle], [param:Float penumbra], [param:Float decay] )</h3>
 		<p>
 			[page:Integer color] - (可选参数) 十六进制光照颜色。 缺省值 0xffffff (白色)。<br />
-			[page:Float intensity] - (可选参数) 光照强度。 缺省值 1。<br /><br />
+			[page:Float intensity] - (可选参数) 光照强度。 缺省值 1。<br />
 			[page:Float distance] - 从光源发出光的最大距离,其强度根据光源的距离线性衰减。 <br />
 			[page:Radians angle] - 光线散射角度,最大为Math.PI/2。<br />
 			[page:Float penumbra] - 聚光锥的半影衰减百分比。在0和1之间的值。默认为0。<br />
@@ -78,9 +78,8 @@
 
 		<h3>[property:Float decay]</h3>
 		<p>
-			沿着光照距离的衰减量<br />
-			在 [page:WebGLRenderer.physicallyCorrectLights physically correct] 模式下,decay 设置为等于2将实现现实世界的光衰减。<br/>
-			缺省值为 *1*。
+			The amount the light dims along the distance of the light. Default is `2`.<br />
+			In context of physically-correct rendering the default value should not be changed.
 		</p>
 
 		<h3>[property:Float distance]</h3>