使用vkCmdCopyBufferToImage创建Texture2DArray时的显示异常问题

核心错误点 #

你代码里的关键问题是所有层的bufferOffset都设为0，导致每个Image Array层都从暂存缓冲区的起始位置拷贝数据，重复读取了原纹理的前48×112区域，而非各自对应的48列区块，这是显示异常的根本原因。

另外，bufferImageHeight设为112是无效的——这个参数仅针对3D图像拷贝，对于2D图像数组，Vulkan会忽略该值，所以调整它不会有任何效果。

两种解决方案 #

根据你暂存缓冲区的数据布局，分两种情况处理：

方案1：重新组织缓冲区数据（推荐） #

如果可以修改暂存缓冲区的数据排列，将每个48×112的层连续存储（先存Layer0的所有行，再存Layer1，以此类推），此时修正代码如下（假设单通道像素为uint8，字节数为1）：

const uint32_t pixel_size = 1; // 单通道像素的字节数，根据实际格式调整（如float则为4）
const uint32_t layer_total_size = 48 * 112 * pixel_size;

vk::BufferImageCopy buffer_image_copies[12] = {};
for (uint32_t i = 0; i < 12; ++i) {
    buffer_image_copies[i].bufferOffset = i * layer_total_size; // 每个层对应缓冲区的不同起始位置
    buffer_image_copies[i].bufferRowLength = 48; // 缓冲区中当前层的行宽度
    buffer_image_copies[i].bufferImageHeight = 0; // 2D图像无需设置，设为0让Vulkan自动处理
    buffer_image_copies[i].imageSubresource.aspectMask = vk::ImageAspectFlagBits::eColor;
    buffer_image_copies[i].imageSubresource.mipLevel = 0;
    buffer_image_copies[i].imageSubresource.baseArrayLayer = i;
    buffer_image_copies[i].imageSubresource.layerCount = 1;
    buffer_image_copies[i].imageOffset = vk::Offset3D(0, 0, 0);
    buffer_image_copies[i].imageExtent = vk::Extent3D(48, 112, 1);
}

command_buffer.copyBufferToImage(staging_buffer, car_volume_texture.image, 
                                 vk::ImageLayout::eTransferDstOptimal, 
                                 12, buffer_image_copies);

方案2：保留原缓冲区布局（逐行拷贝） #

如果无法修改缓冲区数据（原数据是12个48×112层横向拼接成576×112的行优先存储），需要逐行拷贝每个层的对应区域：

const uint32_t pixel_size = 1;
std::vector<vk::BufferImageCopy> buffer_image_copies;
buffer_image_copies.reserve(12 * 112);

for (uint32_t layer_idx = 0; layer_idx < 12; ++layer_idx) {
    for (uint32_t row_idx = 0; row_idx < 112; ++row_idx) {
        vk::BufferImageCopy copy{};
        // 计算当前层当前行在缓冲区的起始偏移
        copy.bufferOffset = row_idx * 576 * pixel_size + layer_idx * 48 * pixel_size;
        copy.bufferRowLength = 48; // 单次拷贝一行中的48个像素
        copy.bufferImageHeight = 0;
        copy.imageSubresource.aspectMask = vk::ImageAspectFlagBits::eColor;
        copy.imageSubresource.mipLevel = 0;
        copy.imageSubresource.baseArrayLayer = layer_idx;
        copy.imageSubresource.layerCount = 1;
        copy.imageOffset = vk::Offset3D(0, row_idx, 0); // 拷贝到当前层的对应行
        copy.imageExtent = vk::Extent3D(48, 1, 1); // 仅拷贝一行高度
        buffer_image_copies.push_back(copy);
    }
}

command_buffer.copyBufferToImage(staging_buffer, car_volume_texture.image, 
                                 vk::ImageLayout::eTransferDstOptimal, 
                                 static_cast<uint32_t>(buffer_image_copies.size()), 
                                 buffer_image_copies.data());

关于bufferRowLength的说明 #

你之前调整bufferRowLength后显示更差，是因为原缓冲区的行宽度是576，而你设置为48时，Vulkan会用这个值计算跨行偏移（下一行起始为当前偏移+48×像素字节数），但实际缓冲区下一行的起始是576×像素字节数，导致数据读取严重错位，所以显示效果恶化。

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