Go color.NRGBAModel 转换颜色时怎样避免 alpha 预乘

在 Go 的 image/color 包里，最容易混淆的是“结构体字段怎么存”和“Color.RGBA() 怎么返回”并不是一回事。color.NRGBA 的 R、G、B 字段是非 alpha 预乘值，而所有 Color 都通过 RGBA() 提供 alpha 预乘的 16 位通道。需要得到非预乘结果时，直接使用 color.NRGBAModel.Convert，不要把 RGBA() 的结果再乘一次 alpha。

正确做法是：把 RGBA() 当作统一的预乘读取接口，把 NRGBAModel.Convert 当作转成非预乘像素结构的边界；当 alpha 为零时让标准库返回全零的 color.NRGBA，不要自行除 alpha。

• 读取模型：RGBA() 返回范围为 0..0xffff 的预乘通道。
• 存储模型：NRGBA 的字段按普通的非预乘 8 位颜色保存。
• 转换入口：用 color.NRGBAModel.Convert(c) 获取目标模型，再断言为 color.NRGBA。
• 透明边界：alpha 为零时 RGB 没有可恢复的实际颜色，标准库会返回 {0, 0, 0, 0}。

先分清 RGBA 和 NRGBA 的通道含义

color.RGBA 表示 alpha 预乘颜色，满足每个颜色通道不大于 alpha；color.NRGBA 表示非 alpha 预乘颜色，字段里的 RGB 不会提前乘上 A。可是二者都实现了 color.Color，所以调用它们的 RGBA() 时，得到的都是统一的预乘 16 位结果。

这解释了一个常见误判：从 NRGBA{R: 200, A: 128} 调用 RGBA() 后，返回的红通道不会还是简单的 200 扩展值，而会先按 alpha 参与计算。若把这个返回值当成 NRGBA 字段直接保存，半透明像素就会变暗。

为什么要使用 NRGBAModel.Convert

color.NRGBAModel 是标准库提供的目标模型。它接收任意 color.Color，通过统一的 RGBA() 读取预乘值，再转换回非预乘的 color.NRGBA。对本来就是 color.NRGBA 的值，模型会直接返回原值；对完全不透明的颜色，可以直接缩窄通道；对半透明颜色，则会按 alpha 做反预乘。

package main

import (
	"fmt"
	"image/color"
)

func main() {
	// NRGBA 的 RGB 字段是非预乘值，A 表示透明度。
	source := color.NRGBA{R: 200, G: 80, B: 40, A: 128}

	// 让标准库完成预乘读取与反预乘转换，避免手写重复除法。
	converted := color.NRGBAModel.Convert(source)
	result, ok := converted.(color.NRGBA)
	if !ok {
		// 标准模型当前返回 NRGBA；断言失败时不要继续使用未知模型。
		panic("unexpected color model")
	}

	// 这里读取的是非预乘结构体字段，不要再次乘以 result.A。
	fmt.Printf("NRGBA=(%d,%d,%d,%d)\\n", result.R, result.G, result.B, result.A)
}

业务代码通常不需要复制标准库的反预乘公式。这样做的好处是，透明度为零的特殊分支、16 位中间值和转换时的截断规则都由同一个标准实现负责。

半透明像素和完全透明像素要分开处理

半透明颜色可以通过 alpha 近似恢复原始 RGB，但转换可能有损；官方实现也明确说明颜色模型转换可能有损。完全透明时，预乘后的 RGB 通常已经失去可见颜色信息，不能通过除以零恢复原值，因此 NRGBAModel 会直接返回 RGB 和 A 都为零的像素。

package main

import (
	"fmt"
	"image/color"
)

func readNRGBA(c color.Color) color.NRGBA {
	// Convert 统一处理 RGBA、NRGBA 以及其他 Color 实现。
	converted := color.NRGBAModel.Convert(c)
	result, ok := converted.(color.NRGBA)
	if !ok {
		// 这是调用边界保护，防止后续把未知类型当成 NRGBA 使用。
		return color.NRGBA{}
	}
	return result
}

func main() {
	// 完全透明时不要自己做 r*65535/a 之类的除法。
	transparent := readNRGBA(color.RGBA{R: 255, G: 20, B: 10, A: 0})
	semi := readNRGBA(color.RGBA{R: 100, G: 60, B: 20, A: 128})

	fmt.Printf("transparent=%+v semi=%+v\\n", transparent, semi)
}

如果业务需要保留完全透明像素原先的 RGB 作为元数据，就不能依赖 Color.RGBA() 之后再恢复；应在进入 Color 转换前另行保存这组元数据。

读取像素时不要把 RGBA 返回值当成 NRGBA 字段

从图片中取得 color.Color 后，最稳妥的做法是先按目标模型转换，再读取结构体字段。只有在确实需要参与混合或统一计算时，才直接使用 RGBA() 的预乘结果。以下函数把这两个用途分成两个清晰的入口。

package main

import "image/color"

func nonPremultipliedRGB(c color.Color) (r, g, b, a uint8) {
	// 目标是导出普通 RGBA 通道，因此先转换为 NRGBA。
	nrgba := color.NRGBAModel.Convert(c).(color.NRGBA)
	return nrgba.R, nrgba.G, nrgba.B, nrgba.A
}

func premultiplied16(c color.Color) (r, g, b, a uint32) {
	// 目标是参与统一的 Color 运算，保留 RGBA 的预乘 16 位语义。
	return c.RGBA()
}

这两个函数的结果不能互换：前者适合保存 PNG 像素字段、调色板数据或显示层参数；后者适合遵循 color.Color 约定的混合和距离计算。函数命名把语义写出来，比在调用点猜通道是否已经预乘更安全。

生产代码的几个检查点

我在处理半透明素材时最容易踩的坑不是公式写错，而是同一像素被不同层重复转换。可以把下面几项作为提交前的固定检查：

• 凡是保存普通 RGB 数值，确认读取的是 color.NRGBA 字段，而不是 RGBA() 的返回值。
• 凡是做颜色混合，确认参与运算的接口约定是预乘通道，避免把 NRGBA 字段直接当作预乘值。
• 不要先调用 NRGBAModel.Convert，之后又手动按 alpha 除一次；这会让结果偏亮或放大量化误差。
• 给 alpha 为零、alpha 为 128 和 alpha 为 255 的像素各准备一个用例，分别观察边界语义。
• 本文只讨论 RGBA/NRGBA 模型转换，不把通道预乘问题和颜色空间、伽马校准混为一谈。

一句话总结：RGBA() 是统一的预乘读取协议，NRGBAModel.Convert 是回到非预乘结构体的标准边界。把这两个角色分开，半透明图片的颜色就不会因为重复乘 alpha 而失真。

常见问题

NRGBAModel.Convert 会不会改变本来就是 NRGBA 的值？

标准库对已经是 color.NRGBA 的值会直接返回它，不需要重复转换；调用方仍应按目标类型读取结果。

为什么完全透明像素的 RGB 变成了 0？

因为预乘读取已经没有可逆的可见 RGB 信息，且 alpha 为零时不能做反预乘。标准库选择返回全零透明像素。

可以直接用 RGBA().0 作为普通红色值吗？

不建议。该返回值是 0 到 65535 范围的 alpha 预乘通道；要得到普通 8 位非预乘字段，应先转换为 color.NRGBA。

这个问题和颜色空间校准一样吗？

不一样。本文只讨论 Go 标准库的通道表示和模型转换；颜色空间、伽马和色彩配置属于另一层问题。