WebGLRenderer: Deprecate useLegacyLights, change default to false. (

#26392)

docs/api/ar/lights/Light.html

@@ -40,7 +40,6 @@ <h3>[property:Color color]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
 		شدة الضوء ، أو قوته.<br />
-		عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode] ،
 		وحدات الشدة تعتمد على نوع الضوء.<br />
 		الافتراضي - `1.0`.
 		</p>

docs/api/ar/lights/PointLight.html

@@ -71,12 +71,6 @@ <h3>[property:Float decay]</h3>
 
 		<h3>[property:Float distance]</h3>
 		<p>
-		`الوضع الافتراضي` - عندما تكون المسافة صفرًا ، لا يتلاشى الضوء. عندما
-		تكون المسافة غير صفرية ، سيتلاشى الضوء بشكل خطي من أقصى شدة
-		عند موقع الضوء إلى الصفر على هذه المسافة من الضوء.
-		</p>
-		<p>
-		عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode] -
 		عندما تكون المسافة صفرًا ، سيتلاشى الضوء وفقًا لقانون المربع المعكوس
 		إلى مسافة لانهائية. عندما تكون المسافة غير صفرية ، سيتلاشى الضوء
 		وفقًا لقانون المربع المعكوس حتى قرب نقطة قطع المسافة ، حيث
@@ -87,7 +81,6 @@ <h3>[property:Float distance]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
 		شدة الضوء. القيمة الافتراضية هي `1`.<br />
-		عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
 		الشدة هي شدة إضاءة الضوء المقاسة بالشمعات
 		(cd).<br /><br />
 
@@ -97,7 +90,6 @@ <h3>[property:Float intensity]</h3>
 		<h3>[property:Float power]</h3>
 		<p>
 		قوة الضوء.<br />
-		عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
 		الطاقة هي قوة إضاءة الضوء المقاسة باللومن (lm).
 		<br /><br />
 

docs/api/ar/lights/RectAreaLight.html

@@ -72,7 +72,6 @@ <h3>[property:Float height]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
 		شدة الضوء. القيمة الافتراضية هي `1`.<br />
-		عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
 		الشدة هي الإضاءة (السطوع) للضوء المقاسة بالنيتات
 		(cd/m^2).<br /><br />
 
@@ -85,7 +84,6 @@ <h3>[property:Boolean isRectAreaLight]</h3>
 		<h3>[property:Float power]</h3>
 		<p>
 		قوة الضوء.<br />
-		عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
 		الطاقة هي قوة إضاءة الضوء المقاسة باللومن (lm).
 		<br /><br />
 

docs/api/ar/lights/SpotLight.html

@@ -89,12 +89,6 @@ <h3>[property:Float decay]</h3>
 
 		<h3>[property:Float distance]</h3>
 		<p>
-		`الوضع الافتراضي` - عندما تكون المسافة صفرًا ، لا يتلاشى الضوء. عندما
-		تكون المسافة غير صفرية ، سيتلاشى الضوء بشكل خطي من أقصى شدة
-		عند موقع الضوء إلى الصفر على هذه المسافة من الضوء.
-		</p>
-		<p>
-		عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode] -
 		عندما تكون المسافة صفرًا ، سيتلاشى الضوء وفقًا لقانون المربع المعكوس
 		إلى مسافة لانهائية. عندما تكون المسافة غير صفرية ، سيتلاشى الضوء
 		وفقًا لقانون المربع المعكوس حتى قرب نقطة قطع المسافة ، حيث
@@ -105,9 +99,7 @@ <h3>[property:Float distance]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
 		شدة الضوء. القيمة الافتراضية هي `1`.<br />
-		عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
-		الشدة هى شدة إضاءة الضوء المقاسة بالشمعات
-		(cd).<br /><br />
+		الشدة هى شدة إضاءة الضوء المقاسة بالشمعات(cd).<br /><br />
 		تغيير الشدة سيغير أيضًا قوة الضوء.
 		</p>
 
