基于Pygame与Sobel滤波器的ASCII艺术图像显示异常问题

核心原因：终端字符宽高比失衡 #

终端字符默认是宽大于高（通常宽高比约2:1，即字符高度是宽度的2倍），如果处理图像时直接沿用原始图像的宽高比缩放，就会导致纵向显示异常。Linux Mint logo这类长方形图像可能刚好适配了错误的比例，所以显示正常；而Ubuntu logo这类接近正方形的图像，就会出现明显的纵向压缩。

解决方案步骤 #

1. 校正图像缩放的宽高比 #

在处理图像前，根据终端字符的宽高比调整目标高度，确保缩放后的图像在终端中比例正确。

修改图像缩放逻辑，添加字符宽高比参数：

# 可根据你的终端实际情况微调，一般取值0.4-0.6
CHAR_ASPECT_RATIO = 0.5

# 读取图像后计算校正后的尺寸
target_width = 120  # 自定义ASCII输出宽度
original_width, original_height = img.size
# 校正高度：原始高度比例 × 字符宽高比
target_height = int(original_height * target_width / original_width * CHAR_ASPECT_RATIO)

# 统一缩放两层图像（普通ASCII和Sobel边缘）到该尺寸
resized_img = img.resize((target_width, target_height))

2. 确保两层图像尺寸完全一致 #

检查Sobel边缘检测模块和普通ASCII生成模块，必须使用相同的目标尺寸处理图像，禁止各自独立缩放。比如在Sobel模块中，直接使用主代码传递的已缩放图像，而非重新读取并缩放。

3. 排查旋转操作的影响 #

如果之前尝试过旋转图像，旋转后需重新计算校正后的尺寸，且旋转操作不能打乱宽高比逻辑。比如旋转90度后，需先交换宽高再应用字符宽高比校正：

# 旋转90度并扩展画布以保留完整图像
rotated_img = img.rotate(90, expand=True)
rotated_width, rotated_height = rotated_img.size
# 校正旋转后的高度
target_height_rot = int(rotated_height * target_width / rotated_width * CHAR_ASPECT_RATIO)
resized_rot_img = rotated_img.resize((target_width, target_height_rot))

代码修改示例（主代码部分） #

from PIL import Image
import sobel_module

def generate_ascii(img, chars):
    ascii_str = ""
    for y in range(img.height):
        for x in range(img.width):
            gray = img.getpixel((x, y))
            ascii_str += chars[gray // 25]
        ascii_str += "\n"
    return ascii_str

def main():
    CHAR_ASPECT_RATIO = 0.5
    target_width = 120
    chars = "@%#*+=-:. "

    # 读取图像并转为灰度模式
    img = Image.open("ubuntu-logo.png").convert("L")
    original_width, original_height = img.size

    # 计算校正后的目标高度
    target_height = int(original_height * target_width / original_width * CHAR_ASPECT_RATIO)
    resized_img = img.resize((target_width, target_height))

    # 生成两层ASCII内容
    normal_ascii = generate_ascii(resized_img, chars)
    sobel_ascii = sobel_module.generate_sobel_ascii(resized_img, chars)

    # 叠加显示：用边缘字符替换普通ASCII的空白位置
    overlay_ascii = ""
    for normal_line, sobel_line in zip(normal_ascii.splitlines(), sobel_ascii.splitlines()):
        overlay_line = "".join([sobel_char if sobel_char != " " else normal_char for normal_char, sobel_char in zip(normal_line, sobel_line)])
        overlay_ascii += overlay_line + "\n"

    print(overlay_ascii)

if __name__ == "__main__":
    main()

Sobel模块适配修改 #

确保模块直接使用传入的已缩放图像处理：

# sobel_module.py
import numpy as np
from PIL import Image

def generate_sobel_ascii(img, chars):
    img_array = np.array(img)
    # Sobel边缘检测算子
    sobel_x = np.array([[-1, 0, 1], [-2, 0, 2], [-1, 0, 1]])
    sobel_y = np.array([[-1, -2, -1], [0, 0, 0], [1, 2, 1]])

    height, width = img_array.shape
    edge_array = np.zeros_like(img_array)

    # 计算边缘强度
    for i in range(1, height-1):
        for j in range(1, width-1):
            gx = np.sum(img_array[i-1:i+2, j-1:j+2] * sobel_x)
            gy = np.sum(img_array[i-1:i+2, j-1:j+2] * sobel_y)
            edge_array[i][j] = np.sqrt(gx**2 + gy**2)

    # 归一化到0-255区间
    edge_array = (edge_array / edge_array.max() * 255).astype(np.uint8)

    # 生成边缘ASCII字符串
    ascii_str = ""
    for row in edge_array:
        ascii_str += "".join([chars[pixel // 25] for pixel in row]) + "\n"
    return ascii_str

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