如何用libpng将8位索引PNG图像转换为8位RGBA格式？

问题 #

我正在编写处理PNG文件的C++程序，希望根据输入图像位深度将其转换为8位或16位RGBA格式，目前聚焦8位转换。我用GIMP制作了测试索引色图像，尝试转换为8位RGBA却多次失败。

代码实现 #

#include <iostream>
#include <cstdio>
#include <png.h>

int main(int argc, char** argv) {
    // reading
    png_structp png = png_create_read_struct(PNG_LIBPNG_VER_STRING, nullptr, nullptr, nullptr);
    png_infop info = png_create_info_struct(png);

    std::FILE* fp = std::fopen("paletted.png", "rb");
    png_init_io(png, fp);
    png_read_info(png, info);

    png_uint_32 width, height; 
    int depth, color;
    png_get_IHDR(png, info, &width, &height, &depth, &color, nullptr, nullptr, nullptr);

    std::cout << "depth: " << depth << "\ncolor: " 
        << color << "\nsize: " << width << 'x' << height << std::endl;

    png_set_expand(png); // makes rgb from indexed
    #if 1 // input image does not have tRNS but anyway
    if (png_get_valid(png, info, PNG_INFO_tRNS))
        png_set_tRNS_to_alpha(png);
    else {
        std::cout << "No tRNS chunk, adding alpha chanel\n";
        png_set_add_alpha(png, 1 << 16, PNG_FILLER_AFTER); // now it should be rgba
    }
    #endif

    png_read_update_info(png, info);

    png_bytepp rows = new png_bytep[height];
    for (int i = 0; i < height; i++)
        rows[i] = new png_byte[width*4]; // multiplying by 4 because rgba is 4 bytes per pixel
    
    png_read_image(png, rows);
    png_read_end(png, nullptr);

    std::fclose(fp);

    png_destroy_read_struct(&png, &info, nullptr);

    // writting
    #define OPUTPUT_TYPE PNG_COLOR_TYPE_RGBA // try plain rgb
    png = png_create_write_struct(PNG_LIBPNG_VER_STRING, nullptr, nullptr, nullptr);
    info = png_create_info_struct(png);
    png_set_IHDR(
        png, info, width, height, 8, OPUTPUT_TYPE, 
        PNG_INTERLACE_NONE, PNG_COMPRESSION_TYPE_DEFAULT, 
        PNG_FILTER_TYPE_DEFAULT
    );
    fp = std::fopen("paletted1.png", "wb");
    png_init_io(png, fp);
    png_write_info(png, info);
    png_write_image(png, rows);
    png_write_end(png, nullptr);
    png_destroy_write_struct(&png, &info);

    for (int i = 0; i < height; i++)
        delete[] rows[i];
    delete[] rows;

    return 0;
}

CMake配置 #

cmake_minimum_required(VERSION 3.25)

project(pngpaletted LANGUAGES CXX)

find_package(PNG REQUIRED)

add_executable(plt main.cpp)
target_link_libraries(plt PNG::PNG)

运行情况 #

输入为一张GIMP制作的索引色图像，运行程序后输出：

$ ./plt
depth: 8
color: 3
size: 36x94

得到的结果：

• 开启alpha添加代码时，得到全透明的32位RGBA图像；
• 关闭alpha添加代码时，图像像是RGB数据写入了RGBA缓冲区；
• 将输出类型改为PNG_COLOR_TYPE_RGB时，得到无alpha通道的8位RGB图像，与输入一致。

看起来调用png_set_add_alpha后，libpng似乎清除了png_set_expand处理后的数据，请问如何通过标准libpng例程将索引色图像扩展为8位或16位RGBA？

解决方案 #

问题核心是png_set_add_alpha的参数错误，以及缓冲区分配逻辑不够严谨，具体修改如下：

1. 修正alpha值参数
   你传入的1 << 16是16位图像的最大alpha值，但当前输入是8位深度，应该传入8位的不透明alpha值0xFF（255）。libpng会根据图像位深度自动适配参数，错误的位深度值会导致alpha通道被置为0（全透明）。

2. 优化缓冲区分配逻辑
   不要手动计算width*4作为行缓冲区大小，改用png_get_rowbytes(png, info)获取实际每行字节数，避免因颜色类型、位深度变化导致的缓冲区不匹配。

3. 可选：验证转换后的图像参数
   调用png_read_update_info后，可以新增代码确认转换后的位深度和颜色类型，确保转换符合预期。

修改后的关键代码片段：

png_set_expand(png); // 将索引色转换为RGB
#if 1
if (png_get_valid(png, info, PNG_INFO_tRNS))
    png_set_tRNS_to_alpha(png);
else {
    std::cout << "No tRNS chunk, adding alpha channel\n";
    // 传入8位不透明alpha值
    png_set_add_alpha(png, 0xFF, PNG_FILLER_AFTER);
}
#endif

png_read_update_info(png, info);

// 可选：验证转换后的参数
int new_depth, new_color;
png_get_IHDR(png, info, nullptr, nullptr, &new_depth, &new_color, nullptr, nullptr, nullptr);
std::cout << "After conversion: depth=" << new_depth << ", color_type=" << new_color << std::endl;

// 动态获取行字节数分配缓冲区
png_bytepp rows = new png_bytep[height];
png_uint_32 row_bytes = png_get_rowbytes(png, info);
for (int i = 0; i < height; i++)
    rows[i] = new png_byte[row_bytes];

4. 16位RGBA转换拓展
   如果后续需要支持16位转换，只需在读取阶段添加png_set_expand_16(png)，同时将png_set_add_alpha的alpha值改为0xFFFF即可。

修改后程序即可正确将索引色图像转换为8位不透明RGBA图像，不会出现全透明或数据错位问题。

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