Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WebGLRenderer: Deprecate useLegacyLights, change default to false. #26392

Merged
merged 1 commit into from
Jul 11, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
1 change: 0 additions & 1 deletion docs/api/ar/lights/Light.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down
8 changes: 0 additions & 8 deletions docs/api/ar/lights/PointLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -71,12 +71,6 @@ <h3>[property:Float decay]</h3>

<h3>[property:Float distance]</h3>
<p>
`الوضع الافتراضي` - عندما تكون المسافة صفرًا ، لا يتلاشى الضوء. عندما
تكون المسافة غير صفرية ، سيتلاشى الضوء بشكل خطي من أقصى شدة
عند موقع الضوء إلى الصفر على هذه المسافة من الضوء.
</p>
<p>
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode] -
عندما تكون المسافة صفرًا ، سيتلاشى الضوء وفقًا لقانون المربع المعكوس
إلى مسافة لانهائية. عندما تكون المسافة غير صفرية ، سيتلاشى الضوء
وفقًا لقانون المربع المعكوس حتى قرب نقطة قطع المسافة ، حيث
Expand All @@ -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 />

Expand All @@ -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 />

Expand Down
2 changes: 0 additions & 2 deletions docs/api/ar/lights/RectAreaLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -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 />

Expand All @@ -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 />

Expand Down
14 changes: 2 additions & 12 deletions docs/api/ar/lights/SpotLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -89,12 +89,6 @@ <h3>[property:Float decay]</h3>

<h3>[property:Float distance]</h3>
<p>
`الوضع الافتراضي` - عندما تكون المسافة صفرًا ، لا يتلاشى الضوء. عندما
تكون المسافة غير صفرية ، سيتلاشى الضوء بشكل خطي من أقصى شدة
عند موقع الضوء إلى الصفر على هذه المسافة من الضوء.
</p>
<p>
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode] -
عندما تكون المسافة صفرًا ، سيتلاشى الضوء وفقًا لقانون المربع المعكوس
إلى مسافة لانهائية. عندما تكون المسافة غير صفرية ، سيتلاشى الضوء
وفقًا لقانون المربع المعكوس حتى قرب نقطة قطع المسافة ، حيث
Expand All @@ -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>

Expand All @@ -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>

Expand Down
3 changes: 0 additions & 3 deletions docs/api/ar/renderers/WebGLRenderer.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>
يستخدم داخليًا من قبل المُعالج لتتبع خصائص الكائنات الفرعية المختلفة
Expand Down
3 changes: 1 addition & 2 deletions docs/api/en/lights/Light.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down
16 changes: 3 additions & 13 deletions docs/api/en/lights/PointLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.
Expand Down
9 changes: 3 additions & 6 deletions docs/api/en/lights/RectAreaLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand All @@ -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.
Expand Down
15 changes: 3 additions & 12 deletions docs/api/en/lights/SpotLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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>

Expand All @@ -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>
Expand Down
3 changes: 0 additions & 3 deletions docs/api/en/renderers/WebGLRenderer.html
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/api/it/lights/Light.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down
20 changes: 6 additions & 14 deletions docs/api/it/lights/PointLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand All @@ -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>
Expand Down
6 changes: 2 additions & 4 deletions docs/api/it/lights/RectAreaLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand All @@ -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>
Expand Down
14 changes: 3 additions & 11 deletions docs/api/it/lights/SpotLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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>
Expand All @@ -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>
Expand Down
5 changes: 0 additions & 5 deletions docs/api/it/renderers/WebGLRenderer.html
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion docs/api/zh/lights/Light.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down
9 changes: 2 additions & 7 deletions docs/api/zh/lights/PointLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand All @@ -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>

Expand Down
4 changes: 2 additions & 2 deletions docs/api/zh/lights/RectAreaLight.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand All @@ -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>
Expand Down
Loading