ComfyUI Node: ImageEffectsLensBokeh

ImageEffectsLensBokeh:

The ImageEffectsLensBokeh node is designed to simulate the bokeh effect, a popular photographic technique that creates aesthetically pleasing out-of-focus areas in an image. This effect is particularly useful for emphasizing a subject by blurring the background, thereby drawing the viewer's attention to the main focus of the image. The node allows you to customize various aspects of the bokeh effect, such as the shape and size of the lens blades, the intensity of the blur, and the method used to apply the blur. By adjusting these parameters, you can achieve a wide range of artistic effects, from subtle background blurs to dramatic, dream-like visuals.

ImageEffectsLensBokeh Input Parameters:

images

This parameter represents the input image or images to which the bokeh effect will be applied. It is essential for the node to have an image to process and generate the desired bokeh effect.

lens_shape

This parameter defines the shape of the lens blades used to create the bokeh effect. The shape of the lens blades can significantly impact the appearance of the bokeh, with different shapes producing different patterns in the out-of-focus areas.

lens_edge

This parameter specifies the edge type of the lens, which can be either "around" or "symmetric." The edge type affects how the bokeh effect is applied across the image, influencing the distribution and intensity of the blur.

lens_curvy

This parameter controls the curvature of the lens blades. Adjusting the curvature can change the smoothness and roundness of the bokeh effect, allowing for more customized and unique visual outcomes.

lens_zoom

This parameter adjusts the zoom level of the lens. Increasing the zoom level can enhance the intensity of the bokeh effect, making the out-of-focus areas more pronounced.

lens_aperture

This parameter determines the aperture size of the lens, which affects the depth of field and the overall intensity of the bokeh effect. A larger aperture size results in a shallower depth of field and a more pronounced bokeh effect.

blur_intensity

This parameter controls the intensity of the blur applied to the image. Higher blur intensity results in a stronger bokeh effect, making the out-of-focus areas more blurred and less detailed.

ImageEffectsLensBokeh Output Parameters:

result

This parameter represents the final image with the bokeh effect applied. It is the primary output of the node, showcasing the customized bokeh effect based on the input parameters.

mask

This parameter provides a mask that indicates the areas of the image where the bokeh effect has been applied. The mask can be useful for further image processing or for combining the bokeh effect with other visual effects.

ImageEffectsLensBokeh Usage Tips:

• Experiment with different lens_shape values to achieve various artistic effects in the bokeh pattern.
• Adjust the lens_aperture to control the depth of field and the prominence of the bokeh effect.
• Use the blur_intensity parameter to fine-tune the strength of the blur, balancing between subtle and dramatic effects.

ImageEffectsLensBokeh Common Errors and Solutions:

ValueError: Not existing lens_edge parameter.

• Explanation: This error occurs when an invalid value is provided for the lens_edge parameter.
• Solution: Ensure that the lens_edge parameter is set to either "around" or "symmetric."

ValueError: Unsupported method.

• Explanation: This error occurs when an invalid method is specified for the lens_blur function.
• Solution: Verify that the method parameter is set to either "dilate" or "filter."