PowerBlur 0.1.2

PowerBlur is an image blur processing tool based on Pillow...

PowerBlur

| English | 简体中文 |

📖 Introduction

PowerBlur is an image blurring tool based on Pillow, offering a high degree of freedom. It can achieve effects similar to the frosted glass effect found in systems like Windows/Mac (?).

⬇️ Installation

Make sure to use version 0.0.3 or higher; otherwise, it might not function properly.

pip install PowerBlur

🧑‍💻 Usage

Example Code

from PIL import Image
import PowerBlur

# Load the image
image = Image.open("image.jpg")

# Get image size
width, height = image.size

# Apply the power blur effect
PowerBlur.power_blur(image, (int(width*0.1), int(height*0.1), int(width*0.9), int(height*0.9)))

# Save the blurred image
image.save("output.jpg")

Parameter Explanation

Parameter	Required/Default Value	Type	Description
image	✔️	Image	The image to be processed
size	✔️	tuple/list[int, int, int, int]	The area of the image to be processed, in the format (x1, y1, x2, y2)
radius	❌ (default is 25)	int	Corner radius; 0 means no corner radius
mask_fill	❌ (default is (255, 255, 255))	tuple/list[int, int, int]	Mask color (R, G, B)
mask_alpha	❌ (default is 100)	int	Mask opacity (0~255); 0 is fully opaque, 100 is fully transparent
outline_fill	❌ (default is (0, 0, 0))	tuple/list[int, int, int]	Outline color (R, G, B)
outline_width	❌ (default is 5)	int	Outline width
outline_alpha	❌ (default is 128)	int	Outline opacity (0~255); 0 is fully transparent, 128 is semi-transparent
noise_mean	❌ (default is 0.03)	float	Gaussian noise mean (0~255)
noise_std	❌ (default is 10)	float	Gaussian noise standard deviation; 0 means no noise
sigma	❌ (default is 5)	float	Gaussian blur parameter; 0 means no blur
exposure	❌ (default is 1)	float	Exposure (0~10); 0 means no exposure
saturation	❌ (default is 1)	float	Saturation; 0 means no saturation
copy	❌ (default is False)	bool	Whether to copy the original image without modifying it

Concerned about configuring all these parameters? We’ve prepared some presets for you.

Preset Name	Chinese Name	Formula
power_blur		The default one; nothing much to say, but the author finds it quite nice
blur		Basic blur effect, nothing special
aero		Windows 7 glass effect, with exposure and saturation effects
acrylic	亚克力	Blur, overlay blend, saturation, color mask, noise texture
mica	云母	Blur, saturation, color mask

✨ Effect Showcase

Original Image

Processed Image

License

Copyright 2025 Xiaosu.

Distributed under the terms of the Apache 2.0 license.