Gaussian Blur Image

Controlled node

Overview

Apply a Gaussian blur effect to an image. This node smooths the image by averaging pixel values with their neighbors using a Gaussian weighting function, creating a soft, out-of-focus effect. The blur amount determines the radius of the blur kernel—higher values create stronger blurring.

Inputs

Input	Type	Description	Default
Run	Event	Triggers the node to process the image.	-
Image	Data	The input image to blur. Must be a valid image object.	-
Amount	Number	The blur radius/strength. Higher values create more blur. Values below 0 are clamped to 0.	0

Outputs

Output	Type	Description
Done	Event	Fires when the image processing is complete.
Output	Data	The blurred image object.

Runtime Behavior and Defaults

• Node Type: Controlled (requires a run event to execute)
• Default Amount: 0 (no blur applied if amount is not specified)
• Clamping: Negative amount values are automatically clamped to 0 (no blur)
• Image Processing: The node creates a clone of the input image before applying the blur, leaving the original image unchanged
• Output: Returns a new Jimp image object with the Gaussian blur effect applied

Example Usage

Connect an image source (such as a Read Image node or AI Generate Image node) to the Image input, specify a blur amount, and trigger the Run event:

1. Connect an image file from the library to the Image input
2. Set Amount to 5 for a moderate blur effect (or connect a number node)
3. Trigger the Run event to process the image
4. Use the Output to save the blurred image to the library or pass it to another image processing node

Performance Note

Higher blur amounts require more processing time. For very large images, consider resizing first if high-frequency detail is not needed.