@@ -129,9 +121,7 @@ <h3>[property:Vector3 position]</h3>
 		<h3>[property:Float power]</h3>
 		<p>
 		قوة الضوء.<br />
-		عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
-		الطاقة هي قوة إضاءة الضوء المقاسة باللومن (lm).
-		<br /><br />
+		الطاقة هي قوة إضاءة الضوء المقاسة باللومن (lm).<br /><br />
 		تغيير الطاقة سيغير أيضًا شدة الضوء.
 		</p>
 

docs/api/ar/renderers/WebGLRenderer.html

@@ -256,9 +256,6 @@ <h3>[property:Boolean localClippingEnabled]</h3>
 		الافتراضي هو `false`.
 		</p>
 
-		<h3>[property:Boolean useLegacyLights]</h3>
-		<p>هل تستخدم وضع الإضاءة التقليدي أم لا. الافتراضي هو `true`.</p>
-
 		<h3>[property:Object properties]</h3>
 		<p>
 		يستخدم داخليًا من قبل المُعالج لتتبع خصائص الكائنات الفرعية المختلفة

docs/api/en/lights/Light.html

@@ -40,8 +40,7 @@ <h3>[property:Color color]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
 			The light's intensity, or strength.<br />
-			When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
-			the units of intensity depend on the type of light.<br />
+			Tthe units of intensity depend on the type of light.<br />
 			Default - `1.0`.
 		</p>
 

docs/api/en/lights/PointLight.html

@@ -75,12 +75,6 @@ <h3>[property:Float decay]</h3>
 
 		<h3>[property:Float distance]</h3>
 		<p>
-			`Default mode` — When distance is zero, light does not attenuate. When
-			distance is non-zero, light will attenuate linearly from maximum intensity
-			at the light's position down to zero at this distance from the light.
-		</p>
-		<p>
-			When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled —
 			When distance is zero, light will attenuate according to inverse-square
 			law to infinite distance. When distance is non-zero, light will attenuate
 			according to inverse-square law until near the distance cutoff, where it
@@ -91,19 +85,15 @@ <h3>[property:Float distance]</h3>
 
 		<h3>[property:Float intensity]</h3>
 		<p>
-			The light's intensity. Default is `1`.<br />
-			When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
-			intensity is the luminous intensity of the light measured in candela
-			(cd).<br /><br />
-
+			The light's luminous intensity measured in candela (cd). Default is `1`.
+			<br /><br />
 			Changing the intensity will also change the light's power.
 		</p>
 
 		<h3>[property:Float power]</h3>
 		<p>
 			The light's power.<br />
-			When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
-			power is the luminous power of the light measured in lumens (lm).
+			Power is the luminous power of the light measured in lumens (lm).
 			<br /><br />
 
 			Changing the power will also change the light's intensity.

docs/api/en/lights/RectAreaLight.html

@@ -73,10 +73,8 @@ <h3>[property:Float height]</h3>
 
 		<h3>[property:Float intensity]</h3>
 		<p>
-			The light's intensity. Default is `1`.<br />
-			When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
-			intensity is the luminance (brightness) of the light measured in nits
-			(cd/m^2).<br /><br />
+			The light's intensity. It is the luminance (brightness) of the light measured in nits (cd/m^2). 
+			Default is `1`. <br /><br />
 
 			Changing the intensity will also change the light's power.
 		</p>
@@ -87,8 +85,7 @@ <h3>[property:Boolean isRectAreaLight]</h3>
 		<h3>[property:Float power]</h3>
 		<p>
 			The light's power.<br />
-			When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
-			power is the luminous power of the light measured in lumens (lm).
+			Power is the luminous power of the light measured in lumens (lm).
 			<br /><br />
 
 			Changing the power will also change the light's intensity.

docs/api/en/lights/SpotLight.html

