Skip to content

Commit 641b108

Browse files
authored
Docs: Improve WebGLRenderer page. (#26963)
1 parent 30b6736 commit 641b108

File tree

4 files changed

+23
-17
lines changed

4 files changed

+23
-17
lines changed

docs/api/ar/renderers/WebGLRenderer.html

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -354,17 +354,18 @@ <h3>
354354
</h3>
355355
<p>
356356
يجمع جميع المواد في المشهد مع الكاميرا. هذا مفيد لـ
357-
تجميع الشادرات قبل العرض الأول.
357+
تجميع الشادرات قبل العرض الأول. <br />
358+
لاحظ أنه يجب تكوين إضاءة المشهد قبل استدعاء هذه الطريقة.
358359
</p>
359360

360361
<h3>
361362
[method:Promise compileAsync]( [param:Object3D scene], [param:Camera camera] )
362363
</h3>
363364
<p>
364-
Async version of [page:WebGLRenderer.compile .compile](). The method returns a Promise that resolves when the
365-
given 3D object or scene can be rendered without unnecessary stalling due to shader compilation.<br /><br />
365+
إصدار غير متزامن من [page:WebGLRenderer.compile .compile](). تقوم الطريقة بإرجاع Promise
366+
الذي يتم حله عندما يمكن عرض الكائن أو المشهد ثلاثي الأبعاد المحدد دون توقف غير ضروري بسبب تجميع التظليل.<br /><br />
366367

367-
This method makes use of the *KHR_parallel_shader_compile* WebGL extension.
368+
تستخدم هذه الطريقة *KHR_parallel_shader_compile*.
368369
</p>
369370

370371
<h3>

docs/api/en/renderers/WebGLRenderer.html

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -351,15 +351,16 @@ <h3>
351351
[method:undefined compile]( [param:Object3D scene], [param:Camera camera] )
352352
</h3>
353353
<p>
354-
Compiles all materials in the scene with the camera. This is useful to precompile shaders before the first rendering.
355-
</p>
354+
Compiles all materials in the scene with the camera. This is useful to precompile shaders before the first rendering. <br />
355+
Note that the scene's lighting should be configured before calling this method.
356+
</p>
356357

357358
<h3>
358359
[method:Promise compileAsync]( [param:Object3D scene], [param:Camera camera] )
359360
</h3>
360361
<p>
361-
Async version of [page:WebGLRenderer.compile .compile](). The method returns a Promise that resolves when the
362-
given 3D object or scene can be rendered without unnecessary stalling due to shader compilation.<br /><br />
362+
Asynchronous version of [page:WebGLRenderer.compile .compile](). The method returns a Promise that resolves when the
363+
given scene can be rendered without unnecessary stalling due to shader compilation.<br /><br />
363364

364365
This method makes use of the *KHR_parallel_shader_compile* WebGL extension.
365366
</p>

docs/api/it/renderers/WebGLRenderer.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -308,13 +308,16 @@ <h3>[method:undefined clearStencil]( )</h3>
308308
<p>Cancella il buffer di stencil. Equivalente a chiamare [page:WebGLRenderer.clear .clear]( false, false, true ).</p>
309309

310310
<h3>[method:undefined compile]( [param:Object3D scene], [param:Camera camera] )</h3>
311-
<p>Compila tutti i materiali nella scena con la telecamera. Questo è utile per precompilare le ombre prima del primo rendering.</p>
311+
<p>
312+
Compila tutti i materiali nella scena con la telecamera. Questo è utile per precompilare le ombre prima del primo rendering.<br/>
313+
Tieni presente che l'illuminazione della scena deve essere configurata prima di chiamare questo metodo.
314+
</p>
312315

313316
<h3>[method:Promise compileAsync]( [param:Object3D scene], [param:Camera camera] )</h3>
314317
<p>
315-
Async version of [page:WebGLRenderer.compile .compile](). The method returns a Promise that resolves when the
316-
given 3D object or scene can be rendered without unnecessary stalling due to shader compilation.<br /><br />
317-
This method makes use of the *KHR_parallel_shader_compile* WebGL extension.
318+
Versione asincrona di [page:WebGLRenderer.compile .compile](). Il metodo restituisce una Promise che si risolve quando è possibile eseguire
319+
il rendering di un determinato oggetto 3D o scena senza inutili stalli dovuti alla compilazione dello shader.<br /><br />
320+
Questo metodo utilizza *KHR_parallel_shader_compile*.
318321
</p>
319322

320323
<h3>[method:undefined copyFramebufferToTexture]( [param:Vector2 position], [param:FramebufferTexture texture], [param:Number level] )</h3>

docs/api/zh/renderers/WebGLRenderer.html

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -269,14 +269,15 @@ <h3>[method:undefined clearStencil]( )</h3>
269269
<p>清除模板缓存。相当于调用[page:WebGLRenderer.clear .clear]( false, false, true )</p>
270270

271271
<h3>[method:undefined compile]( [param:Object3D scene], [param:Camera camera] )</h3>
272-
<p>使用相机编译场景中的所有材质。这对于在首次渲染之前预编译着色器很有用。</p>
272+
<p>
273+
使用相机编译场景中的所有材质。这对于在首次渲染之前预编译着色器很有用。<br />
274+
请注意,在调用此方法之前应配置场景的照明。
275+
</p>
273276

274277
<h3>[method:Promise compileAsync]( [param:Object3D scene], [param:Camera camera] )</h3>
275278
<p>
276-
Async version of [page:WebGLRenderer.compile .compile](). The method returns a Promise that resolves when the
277-
given 3D object or scene can be rendered without unnecessary stalling due to shader compilation.<br /><br />
278-
279-
This method makes use of the *KHR_parallel_shader_compile* WebGL extension.
279+
[page:WebGLRenderer.compile .compile]() 的异步版本。该方法返回一个 Promise。它解决了何时可以渲染给定的 3D 对象或场景,而不会因着色器编译而出现不必要的停顿。<br /><br />
280+
此方法利用 *KHR_parallel_shader_compile*。
280281
</p>
281282

282283
<h3>[method:undefined copyFramebufferToTexture]( [param:Vector2 position], [param:FramebufferTexture texture], [param:Number level] )</h3>

0 commit comments

Comments
 (0)