Interface DepthOfFieldParams

Parameters for a DepthOfField.

interface DepthOfFieldParams {
    farBlur?: number;
    focalRange?: number;
    focusDistance?: number;
    intensity?: number;
    nearBlur?: number;
    radius?: number;
    renderModes?: number[];
}

Properties

farBlur?: number

Blur multiplier for geometry farther than focusDistance.

Default is 1.0.

focalRange?: number

Distance band around DepthOfFieldParams.focusDistance that remains mostly sharp. Smaller values create a shallower focus region.

Default is 20.

focusDistance?: number

View-space distance, in world units, that remains sharp.

Default is 50.

intensity?: number

Overall blend strength for the blurred result.

Default is 0.75.

nearBlur?: number

Blur multiplier for geometry nearer than focusDistance.

Default is 0.25 so foreground geometry stays more legible.

radius?: number

Maximum blur radius in scene pixels.

Default is 4.

renderModes?: number[]

Which rendering modes in which to apply depth of field.

Default value is [RealisticRender] when this effect is explicitly configured. Omitted EffectsParams.depthOfField leaves the effect inactive.