翻译渲染管线 (cocos#1641)

EricCorleone · slackmoehrle · xunyi0 · web-flow · commit 58c66cc4255e · 2021-06-11T14:46:52.000+08:00
* 翻译渲染管线

* Apply suggestions from code review

Co-authored-by: Slack-Moehrle &lt;slackmoehrle@users.noreply.github.com&gt;
Co-authored-by: yufang.wu &lt;2435731537@qq.com&gt;

* Update en/render-pipeline/overview.md

Co-authored-by: Slack-Moehrle &lt;slackmoehrle@users.noreply.github.com&gt;

* Apply suggestions from code review

Co-authored-by: yufang.wu &lt;2435731537@qq.com&gt;

* 一些修改

* Apply suggestions from code review

Co-authored-by: Slack-Moehrle &lt;slackmoehrle@users.noreply.github.com&gt;
Co-authored-by: yufang.wu &lt;2435731537@qq.com&gt;
diff --git a/en/SUMMARY.md b/en/SUMMARY.md
@@ -306,6 +306,10 @@
     - [AssetManager for Hot Update](advanced-topics/hot-update-manager.md)
     - [Dynamic Atlas](advanced-topics/dynamic-atlas.md)
     - [Engine Customization Workflow](advanced-topics/engine-customization.md)
+    - [Render Pipeline](render-pipeline/overview.md)
+        - [Built-in Pipeline](render-pipeline/builtin-pipeline.md)
+        - [Custom Pipeline](render-pipeline/user-pipeline.md)
+        - [Post-Processing](render-pipeline/post-process.md)
     - [The Tutorial for JSB 2.0](advanced-topics/JSB2.0-learning.md)
     - [JavaScript to Java Reflection](advanced-topics/java-reflection.md)
     - [JavaScript to Objective-C Reflection](advanced-topics/oc-reflection.md)
diff --git a/en/advanced-topics/index.md b/en/advanced-topics/index.md
@@ -5,6 +5,10 @@
     - [AssetManager](hot-update-manager.md)
 - [Dynamic Atlas](dynamic-atlas.md)
 - [Engine Customization Workflow](engine-customization.md)
+- [Render Pipeline](../render-pipeline/overview.md)
+    - [Built-in Pipeline](../render-pipeline/builtin-pipeline.md)
+    - [Custom Pipeline](../render-pipeline/user-pipeline.md)
+    - [Post-Processing](../render-pipeline/post-process.md)
 - [The Tutorial for JSB 2.0](JSB2.0-learning.md)
 - [JavaScript to Java Reflection](java-reflection.md)
 - [JavaScript to Objective-C Reflection](oc-reflection.md)
diff --git a/en/render-pipeline/builtin-pipeline.md b/en/render-pipeline/builtin-pipeline.md
@@ -0,0 +1,7 @@
+# Built-in Render Pipeline
+
+The built-in render pipeline uses forward rendering. Forward rendering renders each object in the scene in turn, calculating the lighting for each object as it is rendered. In the built-in render pipeline, there will only be one parallel light in effect for a scene. Each object can only receive 2 point light sources and 2 spotlights, and if it is out of range, the sources will be sorted by distance and the two closest sources will be taken.
+
+The built-in render pipeline contains a **ForwardFlow**, which contains a **ForwardStage**. Two **RenderQueues** are set in the ForwardStage:
+- The first one is used for rendering opaque objects, sorted from near to far from the camera.
+- The second one is used for rendering translucent objects, sorted from far to near from the camera.
diff --git a/en/render-pipeline/overview.md b/en/render-pipeline/overview.md
@@ -0,0 +1,13 @@
+# Render Pipeline (Experimental)
+
+RenderPipeline is used to control the rendering process of a scene, including lighting management, object culling, render object sorting, render target switching, etc. Since each stage can be handled differently and optimally for different projects, it is difficult to achieve optimal results with a uniform approach to the rendering process for different types of projects. The customizable render pipeline is used to provide more flexible control over each stage in the rendered scene, allowing for deeper optimization solutions for different projects.
+
+Among the customizable render pipelines, one can choose to use the engine's built-in render pipeline, which uses the forward render pipeline. Please refer to the [Built-in Pipeline](builtin-pipeline.md) documentation for details.
+
+Developers can also create a new render pipeline asset to extend the render pipeline themselves. In the render pipeline asset you can manage each stage of the rendering process and then set each parameter in the editor.
+
+The customizable render pipeline currently includes the following features:
+
+[Custom Pipeline](user-pipeline.md)
+
+[Post-Processing](post-process.md)
diff --git a/en/render-pipeline/post-process.md b/en/render-pipeline/post-process.md
@@ -0,0 +1,3 @@
+# Post-Processing
+
+To create a new post-processing effect, create a new RenderFlow script and set its type to POSTPROCESS. The production process is the same as other RenderFlow, but RenderPipeline does not automatically perform post-processing, it is necessary to set the `flows` property in the Camera to specify which post-processing to perform.
diff --git a/en/render-pipeline/user-pipeline.md b/en/render-pipeline/user-pipeline.md
@@ -0,0 +1,61 @@
+# Custom Render Pipelines
+
+To create a custom render pipeline, first create a new RenderPipeline asset in the **Assets** panel, then create a RenderPipeline script, and then select the corresponding RenderPipeline script in the Pipeline asset to edit the corresponding properties.
+
+RenderFlow and RenderStage are created and edited in the same way. In the created Pipeline script, add properties and make them editable in the **Inspector** panel just like any other user script, but note that it is not an option to drag and drop entities in the scene, as the RenderPipeline is not bound to a specific scene.
+
+## Properties and methods in RenderPipeline
+
+- `flows`: The RenderFlow contained in the RenderPipeline.
+
+- `renderTextures`: the RenderTextures that can be created when the RenderPipeline is started.
+
+    - `name`: the name of the RenderTexture, which can be obtained by the `getRenderTexture` function of the RenderPipeline after creation.
+    - `type`: the type of the RenderTexture.
+    - `viewType`: the corresponding TextureView type of the RenderTexture.
+    - `usage`: the binding type of the RenderTexture, used to determine whether it is `color` or `depth_stencil`.
+    - `formate`: the channel format of the RenderTexture.
+    - `width`: width of the RenderTexture, -1 means the width of the window.
+    - `height`: height of the RenderTexture, -1 means the height of the window.
+
+- `framebuffers`: the FrameBuffer that can be created when RenderPipeline starts.
+
+    - `name`: the name of the FrameBuffer, it can be retrieved by the `getFrameBuffer` function of RenderPipeline after creation.
+    - `renderPass`: the ID of the RenderPass configured in the RenderPipeline.
+    - `colorViews`: TextureView bound to the ColorAttachment, specifying the RenderTexture configured in the RenderPipeline.
+    - `depthStencilView`: TextureView bound to DepthStencilAttachment. specifies the RenderTexture configured in the RenderPipeline.
+- `renderPasses`: the RenderPasses that can be created when the RenderPipeline is started.
+    - `index`: ID of the RenderPass, which can be obtained by the `getRenderPass` function of the RenderPipeline.
+    - `colorAttachments`: the description of the ColorAttachment, the operation of the ColorAttachment when drawing the FrameBuffer.
+    - `depthStencilAttachment`: the description of the DepthStencilAttachment, the operation of the DepthStencilAttachment when drawing the FrameBuffer.
+
+- `getTextureView` (name: string), `getRenderTexture` (name: string): get the RenderTexture configured in renderTextures.
+- `getFrameBuffer` (name: string): get the FrameBuffer configured in `framebuffers`.
+- `getRenderPass` (stage: number): get the RenderPass configured in renderPasses.
+- `initialize` (info: IRenderPipelineInfo): initialize function for creating a RenderPipeline by script, the RenderPipeline must be initialized before it can be used.
+- `activate` (root: Root): initialization function used when loading a RenderPipeline through an asset.
+- `render` (view: RenderView): logic for rendering the scene.
+- `updateUBOs` (view: RenderView): update the global UniformBuffer.
+- `sceneCulling` (view: RenderView): scene culling, renderable objects are saved in `_renderObjects` after culling.
+
+## Properties and methods in RenderFlow
+
+- `name`: the name of the RenderFlow.
+- `priority`: the order of execution of the RenderFlow in the RenderPipeline.
+- `type`: the type of the RenderFlow.
+    - `SCENE`: used to draw the scene, this type will be executed for each camera.
+    - `POSTPROCESS`: post-processing, this type is specified separately for each camera.
+    - `UI`: used to draw the UI.
+- `stages`: RenderStage included in RenderFlow.
+
+## Properties and methods in RenderStage
+
+- `name`: the name of the RenderStage.
+- `priority`: the order of execution of the RenderStage in the RenderFlow.
+- `frameBuffer`: the FrameBuffer that the RenderStage will draw to, should be set to the FrameBuffer configured in the RenderPipeline, or set to `window` to indicate that the default FrameBuffer is used.
+- `renderQueues`: render queue, used to control the rendering order of objects.
+    - `isTransparent`: marks whether the render queue is semi-transparent.
+    - `sortMode`: <br>`FRONT_TO_BACK`: sort from front to back; <br>`BACK_TO_FRONT`: sort from back to front.
+    - `stages`: specifies which passes in the render queue render material, should be specified as the `phase` in the `pass`.
+    - `sortRenderQueue()`: sort the render queue.
+    - `executeCommandBuffer` (view: RenderView): execute the render command.
diff --git a/zh/SUMMARY.md b/zh/SUMMARY.md
@@ -302,6 +302,9 @@
     - [引擎定制工作流程](advanced-topics/engine-customization.md)
     - [网页预览定制工作流程](editor/preview/browser.md)
     - [渲染管线](render-pipeline/overview.md)
+        - [内置管线](render-pipeline/builtin-pipeline.md)
+        - [自定义管线](render-pipeline/user-pipeline.md)
+        - [后期处理](render-pipeline/post-process.md)
     - [JSB 2.0 使用指南](advanced-topics/JSB2.0-learning.md)
         - [JSB 手动绑定](advanced-topics/jsb-manual-binding.md)
         - [JSB 自动绑定](advanced-topics/jsb-auto-binding.md)
diff --git a/zh/advanced-topics/index.md b/zh/advanced-topics/index.md
@@ -7,6 +7,9 @@
 - [引擎定制工作流程](engine-customization.md)
 - [网页预览定制工作流程](../editor/preview/browser.md)
 - [渲染管线](../render-pipeline/overview.md)
+    - [内置管线](../render-pipeline/builtin-pipeline.md)
+    - [自定义管线](../render-pipeline/user-pipeline.md)
+    - [后期处理](../render-pipeline/post-process.md)
 - [JSB 2.0 使用指南](JSB2.0-learning.md)
     - [JSB 手动绑定](jsb-manual-binding.md)
     - [JSB 自动绑定](jsb-auto-binding.md)
diff --git a/zh/render-pipeline/builtin-pipeline.md b/zh/render-pipeline/builtin-pipeline.md
@@ -1,5 +1,7 @@
 # 内置渲染管线
 
-内置渲染管线使用的是前向渲染。前向渲染会依次渲染场景中的每个物体，在渲染每个物体时计算其光照。在内置渲染管线中，一个场景只会有一个平行光生效，每个物体只能接受2个点光源和2个聚光灯，如果超出范围，则会对光源按距离排序，取最近的两个光源。
+目前内置渲染管线使用的是 **前向渲染**。前向渲染会依次渲染场景中的每个物体，在渲染每个物体时计算其光照。在内置渲染管线中，一个场景只会有一个平行光生效，每个物体只能接受 2 个点光源和 2 个聚光灯，如果超出范围，则会按距离对光源进行排序，取最近的两个光源。
 
-内置渲染管线包含一个ForwardFlow，ForwardFlow中包含一个ForwardStage。在ForwardStage里设置了两个RenderQueue，第一个用于渲染不透明物体，按离摄像机从近到远排序，第二个用于半透明物体渲染，按离摄像机从远到近排序。
+内置渲染管线包含一个 ForwardFlow，ForwardFlow 中包含一个 ForwardStage。在 ForwardStage 里设置了两个 RenderQueue：
+- 第一个用于渲染不透明物体，按离摄像机从近到远排序
+- 第二个用于半透明物体渲染，按离摄像机从远到近排序。
diff --git a/zh/render-pipeline/overview.md b/zh/render-pipeline/overview.md
@@ -1,12 +1,13 @@
-# Render Pipeline Overview (Experimental)
-RenderPipeline用于控制场景的渲染流程，包括光照管理、物体剔除、渲染物体排序、渲染目标切换等。由于每个阶段对于不同项目来说可以有不同的优化处理方式，所以用统一的方法来处理不同类型项目的渲染流程很难达到最优化的结果。可定制化的渲染管线用于对渲染场景中的每个阶段进行更灵活的控制，可以针对不同的项目做更深层次的优化方案。
+# 渲染管线 (Experimental)
 
-在可定制化的渲染管线中，你可以选择使用引擎内置的渲染管线，内置管线使用的是前向渲染管线。你也可以创建一个新的渲染管线资源，用以自行扩展渲染管线。在渲染管线资源中你可以管理渲染流程中每个阶段的工作，然后可以在编辑器中对各个参数进行设置。
+RenderPipeline 用于控制场景的渲染流程，包括光照管理、物体剔除、渲染物体排序、渲染目标切换等。由于每个阶段对于不同项目来说可以有不同的优化处理方式，所以用统一的方法来处理不同类型项目的渲染流程很难达到最优化的结果。可定制化的渲染管线用于对渲染场景中的每个阶段进行更灵活的控制，可以针对不同的项目做更深层次的优化方案。
 
-目前可定制化渲染管线包括以下功能：
+在可定制化的渲染管线中，可以选择使用引擎内置的渲染管线，内置管线使用的是前向渲染管线。详情请参考 [内置管线](builtin-pipeline.md)。
+
+开发者也可以创建一个新的渲染管线资源，用以自行扩展渲染管线。在渲染管线资源中你可以管理渲染流程中每个阶段的工作，然后可以在编辑器中对各个参数进行设置。
 
-[内置管线](builtin-pipeline.md)
+目前可定制化渲染管线包括以下功能：
 
-[自定义管线](user-pipeline.md)
+- [自定义管线](user-pipeline.md)
 
-[后期处理](post-process.md)
+- [后期处理](post-process.md)
diff --git a/zh/render-pipeline/post-process.md b/zh/render-pipeline/post-process.md
@@ -1,3 +1,3 @@
 # 后期处理
 
-要新建一个后期处理需要新建一个RenderFlow脚本，然后将其type设为POSTPROCESS。制作流程与其它RenderFlow相同，但RenderPipeline不会自动执行后期处理，需要在Camera中设置flows属性来指定执行哪些后期处理。
+要新建一个后期处理需要新建一个 RenderFlow 脚本，然后将其 type 设为 POSTPROCESS。制作流程与其它 RenderFlow 相同，但 RenderPipeline 不会自动执行后期处理，需要在 Camera 中设置 flows 属性来指定执行哪些后期处理。
diff --git a/zh/render-pipeline/user-pipeline.md b/zh/render-pipeline/user-pipeline.md

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Post-Processing`
	`2`	`+`
	`3`	+To create a new post-processing effect, create a new RenderFlow script and set its type to POSTPROCESS. The production process is the same as other RenderFlow, but RenderPipeline does not automatically perform post-processing, it is necessary to set the `flows` property in the Camera to specify which post-processing to perform.
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`# 后期处理`
`2`	`2`
`3`		`-要新建一个后期处理需要新建一个RenderFlow脚本，然后将其type设为POSTPROCESS。制作流程与其它RenderFlow相同，但RenderPipeline不会自动执行后期处理，需要在Camera中设置flows属性来指定执行哪些后期处理。`
	`3`	`+要新建一个后期处理需要新建一个 RenderFlow 脚本，然后将其 type 设为 POSTPROCESS。制作流程与其它 RenderFlow 相同，但 RenderPipeline 不会自动执行后期处理，需要在 Camera 中设置 flows 属性来指定执行哪些后期处理。`