Go image/color.NRGBA64.RGBA 怎样获取 16 位颜色通道

如果你从 image/color 里拿到的是 color.NRGBA64，需要先分清两个概念：结构体里的 R/G/B/A 是非预乘的 16 位原始通道；调用 RGBA() 后得到的却是已经按 alpha 预乘的四个 uint32。标题里的“获取 16 位颜色通道”，如果指原始像素，就直接读字段；如果要遵循 color.Color 接口，就接受预乘结果。

最容易出错的地方不是类型转换，而是把 RGBA() 的返回值误当成 NRGBA64 的原始 RGB。该方法会计算 channel × A ÷ 0xffff，所以半透明和全透明颜色的 RGB 可能明显变小，甚至归零。

先分清字段和 RGBA() 的两条读取路径

NRGBA64 表示每个通道 16 位、且 RGB 没有预先乘以 alpha 的颜色。它的四个字段可以直接用于需要原始采样值的场景：

• R/G/B/A 的类型都是 uint16，取值范围是 0 到 0xffff。
• 字段中的 RGB 是非预乘值。例如 R=0xffff、A=0x8000 仍表示“红色满值、半透明”。
• 通过 color.Color 接口调用 RGBA() 时，接口约定返回 alpha 预乘值，四个结果用 uint32 承载。

因此读取方式要跟任务匹配：需要原始颜色就保留具体类型；需要和任意 color.Color 统一混合、比较或转换，就调用 RGBA()。

用半透明颜色看清 RGBA() 的换算

NRGBA64.RGBA() 的核心逻辑可以压缩成下面三行。alpha 本身原样返回，只有 RGB 会乘以 alpha：

package main

import (
    "fmt"
    "image/color"
)

func main() {
    // 原始 RGB 是非预乘值，A=0x8000 表示大约半透明。
    raw := color.NRGBA64{R: 0xffff, G: 0x8000, B: 0x4000, A: 0x8000}

    // 接口返回的是 alpha 预乘后的 16 位范围值，类型统一为 uint32。
    r, g, b, a := raw.RGBA()
    fmt.Printf("RGBA: r=%#x g=%#x b=%#x a=%#x\n", r, g, b, a)

    // 只有拿到具体 NRGBA64 时，才能直接访问未预乘的原始字段。
    fmt.Printf("raw:  r=%#x g=%#x b=%#x a=%#x\n", raw.R, raw.G, raw.B, raw.A)
}

按公式计算，这个示例的接口结果约为 r=0x8000、g=0x4000、b=0x2000、a=0x8000，而 raw.R 仍是 0xffff。这里的 uint32 不是说每个颜色通道变成了 32 位颜色，而是接口为了后续混合运算保留了足够的乘法空间。

半透明和全透明时为什么读到不同结果

这类差异在调试透明 PNG、颜色采样或像素比较时最明显。原始字段和接口结果分别回答了两个问题：

全透明时“原始 RGB 仍有数据”并不矛盾。NRGBA64 保存的是非预乘表示，透明度和颜色字段可以分别存在；而 RGBA() 要给出预乘表示，所以 RGB 被 alpha 乘成了零。

根据调用场景选择正确的读取方式

需要原始 16 位通道时

让变量保留为 color.NRGBA64，直接读取 R、G、B、A。这种方式适合保存原始采样、执行自己的颜色校正，或需要区分“透明但仍有 RGB 数据”的像素处理。

func rawChannels(c color.NRGBA64) (uint16, uint16, uint16, uint16) {
    // 直接返回非预乘原始字段，不经过 alpha 换算。
    return c.R, c.G, c.B, c.A
}

需要兼容任意 color.Color 时

使用接口的 RGBA()。这样不必关心传入的是 NRGBA64、RGBA64、灰度色还是调色板颜色，但拿到的统一是预乘通道：

func premultiplied(c color.Color) (uint32, uint32, uint32, uint32) {
    // 接口统一返回 0..0xffff 的预乘 r、g、b、a。
    return c.RGBA()
}

如果参数类型已经是 color.Color，不能直接写 c.R。确实需要恢复具体字段时，只能做类型断言，并为断言失败准备通用路径：

func readColor(c color.Color) (r, g, b, a uint32) {
    // 断言成功才表示可以读取 NRGBA64 的非预乘字段。
    if raw, ok := c.(color.NRGBA64); ok {
        return uint32(raw.R), uint32(raw.G), uint32(raw.B), uint32(raw.A)
    }
    // 其他 Color 类型回到接口契约，使用预乘结果。
    return c.RGBA()
}

排查三种常见误判

1. 把返回的 uint32 当成 32 位通道。接口结果的有效范围仍是 0..0xffff，高 16 位不是额外颜色精度。
2. 看到半透明 RGB 变小就认为像素损坏。这是预乘表示的正常结果；需要判断原始颜色时读取具体 NRGBA64 字段。
3. 用接口值直接访问 R/G/B 字段。color.Color 只有 RGBA() 方法，只有具体的 color.NRGBA64 才有公开字段。

可以把这件事记成一句话：NRGBA64 字段回答“像素原来存了什么”，RGBA() 回答“按照 color.Color 约定参与混合的值是什么”。只要先确认这两个语义，16 位颜色通道的读取就不会再被 alpha 预乘带偏。

相关问题

• 为什么 NRGBA64 的 RGBA 返回值要用 uint32？为了让后续按 alpha 混合时的乘法不在 uint16 范围内溢出。
• 想把 16 位通道降成 8 位怎么办？应明确这是精度缩减，再按项目的舍入策略从 0..0xffff 映射到 0..0xff，不要把预乘和降位混为一个步骤。
• 全透明像素需要清理原始 RGB 吗？取决于是否要做像素去重、压缩或隐私清理；显示合成只看预乘结果时它们不会产生可见 RGB。