Surface Blur

Surface Blur operator properties for Script Engine. Smooths flat areas of the picture while leaving sharp edges crisp. Useful for cleaning up skin in beauty and interview shots without making the whole image look soft, removing noise and grain from low-light camera sources, simplifying backgrounds for a stylised painterly look, reducing compression artefacts, and producing clean keys when softening only the inside of a region. Unlike Box Blur, edges and contours stay sharp.

Property	Type	Access	Description
`Radius`	`int`	`get/set`	Size of the smoothing area in pixels. [min=1, max=20, default=5]. Small values (1-5) clean up fine grain and skin texture. Larger values (10-20) produce a stronger painterly smoothing but cost more performance.
`Smoothing`	`int`	`get/set`	How much the smooth areas are softened. [min=0, max=100, default=50]. 0 leaves the picture untouched. Mid values (40-60) work well for skin smoothing and gentle noise reduction. High values (80-100) produce a strongly stylised, almost waxy look.
`Threshold`	`int`	`get/set`	How strongly edges are preserved. [min=0, max=100, default=50]. Low values keep more edges sharp and only smooth the very flattest areas. Higher values let the smoothing roll over softer edges as well, which removes more detail. Tune in combination with `Smoothing` to taste.
`Iterations`	`int`	`get/set`	How many times the filter is applied in sequence. [min=1, max=5, default=1]. 1 is normal use. Higher values produce a much stronger, more painterly result at the cost of performance.
`LuminanceOnly`	`bool`	`get/set`	When on, smooths only the brightness of the image and leaves the colour detail untouched. Useful for skin smoothing because it stops the colour from going flat or plastic.
`SkinTonesOnly`	`bool`	`get/set`	When on, the smoothing is applied only to areas of the picture that look like skin. Backgrounds, clothing and props are left alone. Use together with `SkinTolerance` to tune the detection.
`SkinTolerance`	`int`	`get/set`	How forgiving the skin detection is. [min=0, max=100, default=50]. Low values match only obvious skin; high values pick up a wider range of warm tones at the risk of including wood, sand or other skin-like colours. Affects only when `SkinTonesOnly` is on.
`OutputMode`	`SurfaceBlurOutput`	`get/set`	What is shown in the output. Final shows the normal smoothed result. Original bypasses the operator. Difference shows just what was smoothed away, and Skin Mask shows the skin-detection mask — both are diagnostic views useful while tuning.
`Minilog`	`FormattedMessage`	`get/set`	Status message from the operator (read-only, debug).
`ResetAllCmd`	`Command`	`get/set`	Reset all settings to their defaults (Radius 5, Smoothing 50, Threshold 50, Iterations 1, Luminance/Skin off, Skin tolerance 50, Output Final).

Inherits from: AbstractOperator, AbstractAudioMetering.

See also: Surface Blur in Operators — user-facing introduction, screenshots, and section summaries.