Class: RenderPass
Re-exported types from postprocessing
Hierarchy
↳
RenderPass
Table of contents
Constructors
Properties
Methods
- dispose
- getClearPass
- getDepthTexture
- getFullscreenMaterial
- initialize
- render
- setDepthTexture
- setFullscreenMaterial
- setSize
Constructors
constructor
• new RenderPass(scene, camera, overrideMaterial?)
Parameters
| Name | Type |
|---|---|
scene | Scene |
camera | Camera |
overrideMaterial? | Material |
Overrides
Defined in
packages/three/types/postprocessing.d.ts:930
Properties
camera
• Protected camera: Camera
The camera.
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:612
clear
• clear: boolean
Indicates whether the target buffer should be cleared before rendering.
Defined in
packages/three/types/postprocessing.d.ts:940
enabled
• enabled: boolean
Indicates whether this pass should be executed.
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:637
name
• name: string
The name of this pass.
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:602
needsDepthTexture
• needsDepthTexture: boolean
Indicates whether the EffectComposer should prepare a depth texture for this pass.
Set this to true if this pass relies on depth information from a
preceding RenderPass.
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:632
needsSwap
• needsSwap: boolean
Only relevant for subclassing.
Indicates whether the EffectComposer should swap the frame buffers after this pass has finished rendering.
Set this to false if this pass doesn't render to the output buffer or
the screen. Otherwise, the contents of the input buffer will be lost.
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:623
overrideMaterial
• overrideMaterial: Material
An override material.
Defined in
packages/three/types/postprocessing.d.ts:935
renderToScreen
• renderToScreen: boolean
Indicates whether this pass should render to screen.
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:642
scene
• Protected scene: Scene
The scene to render.
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:607
Methods
dispose
▸ dispose(): void
Performs a shallow search for disposable properties and deletes them. The pass will be inoperative after this method was called!
Disposable objects:
- WebGLRenderTarget
- Material
- Texture
The EffectComposer calls this method when it is being destroyed. You may, however, use it independently to free memory when you are certain that you don't need this pass anymore.
Returns
void
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:745
getClearPass
▸ getClearPass(): ClearPass
Returns the clear pass.
Returns
ClearPass
The clear pass.
Defined in
packages/three/types/postprocessing.d.ts:946
getDepthTexture
▸ getDepthTexture(): Texture
Returns the current depth texture.
Returns
Texture
The current depth texture, or null if there is none.
Overrides
Defined in
packages/three/types/postprocessing.d.ts:952
getFullscreenMaterial
▸ getFullscreenMaterial(): Material
Returns the current fullscreen material.
Returns
Material
The current fullscreen material, or null if there is none.
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:648
initialize
▸ initialize(renderer, alpha, frameBufferType): void
Performs initialization tasks.
By overriding this method you gain access to the renderer. You'll also be able to configure your custom render targets to use the appropriate format (RGB or RGBA).
The provided renderer can be used to warm up special off-screen render targets by performing a preliminary render operation.
The EffectComposer calls this method when this pass is added to its queue, but not before its size has been set.
example
if(!alpha && frameBufferType === UnsignedByteType) { this.myRenderTarget.texture.format = RGBFormat; }
Parameters
| Name | Type | Description |
|---|---|---|
renderer | WebGLRenderer | The renderer. |
alpha | boolean | Whether the renderer uses the alpha channel or not. |
frameBufferType | number | The type of the main frame buffers. |
Returns
void
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:726
render
▸ render(renderer, inputBuffer, outputBuffer, deltaTime?, stencilTest?): void
Renders the scene.
Parameters
| Name | Type | Description |
|---|---|---|
renderer | WebGLRenderer | The renderer. |
inputBuffer | WebGLRenderTarget | A frame buffer that contains the result of the previous pass. |
outputBuffer | WebGLRenderTarget | A frame buffer that serves as the output render target unless this pass renders to screen. |
deltaTime? | number | - |
stencilTest? | boolean | - |
Returns
void
Overrides
Defined in
packages/three/types/postprocessing.d.ts:972
setDepthTexture
▸ setDepthTexture(depthTexture, depthPacking?): void
Sets the depth texture.
The provided texture will be attached to the input buffer unless this pass renders to screen.
Parameters
| Name | Type | Description |
|---|---|---|
depthTexture | DepthTexture | A depth texture. |
depthPacking? | number | - |
Returns
void
Overrides
Defined in
packages/three/types/postprocessing.d.ts:962
setFullscreenMaterial
▸ Protected setFullscreenMaterial(material): void
Sets the fullscreen material.
The material will be assigned to a mesh that fills the screen. The mesh will be created once a material is assigned via this method.
Parameters
| Name | Type | Description |
|---|---|---|
material | Material | A fullscreen material. |
Returns
void
Inherited from
Defined in
packages/three/types/postprocessing.d.ts:657
setSize
▸ setSize(width, height): void
Updates this pass with the renderer's size.
You may override this method in case you want to be informed about the size of the main frame buffer.
The EffectComposer calls this method before this pass is initialized and every time its own size is updated.
example
this.myRenderTarget.setSize(width, height);
Parameters
| Name | Type | Description |
|---|---|---|
width | number | The renderer's width. |
height | number | The renderer's height. |
Returns
void