VB.NET使用ImageSharp OctreeQuantizer处理透明背景PNG出现负片问题

问题原因 #

OctreeQuantizer默认针对RGB色彩空间设计，直接处理灰度带Alpha通道的图像时，会错误映射灰度值，导致出现负片/反转效果。同时，未明确指定图像的灰度像素类型，可能让ImageSharp在加载时自动转换为RGB格式，进一步加剧通道处理的混乱。

解决方案1：调整OctreeQuantizer的色彩空间配置 #

修改原代码，给量化器指定灰度色彩空间，确保处理逻辑匹配灰度图像：

Public Shared Function QuantizeImageGrayscalePNG(ByVal vstrSource As String, ByVal vintMaxColors As Integer) As Bitmap
    Dim poqQuant As New OctreeQuantizer()
    Dim pencPNG As New PngEncoder() With {.BitDepth = PngBitDepth.Bit8, .ColorType = PngColorType.GrayscaleWithAlpha}

    vintMaxColors = Math.Min(256, vintMaxColors)
    If vstrSource IsNot Nothing AndAlso IO.File.Exists(vstrSource) AndAlso vintMaxColors > 0 Then
        ' 加载时指定灰度带Alpha的像素类型，避免自动转RGB
        Using piNew As Image(Of GrayA8) = Image.Load(Of GrayA8)(vstrSource),
              pstOutput As New IO.MemoryStream()

            poqQuant.Options.MaxColors = vintMaxColors
            ' 指定量化器使用灰度色彩空间
            poqQuant.Options.ColorSpace = ColorSpace.Gray

            piNew.Mutate(Sub(x) x.Quantize(poqQuant))
            piNew.Save(pstOutput, pencPNG)

            Return Bitmap.FromStream(pstOutput)
        End Using
    Else
        Return Nothing
    End If
End Function

解决方案2：使用自定义灰度调色板的PaletteQuantizer #

如果方案1仍有问题，可以改用自定义灰度调色板的方式，完全控制量化过程的灰度映射：

Public Shared Function QuantizeImageGrayscalePNG(ByVal vstrSource As String, ByVal vintMaxColors As Integer) As Bitmap
    vintMaxColors = Math.Min(256, vintMaxColors)
    If vstrSource Is Nothing OrElse Not IO.File.Exists(vstrSource) OrElse vintMaxColors <= 0 Then
        Return Nothing
    End If

    ' 生成从黑到白的渐变灰度调色板，包含全透明色
    Dim grayPalette As New List(Of GrayA8)()
    Dim step = 255.0 / (vintMaxColors - 1)
    For i = 0 To vintMaxColors - 1
        Dim grayVal = CByte(Math.Round(i * step))
        grayPalette.Add(New GrayA8(grayVal, 255))
    Next
    grayPalette.Add(New GrayA8(0, 0)) ' 添加全透明色，确保背景透明性

    Dim quantizer = New PaletteQuantizer(grayPalette, QuantizerOptions.Default)
    Dim encoder As New PngEncoder() With {
        .BitDepth = PngBitDepth.Bit8,
        .ColorType = PngColorType.GrayscaleWithAlpha
    }

    ' 以灰度带Alpha格式加载图像
    Using piNew As Image(Of GrayA8) = Image.Load(Of GrayA8)(vstrSource),
          pstOutput As New IO.MemoryStream()

        piNew.Mutate(Sub(x) x.Quantize(quantizer))
        piNew.Save(pstOutput, encoder)

        Return Bitmap.FromStream(pstOutput)
    End Using
End Function

关键调整点 #

• 加载图像时明确指定GrayA8像素类型，避免ImageSharp自动转换为RGB格式。
• 针对灰度图像配置量化器的色彩空间或使用自定义灰度调色板，确保灰度值映射正确。
• 保留PNG编码器的GrayscaleWithAlpha配置，匹配源图像的透明通道需求。

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