Cairo转PyGame时出现异常颜色显示问题

问题现象 #

• 原代码中ctx.set_source_rgb(0, 0, 1)能正常渲染蓝色矩形
• 将颜色改为ctx.set_source_rgb(0, 0, 0)时，黑色矩形完全无显示
• 调整蓝色分量（0~1区间）时，实际效果为透明度变化而非蓝色深浅变化
• 使用set_source_rgba设置颜色和透明度时，同样存在异常

原因分析 #

Cairo的FORMAT_ARGB32格式像素字节顺序为ARGB（Alpha、Red、Green、Blue），但Pygame的pygame.image.frombuffer方法在指定"ARGB"格式时，实际会按照BGRA的字节顺序解析像素数据（底层依赖SDL框架的像素格式特性导致）。这种字节顺序不匹配，导致颜色通道被错误映射：

• 蓝色分量被当作透明度通道，所以调整蓝色值时看起来是透明度变化
• 黑色（所有颜色分量为0）会被解析为全透明，因此无法显示

解决方法 #

方法1：修改Pygame的格式参数（最简单） #

直接将frombuffer的格式参数从"ARGB"改为"BGRA"，无需额外处理像素数据：

# 原代码中这一行
img = pygame.image.frombuffer(buf, (WIDTH, HEIGHT), "ARGB")
# 修改为
img = pygame.image.frombuffer(buf, (WIDTH, HEIGHT), "BGRA")

方法2：手动转换像素字节顺序 #

如果需要保留Pygame的格式参数，可以通过numpy转换Cairo输出的像素数据，将ARGB转为BGRA：

import pygame
import cairo
import numpy as np

WIDTH, HEIGHT = 640, 480

pygame.display.init()
screen = pygame.display.set_mode((WIDTH, HEIGHT), 0, 32)
screen.fill((255, 255, 255))

surface = cairo.ImageSurface(cairo.FORMAT_ARGB32, WIDTH, HEIGHT)
ctx = cairo.Context(surface)

# 设置黑色，测试正常显示
ctx.set_source_rgb(0, 0, 0)
ctx.rectangle(0, 0, 100, 100)
ctx.fill()

buf = surface.get_data()
# 将ARGB字节顺序转为BGRA
pixel_array = np.frombuffer(buf, dtype=np.uint8).reshape(HEIGHT, WIDTH, 4)
pixel_array = pixel_array[:, :, [2, 1, 0, 3]]  # 交换R和B通道位置
img = pygame.image.frombuffer(pixel_array.tobytes(), (WIDTH, HEIGHT), "BGRA")

screen.blit(img, (0, 0))
pygame.display.flip()

clock = pygame.time.Clock()
while not pygame.QUIT in [e.type for e in pygame.event.get()]:
    clock.tick(30)

验证效果 #

修改后：

• ctx.set_source_rgb(0,0,0)可以正常显示黑色矩形
• 调整蓝色分量时，会正确呈现蓝色深浅变化
• 使用set_source_rgba设置的颜色和透明度均能正常生效

内容的提问来源于stack exchange，提问作者Anonymous Nyan Cat