Depth of Field

Blur - Depth-of-field post effect

This effect is a blur whose radius differs for each pixel and depends on pixel depth.

The radius for a given pixel is known as the Circle-of-confusion for this pixel and can be configured thanks to the Coc Function parameter.

By default this function is linked to a Lens DoF model, but it can be changed to Simple DoF to use settings or to any other Function .

One key parameter inside Lens DoF and Simple DoF is the Focus Distance that determines the distance at which objects are perfectly sharp. By default, this distance is linked to the focus distance of the camera, which itself by default is linked to the camera distance to target.

If preferred, the focus distance can be overridden directly from within the depth of field modifier. This is made by enabling the Focus Distance option inside the DoF function and entering values manually there.

Variables:

Shape: Shape of the bokehs. This effect works better with the Circle and Hexagon shapes, but can be used with any other Blur shape.
Quality: Quality of the depth of field . It is recommended to have at least 3 times more budget than the maximal blur radius. For example, if the maximal blur radius is 20px, the budget should be at least equal to 60.
Style: Configure here the blending modes and filters for your blur
Blending Mode With Input: How this blur style parameters gets blended
Coc Function: Circle-of-confusion function that determines the blur amount in function of the pixel depth

Python

    Oil.createObject("DepthOfFieldV8TextureModifier")