如何在Pygame中实现Surface边缘的渐变模糊效果？

Pygame自带的pygame.transform.box_blur和pygame.transform.gaussian_blur只能实现全局模糊，要做出边缘渐变模糊（中心清晰、边缘逐渐模糊过渡）的效果，核心思路是让模糊后的Surface仅在边缘区域显示，中心区域用原Surface覆盖，通过渐变遮罩控制模糊层的显示范围和透明度。

实现步骤 #

1. 生成原Surface的全局模糊版本
2. 创建一个「中心完全透明、边缘完全不透明」的渐变遮罩，用于过滤模糊层
3. 将模糊层与遮罩混合，再叠加到原Surface下方，实现边缘渐变模糊效果

完整代码示例 #

import pygame
pygame.init()

screen = pygame.display.set_mode((800, 600))
clock = pygame.time.Clock()

# 示例原Surface（红色方形）
original_surface = pygame.Surface((200, 200))
original_surface.fill((255, 0, 0))

def create_edge_blur_surface(surface, blur_radius, edge_softness):
    # 1. 生成全局模糊的Surface
    blurred_surface = pygame.transform.gaussian_blur(surface, blur_radius)
    
    # 2. 创建渐变遮罩：中心透明，边缘不透明，模拟渐变过渡
    mask_size = (surface.get_width() + edge_softness*2, surface.get_height() + edge_softness*2)
    mask = pygame.Surface(mask_size, pygame.SRCALPHA)
    
    # 通过多层不同透明度的矩形生成渐变效果（层数越多过渡越平滑）
    for i in range(edge_softness, 0, -1):
        # 从边缘到中心，透明度逐渐降低
        alpha_value = int(255 * (i / edge_softness))
        # 每层矩形向内收缩1像素
        rect = pygame.Rect(edge_softness - i, edge_softness - i, 
                           surface.get_width() + i*2, surface.get_height() + i*2)
        pygame.draw.rect(mask, (0, 0, 0, alpha_value), rect, width=1)
    
    # 3. 将模糊层与遮罩混合，只保留边缘模糊区域
    blurred_edge = blurred_surface.copy()
    blurred_edge.blit(mask, (-edge_softness, -edge_softness), special_flags=pygame.BLEND_RGBA_MULT)
    
    return blurred_edge

# 生成不同模糊程度的效果
medium_blur = create_edge_blur_surface(original_surface, blur_radius=10, edge_softness=30)
high_blur = create_edge_blur_surface(original_surface, blur_radius=20, edge_softness=50)

running = True
while running:
    screen.fill((200, 200, 200))
    
    # 绘制三个示例：无模糊、中等模糊、高度模糊
    # 无模糊
    screen.blit(original_surface, (100, 200))
    # 中等模糊：先画模糊边缘层，再画原Surface
    screen.blit(medium_blur, (300 - 30, 200 - 30))
    screen.blit(original_surface, (300, 200))
    # 高度模糊
    screen.blit(high_blur, (500 - 50, 200 - 50))
    screen.blit(original_surface, (500, 200))
    
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
    
    pygame.display.flip()
    clock.tick(60)

pygame.quit()

效果调整说明 #

• blur_radius：控制模糊的强度，数值越大模糊越明显
• edge_softness：控制渐变边缘的宽度，数值越大过渡区域越宽
• 如果需要圆形/椭圆形的渐变模糊，可以把遮罩的矩形绘制改成圆形绘制，或者通过缩放小尺寸渐变图实现径向渐变遮罩

内容的提问来源于stack exchange，提问作者Aradyan