Go image/gif.Disposal 怎么控制动画帧清屏方式

做 GIF 动画时，如果后一帧总像是“叠”在前一帧上，问题通常不在 Delay，而在 GIF.Disposal 没有按帧表达清屏方式。Go 的 image/gif 把它定义为与 Image 对齐的字节切片：DisposalNone 保留当前画面，DisposalBackground 清到逻辑屏幕背景，DisposalPrevious 恢复到绘制当前帧之前的状态。

官方地址：https://pkg.go.dev/image/gif#GIF

先按“当前帧显示完以后要留下什么”来选 Disposal，再检查 Image、Delay、Disposal 是否一一对应。想清成背景时，还要给 BackgroundIndex 配好全局调色板索引。

• 不清除：DisposalNone，下一帧继续看到当前帧留下的像素。
• 清背景：DisposalBackground，适合帧只覆盖局部区域、下一帧需要干净背景的场景。
• 回退：DisposalPrevious，适合临时叠加后回到上一状态的效果。

先把三种 Disposal 的作用分开

Disposal 描述的是“这一帧显示结束后，播放面如何准备给下一帧使用”，不是当前帧的延迟时间，也不是透明色设置。比如一个小圆点在画布上移动，使用 DisposalNone 会留下运动轨迹；使用 DisposalBackground，圆点所在区域会按背景索引清掉；使用 DisposalPrevious，则尝试回到绘制该帧之前的画面。

因此选项可以按动画目的判断：需要累积笔画时保留画面，需要局部擦除时清背景，需要临时叠加标记时回退上一状态。它们都是 GIF 帧的静态元数据，不会替你重新计算每一帧的像素。

GIF.Disposal 如何与帧数组对应

在 gif.GIF 中，Image[i]、Delay[i] 和 Disposal[i] 表示同一个帧的图像、停留时间和帧后处理方式。三组数据不能按“所有图片一组、所有清屏策略另一组”的思路理解，而要始终用同一个下标配对。

g := &gif.GIF{
    Image:    []*image.Paletted{frame1, frame2},
    Delay:    []int{8, 8},
    Disposal: []byte{gif.DisposalBackground, gif.DisposalNone},
}

// 第 0 帧显示后清到背景，第 1 帧显示后保留画面。
if len(g.Image) != len(g.Delay) || len(g.Image) != len(g.Disposal) {
    return errors.New("帧数据长度未对齐")
}

上面的长度判断是组织数据时的保护线。Go 的 EncodeAll 会拒绝图片与延迟长度不一致；当 Disposal 非空时，它也要求与图片数量匹配。若不需要为每帧指定策略，可以保留空的 Disposal，但要明确这会回到兼容性默认行为，而不是自动推断动画意图。

用 EncodeAll 控制清屏策略

写出 GIF 时，清背景策略还涉及逻辑屏幕的全局调色板。BackgroundIndex 是背景颜色在全局调色板中的索引，主要供 DisposalBackground 使用；它不是 RGB 值，也不是透明度。没有全局调色板时，不能把它当作普通颜色编号随意填写。

out, err := os.Create("motion.gif")
if err != nil {
    return err
}
defer out.Close() // 关闭文件，确保写出端的错误能被上层处理

g := &gif.GIF{
    Image:    []*image.Paletted{frame1, frame2, frame3},
    Delay:    []int{6, 6, 10},
    Disposal: []byte{gif.DisposalBackground, gif.DisposalBackground, gif.DisposalPrevious},
    LoopCount: 0, // 0 表示循环播放
    Config: image.Config{
        ColorModel: palette.Plan9, // 提供全局调色板，供背景索引使用
        Width:      320,
        Height:     180,
    },
    BackgroundIndex: 0, // 选择全局调色板中的背景项
}
if err := gif.EncodeAll(out, g); err != nil {
    return err // 编码失败时不要继续报告成功
}

这个组合表达了一个局部动画：前两帧显示完后清到背景，第三帧结束后回到进入它之前的状态。真实项目中，frame1 等帧仍需提前准备为符合逻辑屏幕边界的 *image.Paletted；Disposal 不负责把普通 RGBA 图像转换成 GIF 调色板。

透明帧、背景色和内存边界

最容易混淆的地方是“清背景”和“透明”。DisposalBackground 讨论的是 GIF 播放器对帧区域的清理方式，透明像素如何编码则属于调色板与图像数据本身。两者可以一起出现，但不能只改 Disposal 就期待透明边缘自动正确。

另外，本文只讨论编码侧帧间关系。如果输入 GIF 来自不可信来源，官方文档建议先用 DecodeConfig 检查尺寸，再决定是否调用 Decode 或 DecodeAll；DecodeAll 会把每一帧都保留在内存中。这个安全边界与 Disposal 的选值是两件事，排查时不要混在一起。

常见问答

Disposal 可以只写一部分吗？

不建议。只要切片非空，就按帧数量完整提供；否则编码时会因为长度不匹配失败。若不指定任何帧策略，使用空切片比写一个短切片更清楚。

改 Delay 能解决残影吗？

通常不能。Delay 只决定帧停留多久，残影来自前后帧像素与清屏策略的组合，应先检查 Disposal 和帧内容。

BackgroundIndex 是透明索引吗？

不是。它是全局调色板中的背景颜色索引，服务于背景清除；透明色要结合 GIF 调色板和帧数据单独处理。

小结：先用帧后处理目标选择 Disposal，再让 Image、Delay、Disposal 按下标对齐，最后确认全局调色板与 BackgroundIndex。这样定位 GIF 残影时，才能把清屏策略、帧内容和解码内存问题分别处理。