Bokeh-Blur Node

In photography, Bokeh is the effect produced by a lens that causes the brighter regions of out-of-focus areas to blur in the shape of the lens' aperture. In Harmony, the Bokeh effect is used to mimic this photographic-appearance by blurring an image with a specified lens shape and amplifying the effect in brighter areas.

The following image is an example of a network for the Bokeh-Blur effect.

Properties

In Harmony, you can control the shape of the filter used to blur the image in order to create the desired aesthetic for out-of-focus images.

Parameter	Description
Name	The name of the node as it appears in the Node View and the Timeline view. Each node must have a name that is unique to its containing group.
Radius	The value specifying the size of the filter used to blur the image. A higher radius value will make the lens shapes appear larger. However, the image will appear more blurred overall.
Sharpness	The value that specifies the sharpness at the edge of the lens shape. A higher value will emphasize and sharpen the edge of the lens shape, creating the appearance of an outline on the bokeh highlights.
Brightness
Threshold	When checked, you may set the values for Luminance Threshold and Brightness Multiplier.
Luminance Threshold	When the threshold option is checked, the Luminance Threshold provides a cutoff value that defines the region of the image that will be brightened with the brightness multiplier. Areas above this luminance value will be brightened based on the value specified in the brightness multiplier - areas below this luminance value will remain unaffected.
Brightness Multiplier	When the threshold option is checked, the Brightness Multiplier will be used as a multiplier to the areas of the image that are above the luminance threshold. This will cause bright areas to become brighter and the lens shapes will become more distinct.
Shape
Shape Type	Allows you to select a shape of the filter. The three options are: Blades - A convex shape with the defined amount of sides. Disk - A circular shape that provides a simple round filter. Star - A concave shape with the defined amount of points and the specified indentation amount. The shape is set to Disk by default
Sides	Sets the number of sides for each shape. Not applicable for the disk or completely round filters.
Indentation	The amount of indentation applied to the concave regions of the Star filter type - a value of 1.0 will indent the concave regions entirely to the center of the star, and a value of 0.0 will cause the concave portions of the Star to match its convex points. This option is only available if the Star shape is selected.
Roundness	Allows you to control how round the filter appears. This option is only available for the Blades and Star shapes.
Angle	The angle of the bokeh filter in degrees.
Truck Factor	Readjusts the values of the bright spots when the elements in the scene undergo a change in depth or scale. When disabled, the brightness of the spots will remain unchanged regardless of depth or scale changes.
Repeat Edges	Makes the blur algorithm operate as if the pixel values beyond the edge of the layer are the same as the values of the edge pixels. This prevents the pixels at the edge of an image from darkening and becoming more transparent.