# 效果合成器（[name]）

用于在three.js中实现后期处理效果。该类管理了产生最终视觉效果的后期处理过程链。 后期处理过程根据它们添加/插入的顺序来执行，最后一个过程会被自动渲染到屏幕上。

## 进口

[name] 是一个附加组件，必须显式导入。 See [link:#manual/introduction/Installation Installation / Addons].

`import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';`

## 例子

[example:webgl_postprocessing postprocessing]
[example:webgl_postprocessing_advanced postprocessing advanced]
[example:webgl_postprocessing_backgrounds postprocessing backgrounds]
[example:webgl_postprocessing_transition postprocessing transition]
[example:webgl_postprocessing_dof postprocessing depth-of-field]
[example:webgl_postprocessing_dof2 postprocessing depth-of-field 2]
[example:webgl_postprocessing_fxaa postprocessing fxaa]
[example:webgl_postprocessing_glitch postprocessing glitch]
[example:webgl_postprocessing_godrays postprocessing godrays]
[example:webgl_postprocessing_gtao postprocessing gtao]
[example:webgl_postprocessing_masking postprocessing masking]
[example:webgl_postprocessing_material_ao postprocessing material ao]
[example:webgl_postprocessing_outline postprocessing outline]
[example:webgl_postprocessing_pixel postprocessing pixelate]
[example:webgl_postprocessing_procedural postprocessing procedural]
[example:webgl_postprocessing_rgb_halftone postprocessing rgb halftone]
[example:webgl_postprocessing_sao postprocessing sao]
[example:webgl_postprocessing_smaa postprocessing smaa]
[example:webgl_postprocessing_sobel postprocessing sobel]
[example:webgl_postprocessing_ssaa postprocessing ssaa]
[example:webgl_postprocessing_ssao postprocessing ssao]
[example:webgl_postprocessing_taa postprocessing taa]
[example:webgl_postprocessing_unreal_bloom postprocessing unreal bloom]
[example:webgl_postprocessing_unreal_bloom_selective postprocessing unreal bloom selective]

## 构造函数

### [name]( [param:WebGLRenderer renderer], [param:WebGLRenderTarget renderTarget] )

[page:WebGLRenderer renderer] -- 用于渲染场景的渲染器。
[page:WebGLRenderTarget renderTarget] -- （可选）一个预先配置的渲染目标，内部由 [name] 使用。

## 属性

### [property:Array passes]

一个用于表示后期处理过程链（包含顺序）的数组。

### [property:WebGLRenderTarget readBuffer]

内部读缓冲区的引用。过程一般从该缓冲区读取先前的渲染结果。

### [property:WebGLRenderer renderer]

内部渲染器的引用。

### [property:Boolean renderToScreen]

最终过程是否被渲染到屏幕（默认帧缓冲区）。

### [property:WebGLRenderTarget writeBuffer]

内部写缓冲区的引用。过程常将它们的渲染结果写入该缓冲区。

## 方法

### [method:undefined addPass]( [param:Pass pass] )

pass -- 将被添加到过程链的过程
将传入的过程添加到过程链。

### [method:undefined dispose]()

Frees the GPU-related resources allocated by this instance. Call this method whenever this instance is no longer used in your app.

### [method:undefined insertPass]( [param:Pass pass], [param:Integer index] )

pass -- 将被插入到过程链的过程。
index -- 定义过程链中过程应插入的位置。
将传入的过程插入到过程链中所给定的索引处。

### [method:Boolean isLastEnabledPass]( [param:Integer passIndex] )

passIndex -- 被用于检查的过程
如果给定索引的过程在过程链中是最后一个启用的过程，则返回true。 由[name]所使用，来决定哪一个过程应当被渲染到屏幕上。

### [method:undefined removePass]( [param:Pass pass] )

pass -- The pass to remove from the pass chain.
Removes the given pass from the pass chain.

### [method:undefined render]( [param:Float deltaTime] )

deltaTime -- The delta time value.
执行所有启用的后期处理过程，来产生最终的帧，

### [method:undefined reset]( [param:WebGLRenderTarget renderTarget] )

[page:WebGLRenderTarget renderTarget] -- （可选）一个预先配置的渲染目标，内部由 [name] 使用。
重置所有[name]的内部状态。

### [method:undefined setPixelRatio]( [param:Float pixelRatio] )

pixelRatio -- 设备像素比
设置设备的像素比。该值通常被用于HiDPI设备，以阻止模糊的输出。 因此，该方法语义类似于[page:WebGLRenderer.setPixelRatio]()。

### [method:undefined setSize]( [param:Integer width], [param:Integer height] )

width -- [name]的宽度。
height -- [name]的高度。
考虑设备像素比，重新设置内部渲染缓冲和过程的大小为(width, height)。 因此，该方法语义类似于[page:WebGLRenderer.setSize]()。

### [method:undefined swapBuffers]()

交换内部的读/写缓冲。

## 源代码

[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/postprocessing/EffectComposer.js examples/jsm/postprocessing/EffectComposer.js]