@@ -90,12 +90,6 @@ <h3>[property:Float decay]</h3>
 
 		<h3>[property:Float distance]</h3>
 		<p>
-			`Default mode` — When distance is zero, light does not attenuate. When
-			distance is non-zero, light will attenuate linearly from maximum intensity
-			at the light's position down to zero at this distance from the light.
-		</p>
-		<p>
-			When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled —
 			When distance is zero, light will attenuate according to inverse-square
 			law to infinite distance. When distance is non-zero, light will attenuate
 			according to inverse-square law until near the distance cutoff, where it
@@ -106,10 +100,8 @@ <h3>[property:Float distance]</h3>
 
 		<h3>[property:Float intensity]</h3>
 		<p>
-			The light's intensity. Default is `1`.<br />
-			When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
-			intensity is the luminous intensity of the light measured in candela
-			(cd).<br /><br />
+			The light's luminous intensity measured in candela (cd). Default is `1`.
+			<br /><br />
 			Changing the intensity will also change the light's power.
 		</p>
 
@@ -131,8 +123,7 @@ <h3>[property:Vector3 position]</h3>
 		<h3>[property:Float power]</h3>
 		<p>
 			The light's power.<br />
-			When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
-			power is the luminous power of the light measured in lumens (lm).
+			Power is the luminous power of the light measured in lumens (lm).
 			<br /><br />
 			Changing the power will also change the light's intensity.
 		</p>

docs/api/en/renderers/WebGLRenderer.html

@@ -254,9 +254,6 @@ <h3>[property:Boolean localClippingEnabled]</h3>
 			Default is `false`.
 		</p>
 
-		<h3>[property:Boolean useLegacyLights]</h3>
-		<p>Whether to use the legacy lighting mode or not. Default is `true`.</p>
-
 		<h3>[property:Object properties]</h3>
 		<p>
 			Used internally by the renderer to keep track of various sub object

docs/api/it/lights/Light.html

@@ -40,7 +40,7 @@ <h3>[property:Color color]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
       L'intensità o la forza della luce.<br />
-      Quando [page:WebGLRenderer.useLegacyLights legacy lighting mode] è disabilitata, le unità di intensità dipendono dal tipo di luce.<br />
+      Le unità di intensità dipendono dal tipo di luce.<br />
 			Il valore predefinito è `1.0`.
 		</p>
 

docs/api/it/lights/PointLight.html

@@ -68,16 +68,10 @@ <h3>[property:Float decay]</h3>
 
 		<h3>[property:Float distance]</h3>
 		<p>
-			`Modalità predefinita` — Quando la distanza è zero, la luce non si attenua. Quando la distanza è diversa da zero,
-      la luce si attenuerà linearmente dalla massima intensità nella posizione della luce fino a zero a questa distanza 
-      dalla luce.
-		</p>
-		<p>
-			Quando [page:WebGLRenderer.useLegacyLights legacy lighting mode] è disabilitata — Quando la distanza è
-      zero, la luce si attenuerà secondo la legge dell'inverso del quadrato alla distanza infinita.
-      Quando la distanza è diversa da zero, la luce si attenuerà secondo la legge dell'inverso del quadrato 
-      fino in prossimità del limite di distanza, dove si attenuerà quindi rapidamente e senza intoppi fino a 0.
-      Intrinsecamente, i limiti non sono fisicamente corretti.
+			Quando la distanza è zero, la luce si attenuerà secondo la legge dell'inverso del quadrato alla distanza infinita.
+			Quando la distanza è diversa da zero, la luce si attenuerà secondo la legge dell'inverso del quadrato 
+			fino in prossimità del limite di distanza, dove si attenuerà quindi rapidamente e senza intoppi fino a 0.
+			Intrinsecamente, i limiti non sono fisicamente corretti.
 		</p>
 		<p>
 			Il valore predefinito è `0.0`.
@@ -86,17 +80,15 @@ <h3>[property:Float distance]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
       L'intensità della luce. Il valore predefinito è `1`.<br />
