使用Magick.Net将PDF转PNG输出全黑的问题排查求助

问题描述 #

我创建了一个基于.NET Core 3.1的控制台应用，使用Magick.Net将PDF转换为PNG，已安装GhostScript公共许可证。转换过程正常，但输出的PNG图片全黑无法读取，仅在画图工具中打开显示正常。以下是我的代码：

public static int ConvertFileToImages(string filePath, string destinationPath) {
    int noofPages = 0;
    MagickReadSettings magickReadSettings = new MagickReadSettings();
    magickReadSettings.Density = new Density(300, 300);
    using (MagickImageCollection magickImageCollection = new MagickImageCollection()) {
        magickImageCollection.Read(filePath, magickReadSettings);
        int page = 1;
        noofPages = magickImageCollection.Count;
        foreach (MagickImage magickImage in magickImageCollection) {
            magickImage.Format = MagickFormat.Png;
            magickImage.BackgroundColor = MagickColors.White;
            string imageFilePath = string.Concat(destinationPath, "file-", page, ".png");
            magickImage.Write(imageFilePath);
            page++;
        }
    }
    return noofPages;
}

请问我哪里操作有误？

解决方案 #

这种情况我熟，大概率是PDF透明背景的处理问题！PDF页面默认是透明背景，Magick.NET会保留这个透明通道，但很多图片查看器（比如系统默认的图片查看器）不会正确渲染透明区域，直接显示成黑色；而画图工具会自动用白色填充透明背景，所以能正常显示。

你现在的代码里虽然设置了BackgroundColor = MagickColors.White，但这个设置并没有真正作用到透明区域上，只是设置了背景色参数，没有执行填充操作。需要做以下修改：

方法一：读取PDF时就指定背景色（推荐）

直接在MagickReadSettings里设置背景色，这样读取PDF页面时就会自动用白色填充透明区域：

public static int ConvertFileToImages(string filePath, string destinationPath) {
    int noofPages = 0;
    MagickReadSettings magickReadSettings = new MagickReadSettings();
    magickReadSettings.Density = new Density(300, 300);
    // 关键：读取PDF时就设置白色背景，直接填充透明区域
    magickReadSettings.BackgroundColor = MagickColors.White;
    using (MagickImageCollection magickImageCollection = new MagickImageCollection()) {
        magickImageCollection.Read(filePath, magickReadSettings);
        int page = 1;
        noofPages = magickImageCollection.Count;
        foreach (MagickImage magickImage in magickImageCollection) {
            magickImage.Format = MagickFormat.Png;
            string imageFilePath = string.Concat(destinationPath, "file-", page, ".png");
            magickImage.Write(imageFilePath);
            page++;
        }
    }
    return noofPages;
}

方法二：遍历图片时手动将透明区域转为白色

如果方法一不生效，可以在遍历每个页面时，强制把所有透明像素替换成白色：

public static int ConvertFileToImages(string filePath, string destinationPath) {
    int noofPages = 0;
    MagickReadSettings magickReadSettings = new MagickReadSettings();
    magickReadSettings.Density = new Density(300, 300);
    using (MagickImageCollection magickImageCollection = new MagickImageCollection()) {
        magickImageCollection.Read(filePath, magickReadSettings);
        int page = 1;
        noofPages = magickImageCollection.Count;
        foreach (MagickImage magickImage in magickImageCollection) {
            magickImage.Format = MagickFormat.Png;
            // 关键：将所有透明像素替换为白色
            magickImage.Opaque(MagickColors.Transparent, MagickColors.White);
            string imageFilePath = string.Concat(destinationPath, "file-", page, ".png");
            magickImage.Write(imageFilePath);
            page++;
        }
    }
    return noofPages;
}

原理说明 #

PDF的页面本质是一个透明的画布，Magick.NET默认会保留这个透明度。当你设置BackgroundColor但没有触发填充时，透明通道依然存在，大部分图片查看器会把透明区域渲染为黑色；而画图工具会自动用白色填充透明背景，所以显示正常。通过上述两种方法，我们要么在读取时就用白色填充背景，要么手动替换透明像素，这样生成的PNG就没有透明通道，所有查看器都能正常显示白色背景的内容了。

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