C语言SDL_Surface像素操作：SDL_GetRGB等函数使用问题

操作前提：所有直接访问像素缓冲区的操作前，必须调用SDL_LockSurface()锁定Surface，操作完成后调用SDL_UnlockSurface()解锁，否则会触发未定义行为。

问题1：使用SDL_GetRGB()获取像素、通过x/y坐标寻址像素 #

Surface的pixels字段是像素存储的首地址，pitch是每行像素的实际占用字节数（存在内存对齐填充，不能直接用宽度×单像素字节数计算），format->BytesPerPixel是单个像素占用的字节数（常见值：1=8位灰度、3=24位RGB、4=32位RGBA）。
x/y坐标对应像素的寻址和读取逻辑如下：

SDL_LockSurface(surface);
int bpp = surface->format->BytesPerPixel;
// 计算当前y行的首地址
Uint8 *row = (Uint8 *)surface->pixels + y * surface->pitch;
// 计算x坐标对应的像素地址
Uint8 *pixel_ptr = row + x * bpp;

// 根据单像素字节数读取像素值
Uint32 pixel_val;
switch(bpp) {
    case 1:
        pixel_val = *pixel_ptr;
        break;
    case 2:
        pixel_val = *(Uint16 *)pixel_ptr;
        break;
    case 3:
        // 兼容大小端的24位像素读取
        if(SDL_BYTEORDER == SDL_BIG_ENDIAN)
            pixel_val = pixel_ptr[0] << 16 | pixel_ptr[1] << 8 | pixel_ptr[2];
        else
            pixel_val = pixel_ptr[0] | pixel_ptr[1] << 8 | pixel_ptr[2] << 16;
        break;
    case 4:
        pixel_val = *(Uint32 *)pixel_ptr;
        break;
    default:
        pixel_val = 0;
}

// 用SDL_GetRGB拆分出R/G/B通道值
Uint8 r, g, b;
SDL_GetRGB(pixel_val, surface->format, &r, &g, &b);

SDL_UnlockSurface(surface);

问题2：存储像素数据的数组类型 #

• 若要存储和Surface格式完全一致的原始像素数据：使用Uint8类型数组，数组大小为 surface->h * surface->pitch，和Surface的pixels内存布局完全对齐，直接内存拷贝即可实现数据同步。
• 若要单独存储每个颜色通道：分别定义三个Uint8类型数组，大小为 surface->w * surface->h，每个数组元素对应坐标(x,y)的R/G/B值，索引为 y * surface->w + x。

问题3：使用SDL_CreateRGBSurfaceFrom()生成新Surface #

该函数会直接复用你传入的像素缓冲区（不会做额外内存拷贝），调用方式如下：

// processed_pixels为你处理好的像素缓冲区指针
int w = surface->w;
int h = surface->h;
int bit_depth = surface->format->BitsPerPixel; // 注意这里是位深，单位是bit
int pitch = surface->pitch;
// 直接复用原Surface的颜色掩码，避免格式不匹配
SDL_Surface *new_surface = SDL_CreateRGBSurfaceFrom(
    processed_pixels,
    w, h,
    bit_depth,
    pitch,
    surface->format->rmask,
    surface->format->gmask,
    surface->format->bmask,
    surface->format->amask
);

// 生成的new_surface可直接用SDL_BlitSurface绘制到目标Surface上
// 注意：processed_pixels缓冲区必须在new_surface销毁后再释放，否则会出现野指针

完整的嵌套循环遍历像素示例 #

符合你要求的y/x双层循环实现，包含读像素、修改、写回全流程：

SDL_Surface *surface = ...; // 你加载BMP得到的Surface
int w = surface->w;
int h = surface->h;
int bpp = surface->format->BytesPerPixel;

SDL_LockSurface(surface);

for(int y = 0; y < h; y++) {
    Uint8 *row = (Uint8 *)surface->pixels + y * surface->pitch;
    for (int x = 0; x < w; x++) {
        // 读取像素
        Uint8 *pixel_ptr = row + x * bpp;
        Uint32 pixel_val;
        switch(bpp) {
            case 3:
                if(SDL_BYTEORDER == SDL_BIG_ENDIAN)
                    pixel_val = pixel_ptr[0] << 16 | pixel_ptr[1] << 8 | pixel_ptr[2];
                else
                    pixel_val = pixel_ptr[0] | pixel_ptr[1] << 8 | pixel_ptr[2] << 16;
                break;
            case 4:
                pixel_val = *(Uint32 *)pixel_ptr;
                break;
            default:
                pixel_val = *pixel_ptr;
        }
        Uint8 r, g, b;
        SDL_GetRGB(pixel_val, surface->format, &r, &g, &b);

        // 此处添加你的像素处理逻辑，示例为灰度化
        Uint8 gray = 0.299*r + 0.587*g + 0.114*b;
        r = g = b = gray;

        // 写回处理后的像素，用SDL_MapRGB生成对应格式的像素值
        Uint32 new_pixel = SDL_MapRGB(surface->format, r, g, b);
        switch(bpp) {
            case 1:
                *pixel_ptr = new_pixel;
                break;
            case 2:
                *(Uint16 *)pixel_ptr = new_pixel;
                break;
            case 3:
                if(SDL_BYTEORDER == SDL_BIG_ENDIAN) {
                    pixel_ptr[0] = (new_pixel >> 16) & 0xFF;
                    pixel_ptr[1] = (new_pixel >> 8) & 0xFF;
                    pixel_ptr[2] = new_pixel & 0xFF;
                } else {
                    pixel_ptr[0] = new_pixel & 0xFF;
                    pixel_ptr[1] = (new_pixel >> 8) & 0xFF;
                    pixel_ptr[2] = (new_pixel >> 16) & 0xFF;
                }
                break;
            case 4:
                *(Uint32 *)pixel_ptr = new_pixel;
                break;
        }
    }
}

SDL_UnlockSurface(surface);

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