ZPixmap转PNG像素错位问题求助及修正方案咨询

核心问题排查方向 #

ZPixmap格式下深度24、bits_per_pixel=32，意味着每个像素占4字节，仅低24位为有效颜色数据（剩余8位是填充位）。像素错位大概率是颜色通道顺序不匹配、行字节对齐错误或字节序（端序）问题导致的。

具体修正步骤 #

1. 修正颜色通道顺序 #

X11的ZPixmap默认采用BGRX格式（而非Pillow常用的RGBX），直接按RGB加载会引发颜色错乱与像素错位。可通过以下代码指定正确格式转换：

from PIL import Image
import numpy as np

# 读取共享内存保存的二进制数据
data = open("shm_data.bin", "rb").read()
width, height = 你的图像宽, 你的图像高

# 按uint32解析数据，拆分BGR通道并转换为RGB
pixel_arr = np.frombuffer(data, dtype=np.uint32).reshape((height, width))
bgr_data = np.zeros((height, width, 3), dtype=np.uint8)
bgr_data[..., 0] = (pixel_arr >> 16) & 0xFF  # 提取B通道
bgr_data[..., 1] = (pixel_arr >> 8) & 0xFF   # 提取G通道
bgr_data[..., 2] = pixel_arr & 0xFF          # 提取R通道

# BGR转RGB后保存为PNG
img = Image.fromarray(bgr_data[..., ::-1])
img.save("output.png")

2. 处理行字节对齐 #

X11要求ZPixmap的每行字节数必须是4的整数倍（宽度不足时自动填充），若C代码保存时未处理对齐，或Pillow加载时未指定正确stride，会导致行偏移错位：

• C代码中需确保每行实际字节数为((width * bits_per_pixel) + 31) // 32 * 4，而非简单的width * 4
• 若数据包含填充字节，Pillow加载时手动指定stride：

stride = 实际每行字节数 # 例如width=101时，stride=404
img = Image.frombytes("BGRX", (width, height), data, "raw", "BGRX", stride)
img = img.convert("RGB")
img.save("output.png")

3. 验证字节序（端序） #

X11像素数据使用主机字节序，跨平台读取时若未处理端序会导致像素值解析错误：

• 可通过十六进制数据验证：小端序下0xRRGGBBXX会存储为XX BB GG RR，若按大端序解析会变成XX RR GG BB，引发颜色错乱
• 解决方法：在numpy转换时指定字节序，例如dtype=np.dtype('<u4')（小端）或'>u4'（大端），匹配XServer的主机端序

4. 检查C代码保存逻辑 #

确保C代码正确读取共享内存中的ZPixmap数据，避免跨页或对齐问题：

#include <stdio.h>
#include <sys/shm.h>

int main() {
    int shmid = 你的共享内存ID;
    char *shmaddr = shmat(shmid, NULL, 0);
    int width = 图像宽, height = 图像高;
    int stride = ((width * 32) + 31) / 32 * 4; // 计算对齐后的行字节数
    FILE *fp = fopen("shm_data.bin", "wb");
    
    // 逐行写入数据，保证对齐正确性
    for (int y = 0; y < height; y++) {
        fwrite(shmaddr + y * stride, 1, stride, fp);
    }
    
    fclose(fp);
    shmdt(shmaddr);
    return 0;
}

十六进制数据验证方法 #

取你提供的部分十六进制数据，观察连续像素字节：

• 若数据为XX BB GG RR XX BB GG RR（小端BGRX），对应像素颜色应为(RR, GG, BB)
• 若解析后颜色与预期不符，说明通道顺序或端序错误；若行内像素偏移，说明stride计算错误

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