Skip to main content

Blur Image

Applies various blur effects to an image including standard blur, adaptive blur, bilateral blur, and Gaussian blur.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • In Path - Path to the input image file.
  • Out Path - Path where the blurred output image will be saved.

Options​

  • Profile - Type of blur effect to apply. Options include:
    • Blur
    • Adaptive Blur
    • Bilateral Blur
    • Gaussian Blur
  • Height - Height parameter for bilateral blur (only available when Bilateral Blur is selected).
  • Width - Width parameter for bilateral blur (only available when Bilateral Blur is selected).
  • Radius - Radius parameter for Gaussian blur (only available when Gaussian Blur is selected).

Output​

  • result - Boolean indicating success or failure of the blur operation.

How It Works​

The Blur Image node uses ImageMagick library to apply different types of blur effects to images. When executed, the node:

  1. Validates input and output file paths
  2. Loads the specified input image
  3. Applies the selected blur effect based on the profile option:
    • Standard Blur: Applies a general blur effect
    • Adaptive Blur: Blurs pixels based on their local variance
    • Bilateral Blur: Blurs while preserving edges using width and height parameters
    • Gaussian Blur: Applies Gaussian function blur using radius parameter
  4. Saves the resulting blurred image to the output path

Requirements​

  • Valid input image file at the specified path
  • Output path must be writable
  • Valid numeric values for blur parameters when applicable

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid input file path
  • Input file not found at the specified path
  • Empty or invalid output file path
  • Invalid height or width values for bilateral blur (must be greater than zero)
  • Invalid radius value for Gaussian blur (must be greater than zero)

Usage Notes​

  • Different blur types produce different visual effects:
    • Standard blur creates a general softening effect
    • Adaptive blur preserves edges better than standard blur
    • Bilateral blur maintains edge details while smoothing textures
    • Gaussian blur creates a smooth, natural-looking blur
  • Parameter requirements vary by blur type:
    • Bilateral blur requires both width and height parameters
    • Gaussian blur requires a radius parameter
  • Higher parameter values generally produce stronger blur effects
  • Processing time may increase with larger images or stronger blur effects