使用xcb-shm抓屏时，如何向xcb_shm_get_image()传递shm/fd的stride值？

一、适配Stride的直接解决方案 #

xcb_shm_get_image本身不支持直接传入自定义stride参数，但可以通过两种方式处理不匹配问题：

• 逐行裁剪有效像素数据：当GBM缓冲区的stride大于width*4时，逐行复制每行前width*4字节的有效像素到符合XCB要求的内存区域，跳过GBM自动添加的填充部分，再将处理后的内存传入XCB的SHM区域。
• 强制创建线性GBM缓冲区：调用gbm_bo_create时，添加GBM_BO_USE_LINEAR标志（需硬件支持），强制GBM生成stride等于width*4的线性布局缓冲区。注意：部分GPU不支持该模式，可能降低性能。

二、自动处理Stride的高效替代方案 #

如果不想手动处理stride，这些方案可以自动适配底层缓冲区：

• 使用XFixes扩展的XFixesGetImage：libxcb-xfixes的截图接口封装了缓冲区适配逻辑，无需手动管理SHM和GBM细节，调用简单且兼容性强。
• 使用ffmpeg的libavdevice：通过x11grab设备直接捕获屏幕，内部已处理所有缓冲区格式和stride问题，还支持硬件加速，适合需要编码的场景。
• 直接使用DRM原子API捕获：绕过XCB，通过DRM接口直接读取帧缓冲区，完全控制缓冲区参数，适合无X或纯Wayland环境，但实现复杂度较高。

代码示例（手动处理Stride） #

假设已获取GBM缓冲区的映射数据和stride：

// 计算XCB所需的目标stride
int target_stride = width * 4;
// 获取GBM缓冲区的映射数据和实际stride
uint8_t *gbm_data = gbm_bo_map(bo, 0, 0, width, height, GBM_BO_TRANSFER_READ, NULL, &gbm_stride);
// 分配符合XCB要求的内存
uint8_t *xcb_data = malloc(target_stride * height);

// 逐行复制有效像素
for (int y = 0; y < height; y++) {
    memcpy(xcb_data + y * target_stride, gbm_data + y * gbm_stride, target_stride);
}

// 将xcb_data传入XCB SHM完成捕获
// ... 后续XCB相关操作 ...

// 释放资源
free(xcb_data);
gbm_bo_unmap(bo, gbm_data);

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