如何在ImageMagick 7/Magick++中读取索引/调色板图像像素

我尝试使用Magick++/ImageMagick 7读取索引/调色板/颜色映射的PNG图像，但找不到合适的实现示例。根据官方文档编写了代码读取像素/索引，想确认这段代码是否正确？另外，getConstMetacontent()曾存在近期修复的bug，我仍不确定当前实现是否正确；同时ImageMagick 6/Magick++中用于获取索引像素数据的getConstIndexes()函数在ImageMagick 7中已不存在。

编写的代码 #

imtest.cpp #

#include <iostream>

#include <Magick++.h>

int main(int argc, const char *argv[])
{
    std::cout << "Reading " << argv[1];
    Magick::Image img;
    try
    {
        img.read(argv[1]);
    }
    catch (const Magick::Exception &ex)
    {
        throw std::runtime_error("Failed to read image");
    }
    auto imgSize = img.size();
    std::cout << " -> " << imgSize.width() << "x" << imgSize.height() << ", ";
    if (img.classType() == Magick::ClassType::PseudoClass && img.type() == Magick::ImageType::PaletteType)
    {
        std::vector<uint8_t> data;
        std::cout << "paletted, " << img.colorMapSize() << " colors" << std::endl;
        // get palette indices as unsigned chars
        const auto nrOfColors = img.colorMapSize();
        // auto pixels = img.getConstPixels(0, 0, img.columns(), img.rows()); // needed to call this first for getConstMetacontent to work?
        auto indices = static_cast<const uint8_t *>(img.getConstMetacontent());
        const auto nrOfIndices = img.columns() * img.rows();
        for (std::remove_const<decltype(nrOfIndices)>::type i = 0; i < nrOfIndices; i++)
        {
            data.push_back(indices[i]);
        }
        std::cout << "Read " << data.size() << " pixels" << std::endl;
    }
    else
    {
        throw std::runtime_error("Unsupported image format");
    }
}

CMakeLists.txt #

cmake_minimum_required(VERSION 3.16)

find_package(PkgConfig REQUIRED)

pkg_check_modules(LIBMAGICK REQUIRED IMPORTED_TARGET
    Magick++
)

add_definitions(-DMAGICKCORE_HDRI_ENABLE=0)
add_definitions(-DMAGICKCORE_QUANTUM_DEPTH=16)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_C_STANDARD 11)

add_executable(imtest imtest.cpp)
target_include_directories(imtest PRIVATE ${ImageMagick_INCLUDE_DIRS})
target_link_libraries(imtest PkgConfig::LIBMAGICK)

运行命令：imtest <image>

你的代码不正确，核心问题是getConstMetacontent()并非用于获取调色板索引数据的API，它的设计用途是访问图像的元数据（如EXIF、ICC配置文件等），而非像素索引。以下是正确的实现方式和优化点：

1. 正确读取调色板索引的方法 #

在ImageMagick 7的Magick++中，要获取调色板索引，需要先通过getConstPixels()获取像素缓存，然后遍历每个像素并调用index()方法获取其对应的调色板索引值：

#include <iostream>
#include <vector>
#include <Magick++.h>

int main(int argc, const char *argv[])
{
    if (argc < 2) {
        std::cerr << "Usage: " << argv[0] << " <image_path>" << std::endl;
        return 1;
    }

    std::cout << "Reading " << argv[1];
    Magick::Image img;
    try
    {
        img.read(argv[1]);
    }
    catch (const Magick::Exception &ex)
    {
        std::cerr << "Failed to read image: " << ex.what() << std::endl;
        return 1;
    }

    auto imgSize = img.size();
    std::cout << " -> " << imgSize.width() << "x" << imgSize.height() << ", ";

    if (img.classType() != Magick::ClassType::PseudoClass || img.type() != Magick::ImageType::PaletteType)
    {
        std::cerr << "Unsupported image format: not a paletted image" << std::endl;
        return 1;
    }

    std::vector<uint8_t> indices;
    const size_t width = img.columns();
    const size_t height = img.rows();
    const size_t pixelCount = width * height;
    indices.reserve(pixelCount);

    std::cout << "paletted, " << img.colorMapSize() << " colors" << std::endl;

    // 获取只读像素缓存
    const Magick::PixelPacket* pixels = img.getConstPixels(0, 0, width, height);
    if (!pixels) {
        std::cerr << "Failed to get pixel data" << std::endl;
        return 1;
    }

    // 遍历像素获取索引
    for (size_t i = 0; i < pixelCount; ++i) {
        indices.push_back(static_cast<uint8_t>(pixels[i].index()));
    }

    std::cout << "Read " << indices.size() << " pixel indices" << std::endl;

    // 可选：获取调色板颜色信息
    std::vector<Magick::Color> palette;
    const size_t colorCount = img.colorMapSize();
    palette.reserve(colorCount);
    for (size_t i = 0; i < colorCount; ++i) {
        palette.push_back(img.colorMap(i));
    }
    std::cout << "Palette has " << palette.size() << " colors" << std::endl;

    return 0;
}

2. CMakeLists.txt的优化 #

原CMake中${ImageMagick_INCLUDE_DIRS}变量未定义，使用pkg_check_modules后，PkgConfig::LIBMAGICK目标已自动包含头文件和链接库依赖，无需手动指定target_include_directories：

cmake_minimum_required(VERSION 3.16)

find_package(PkgConfig REQUIRED)

pkg_check_modules(LIBMAGICK REQUIRED IMPORTED_TARGET
    Magick++
)

add_definitions(-DMAGICKCORE_HDRI_ENABLE=0)
add_definitions(-DMAGICKCORE_QUANTUM_DEPTH=16)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_C_STANDARD 11)

add_executable(imtest imtest.cpp)
target_link_libraries(imtest PkgConfig::LIBMAGICK)

3. 关键注意事项 #

• getConstMetacontent()的正确用途：该函数用于访问图像的元数据块（如XMP、IPTC等），绝对不能用来读取像素索引，属于API误用。
• 像素缓存的生命周期：调用getConstPixels()后，像素缓存的生命周期与Magick::Image对象绑定，不要在图像对象销毁后使用该指针。
• 索引值范围：调色板索引值范围是0到colorMapSize()-1，用uint8_t存储即可（PNG索引图的调色板颜色数通常不超过256）。
• 异常处理：保留并打印Magick++的异常信息，有助于调试图像读取或处理过程中的问题。

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