Skip to content

Commit cce80b8

Browse files
authored
WebGLRenderer: Deprecate useLegacyLights, change default to false. (#26392)
1 parent 28fc642 commit cce80b8

File tree

550 files changed

+53
-683
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

550 files changed

+53
-683
lines changed

docs/api/ar/lights/Light.html

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,6 @@ <h3>[property:Color color]</h3>
4040
<h3>[property:Float intensity]</h3>
4141
<p>
4242
شدة الضوء ، أو قوته.<br />
43-
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode] ،
4443
وحدات الشدة تعتمد على نوع الضوء.<br />
4544
الافتراضي - `1.0`.
4645
</p>

docs/api/ar/lights/PointLight.html

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -71,12 +71,6 @@ <h3>[property:Float decay]</h3>
7171

7272
<h3>[property:Float distance]</h3>
7373
<p>
74-
`الوضع الافتراضي` - عندما تكون المسافة صفرًا ، لا يتلاشى الضوء. عندما
75-
تكون المسافة غير صفرية ، سيتلاشى الضوء بشكل خطي من أقصى شدة
76-
عند موقع الضوء إلى الصفر على هذه المسافة من الضوء.
77-
</p>
78-
<p>
79-
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode] -
8074
عندما تكون المسافة صفرًا ، سيتلاشى الضوء وفقًا لقانون المربع المعكوس
8175
إلى مسافة لانهائية. عندما تكون المسافة غير صفرية ، سيتلاشى الضوء
8276
وفقًا لقانون المربع المعكوس حتى قرب نقطة قطع المسافة ، حيث
@@ -87,7 +81,6 @@ <h3>[property:Float distance]</h3>
8781
<h3>[property:Float intensity]</h3>
8882
<p>
8983
شدة الضوء. القيمة الافتراضية هي `1`.<br />
90-
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
9184
الشدة هي شدة إضاءة الضوء المقاسة بالشمعات
9285
(cd).<br /><br />
9386

@@ -97,7 +90,6 @@ <h3>[property:Float intensity]</h3>
9790
<h3>[property:Float power]</h3>
9891
<p>
9992
قوة الضوء.<br />
100-
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
10193
الطاقة هي قوة إضاءة الضوء المقاسة باللومن (lm).
10294
<br /><br />
10395

docs/api/ar/lights/RectAreaLight.html

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,6 @@ <h3>[property:Float height]</h3>
7272
<h3>[property:Float intensity]</h3>
7373
<p>
7474
شدة الضوء. القيمة الافتراضية هي `1`.<br />
75-
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
7675
الشدة هي الإضاءة (السطوع) للضوء المقاسة بالنيتات
7776
(cd/m^2).<br /><br />
7877

@@ -85,7 +84,6 @@ <h3>[property:Boolean isRectAreaLight]</h3>
8584
<h3>[property:Float power]</h3>
8685
<p>
8786
قوة الضوء.<br />
88-
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
8987
الطاقة هي قوة إضاءة الضوء المقاسة باللومن (lm).
9088
<br /><br />
9189

docs/api/ar/lights/SpotLight.html

Lines changed: 2 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -89,12 +89,6 @@ <h3>[property:Float decay]</h3>
8989

9090
<h3>[property:Float distance]</h3>
9191
<p>
92-
`الوضع الافتراضي` - عندما تكون المسافة صفرًا ، لا يتلاشى الضوء. عندما
93-
تكون المسافة غير صفرية ، سيتلاشى الضوء بشكل خطي من أقصى شدة
94-
عند موقع الضوء إلى الصفر على هذه المسافة من الضوء.
95-
</p>
96-
<p>
97-
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode] -
9892
عندما تكون المسافة صفرًا ، سيتلاشى الضوء وفقًا لقانون المربع المعكوس
9993
إلى مسافة لانهائية. عندما تكون المسافة غير صفرية ، سيتلاشى الضوء
10094
وفقًا لقانون المربع المعكوس حتى قرب نقطة قطع المسافة ، حيث
@@ -105,9 +99,7 @@ <h3>[property:Float distance]</h3>
10599
<h3>[property:Float intensity]</h3>
106100
<p>
107101
شدة الضوء. القيمة الافتراضية هي `1`.<br />
108-
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
109-
الشدة هى شدة إضاءة الضوء المقاسة بالشمعات
110-
(cd).<br /><br />
102+
الشدة هى شدة إضاءة الضوء المقاسة بالشمعات(cd).<br /><br />
111103
تغيير الشدة سيغير أيضًا قوة الضوء.
112104
</p>
113105

@@ -129,9 +121,7 @@ <h3>[property:Vector3 position]</h3>
129121
<h3>[property:Float power]</h3>
130122
<p>
131123
قوة الضوء.<br />
132-
عندما يتم تعطيل [page:WebGLRenderer.useLegacyLights legacy lighting mode]،
133-
الطاقة هي قوة إضاءة الضوء المقاسة باللومن (lm).
134-
<br /><br />
124+
الطاقة هي قوة إضاءة الضوء المقاسة باللومن (lm).<br /><br />
135125
تغيير الطاقة سيغير أيضًا شدة الضوء.
136126
</p>
137127

docs/api/ar/renderers/WebGLRenderer.html

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -256,9 +256,6 @@ <h3>[property:Boolean localClippingEnabled]</h3>
256256
الافتراضي هو `false`.
257257
</p>
258258