-      Quando [page:WebGLRenderer.useLegacyLights legacy lighting mode] è disabilitata, l'intensità 
-      è l'intensità luminosa della luce misurata in candela (cd).<br /><br />
+      L'intensità è l'intensità luminosa della luce misurata in candela (cd).<br /><br />
 
       Modificando l'intensità si modificherà anche la potenza della luce.
 		</p>
 
 		<h3>[property:Float power]</h3>
 		<p>
       La potenza della luce.<br />
-      Quando [page:WebGLRenderer.useLegacyLights legacy lighting mode] è disabilitata, la potenza è la potenza 
-      della luminosità della luce misurata in lumen (lm).<br /><br />
+      La potenza è la potenza della luminosità della luce misurata in lumen (lm).<br /><br />
 
       Modificando la potenza si modificherà anche l'intensità della luce.
 		</p>

docs/api/it/lights/RectAreaLight.html

@@ -70,8 +70,7 @@ <h3>[property:Float height]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
       L'intensità della luce. Il valore predefinito è `1`.<br />
-      Quando [page:WebGLRenderer.useLegacyLights legacy lighting mode] è disabilitata, l'intesità è la luminanza
-      (luminosità) della luce misurata in nits (cd/m^2).<br /><br />
+      L'intesità è la luminanza (luminosità) della luce misurata in nits (cd/m^2).<br /><br />
 
       Modificando l'intensità si modificherà anche la potenza della luce.
 		</p>
@@ -84,8 +83,7 @@ <h3>[property:Boolean isRectAreaLight]</h3>
 		<h3>[property:Float power]</h3>
 		<p>
       La potenza della luce.<br />
-	  Quando [page:WebGLRenderer.useLegacyLights legacy lighting mode] è disabilitata, la potenza è la potenza 
-      della luminosità della luce misurata in lumen (lm).<br /><br />
+      La potenza è la potenza della luminosità della luce misurata in lumen (lm).<br /><br />
 
       Modificando la potenza si modificherà anche l'intensità della luce.
 		</p>

docs/api/it/lights/SpotLight.html

@@ -88,13 +88,7 @@ <h3>[property:Float decay]</h3>
 
 		<h3>[property:Float distance]</h3>
 		<p>
-      `Modalità predefinita` — Quando la distanza è zero, la luce non si attenua. Quando la distanza è diversa da zero,
-      la luce si attenuerà linearmente dalla massima intensità nella posizione della luce fino a zero a questa distanza 
-      dalla luce.
-		</p>
-		<p>
-      Quando [page:WebGLRenderer.useLegacyLights legacy lighting mode] è disabilitata — Quando la distanza è
-      zero, la luce si attenuerà secondo la legge dell'inverso del quadrato alla distanza infinita.
+      Quando la distanza è zero, la luce si attenuerà secondo la legge dell'inverso del quadrato alla distanza infinita.
       Quando la distanza è diversa da zero, la luce si attenuerà secondo la legge dell'inverso del quadrato 
       fino in prossimità del limite di distanza, dove si attenuerà quindi rapidamente e uniformemente fino a `0`.
       Intrinsecamente, i limiti non sono fisicamente corretti.
@@ -106,8 +100,7 @@ <h3>[property:Float distance]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
 			L'intensità della luce. Il valore predefinito è `1`.<br />
-      Quando [page:WebGLRenderer.useLegacyLights legacy lighting mode] è disabilitata, l'intensità 
-      è l'intensità luminosa della luce misurata in candela (cd).<br /><br />
+      L'intensità è l'intensità luminosa della luce misurata in candela (cd).<br /><br />
 
       Modificando l'intensità si modificherà anche la potenza della luce.
 		</p>
@@ -132,8 +125,7 @@ <h3>[property:Float power]</h3>
 		<p>
       La potenza della luce. <br />
 
