Back to Three Js

BokehPass

docs/pages/BokehPass.html

latest2.7 KB
Original Source

Import

BokehPass is an addon, and must be imported explicitly, see Installation#Addons.

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

Constructor

new BokehPass( scene : Scene, camera : Camera, params : BokehPass~Options )

Constructs a new Bokeh pass.

| scene |

The scene to render the DOF for.

| | camera |

The camera.

| | params |

The pass options.

|

Properties

.camera : Camera

The camera.

.materialBokeh : ShaderMaterial

The pass bokeh material.

.scene : Scene

The scene to render the DOF for.

.uniforms : Object

The pass uniforms. Use this object if you want to update the focus, aperture or maxblur values at runtime.

pass.uniforms.focus.value = focus;
pass.uniforms.aperture.value = aperture;
pass.uniforms.maxblur.value = maxblur;

Methods

.dispose()

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

Overrides: Pass#dispose

.render( renderer : WebGLRenderer, writeBuffer : WebGLRenderTarget, readBuffer : WebGLRenderTarget, deltaTime : number, maskActive : boolean )

Performs the Bokeh pass.

| renderer |

The renderer.

| | writeBuffer |

The write buffer. This buffer is intended as the rendering destination for the pass.

| | readBuffer |

The read buffer. The pass can access the result from the previous pass from this buffer.

| | deltaTime |

The delta time in seconds.

| | maskActive |

Whether masking is active or not.

|

Overrides: Pass#render

.setSize( width : number, height : number )

Sets the size of the pass.

| width |

The width to set.

| | height |

The height to set.

|

Overrides: Pass#setSize

Type Definitions

.Options

Constructor options of BokehPass.

| focus
number |

Defines the effect's focus which is the distance along the camera's look direction in world units.

Default is 1.

| | aperture
number |

Defines the effect's aperture.

Default is 0.025.

| | maxblur
number |

Defines the effect's maximum blur.

Default is 1.

|

Source

examples/jsm/postprocessing/BokehPass.js