259-
<h3>[property:Boolean useLegacyLights]</h3>
260-
<p>هل تستخدم وضع الإضاءة التقليدي أم لا. الافتراضي هو `true`.</p>
261-
262259
<h3>[property:Object properties]</h3>
263260
<p>
264261
يستخدم داخليًا من قبل المُعالج لتتبع خصائص الكائنات الفرعية المختلفة

docs/api/en/lights/Light.html

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,8 +40,7 @@ <h3>[property:Color color]</h3>
4040
<h3>[property:Float intensity]</h3>
4141
<p>
4242
The light's intensity, or strength.<br />
43-
When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
44-
the units of intensity depend on the type of light.<br />
43+
Tthe units of intensity depend on the type of light.<br />
4544
Default - `1.0`.
4645
</p>
4746

docs/api/en/lights/PointLight.html

Lines changed: 3 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -75,12 +75,6 @@ <h3>[property:Float decay]</h3>
7575

7676
<h3>[property:Float distance]</h3>
7777
<p>
78-
`Default mode` — When distance is zero, light does not attenuate. When
79-
distance is non-zero, light will attenuate linearly from maximum intensity
80-
at the light's position down to zero at this distance from the light.
81-
</p>
82-
<p>
83-
When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled —
8478
When distance is zero, light will attenuate according to inverse-square
8579
law to infinite distance. When distance is non-zero, light will attenuate
8680
according to inverse-square law until near the distance cutoff, where it
@@ -91,19 +85,15 @@ <h3>[property:Float distance]</h3>
9185

9286
<h3>[property:Float intensity]</h3>
9387
<p>
94-
The light's intensity. Default is `1`.<br />
95-
When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
96-
intensity is the luminous intensity of the light measured in candela
97-
(cd).<br /><br />
98-
88+
The light's luminous intensity measured in candela (cd). Default is `1`.
89+
<br /><br />
9990
Changing the intensity will also change the light's power.
10091
</p>
10192

10293
<h3>[property:Float power]</h3>
10394
<p>
10495
The light's power.<br />
105-
When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
106-
power is the luminous power of the light measured in lumens (lm).
96+
Power is the luminous power of the light measured in lumens (lm).
10797
<br /><br />
10898

10999
Changing the power will also change the light's intensity.

docs/api/en/lights/RectAreaLight.html

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -73,10 +73,8 @@ <h3>[property:Float height]</h3>
7373

7474
<h3>[property:Float intensity]</h3>
7575
<p>
76-
The light's intensity. Default is `1`.<br />
77-
When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
78-
intensity is the luminance (brightness) of the light measured in nits
79-
(cd/m^2).<br /><br />
76+
The light's intensity. It is the luminance (brightness) of the light measured in nits (cd/m^2).
77+
Default is `1`. <br /><br />
8078

8179
Changing the intensity will also change the light's power.
8280
</p>
@@ -87,8 +85,7 @@ <h3>[property:Boolean isRectAreaLight]</h3>
8785
<h3>[property:Float power]</h3>
8886
<p>
8987
The light's power.<br />
90-
When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
91-
power is the luminous power of the light measured in lumens (lm).
88+
Power is the luminous power of the light measured in lumens (lm).
9289
<br /><br />
9390

9491
Changing the power will also change the light's intensity.

docs/api/en/lights/SpotLight.html

Lines changed: 3 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -90,12 +90,6 @@ <h3>[property:Float decay]</h3>
9090

9191
<h3>[property:Float distance]</h3>
9292
<p>
93-
`Default mode` — When distance is zero, light does not attenuate. When
94-
distance is non-zero, light will attenuate linearly from maximum intensity
95-
at the light's position down to zero at this distance from the light.
96-
</p>
97-
<p>
98-
When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled —
9993
When distance is zero, light will attenuate according to inverse-square
10094
law to infinite distance. When distance is non-zero, light will attenuate
10195
according to inverse-square law until near the distance cutoff, where it
@@ -106,10 +100,8 @@ <h3>[property:Float distance]</h3>
106100

107101
<h3>[property:Float intensity]</h3>
108102
<p>
109-
The light's intensity. Default is `1`.<br />
110-
When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
111-
intensity is the luminous intensity of the light measured in candela
112-
(cd).<br /><br />
103+
The light's luminous intensity measured in candela (cd). Default is `1`.
104+
<br /><br />
113105
Changing the intensity will also change the light's power.
114106
</p>
115107

@@ -131,8 +123,7 @@ <h3>[property:Vector3 position]</h3>
131123
<h3>[property:Float power]</h3>
132124
<p>
133125
The light's power.<br />
134-
When [page:WebGLRenderer.useLegacyLights legacy lighting mode] is disabled,
135-
power is the luminous power of the light measured in lumens (lm).
126+
Power is the luminous power of the light measured in lumens (lm).
136127
<br /><br />
137128
Changing the power will also change the light's intensity.
138129
</p>

docs/api/en/renderers/WebGLRenderer.html

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -254,9 +254,6 @@ <h3>[property:Boolean localClippingEnabled]</h3>
254254
Default is `false`.
255255
</p>
256256

257-
<h3>[property:Boolean useLegacyLights]</h3>
258-
<p>Whether to use the legacy lighting mode or not. Default is `true`.</p>
259-
260257
<h3>[property:Object properties]</h3>
261258
<p>
262259
Used internally by the renderer to keep track of various sub object

0 commit comments

Comments
 (0)