-      Quando [page:WebGLRenderer.useLegacyLights legacy lighting mode] è disabilitata, la potenza è la potenza 
-      della luminosità della luce misurata in lumen (lm).<br /><br />
+      La potenza è la potenza della luminosità della luce misurata in lumen (lm).<br /><br />
 
       Modificando la potenza si modificherà anche l'intensità della luce.
 		</p>

docs/api/it/renderers/WebGLRenderer.html

@@ -223,11 +223,6 @@ <h3>[property:Object info]</h3>
 		<h3>[property:Boolean localClippingEnabled]</h3>
 		<p>Definisce se il render rispetta i piani di taglio a livello di oggetto. Il valore predefinito è `false`.</p>
 
-		<h3>[property:Boolean useLegacyLights]</h3>
-		<p>
-		Whether to use the legacy lighting mode or not. Il valore predefinito è `true`.
-		</p>
-
 		<h3>[property:Object properties]</h3>
 		<p>
 			Utilizzato internamente dal renderer per mantenere traccia delle proprietà dei vari oggetti secondari.

docs/api/zh/lights/Light.html

@@ -40,7 +40,7 @@ <h3>[property:Color color]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
 			光照的强度，或者说能量。<br />
-			禁用 [page:WebGLRenderer.useLegacyLights legacy lighting mode] 的情况下，强度的单位取决于光的类型。<br />
+			强度的单位取决于光的类型。<br />
 			默认值为 `1.0`。<br />
 		</p>
 

docs/api/zh/lights/PointLight.html

@@ -66,10 +66,6 @@ <h3>[property:Float decay]</h3>
 
 		<h3>[property:Float distance]</h3>
 		<p>
-			默认模式下 — 当值为零时，光线不会衰减。当值不为零时，光线会从灯光的位置开始，到指定的距离之间，随着距离的增加线性衰减为零。
-		</p>
-		<p>
-			禁用 [page:WebGLRenderer.useLegacyLights legacy lighting mode] 的情况下 —
 			当值为零时，光线将根据平方反比定律衰减到无限远。
 			当值不为零时，光线会先按照平方反比定律衰减，直到距离截止点附近，然后线性衰减到 0。
 		</p>
@@ -78,15 +74,14 @@ <h3>[property:Float distance]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
 			光源的强度。默认值为 `1`。<br />
-			禁用 [page:WebGLRenderer.useLegacyLights legacy lighting mode] 的情况下，单位是坎德拉（cd）。<br /><br />
+			单位是坎德拉（cd）。<br /><br />
 			改变该值会影响到 `power` 的值。
 		</p>
 
 		<h3>[property:Float power]</h3>
 		<p>
 			光源的功率。<br />
-			禁用 [page:WebGLRenderer.useLegacyLights legacy lighting mode] 的情况下，单位为流明（lm）。
-			<br /><br />
+			单位为流明（lm）。<br /><br />
 			改变该值会影响到 `intensity` 的值。
 		</p>
 

docs/api/zh/lights/RectAreaLight.html

@@ -67,7 +67,7 @@ <h3>[property:Float height]</h3>
 		<h3>[property:Float intensity]</h3>
 		<p>
 			光源的强度。默认值为 `1`。<br />
-			禁用 [page:WebGLRenderer.useLegacyLights legacy lighting mode] 的情况下，单位是尼特（cd/m^2）。<br /><br />
+			单位是尼特（cd/m^2）。<br /><br />
 
 			改变该值会影响到 `power` 的值。
 		</p>
@@ -80,7 +80,7 @@ <h3>[property:Boolean isRectAreaLight]</h3>
 		<h3>[property:Float power]</h3>
 		<p>
 			光源的功率。<br />
-			禁用 [page:WebGLRenderer.useLegacyLights legacy lighting mode] 的情况下，单位为流明（lm）。<br /><br />
+			单位为流明（lm）。<br /><br />
 
 			改变该值会影响到 `intensity` 的值。
 		</p>