使用Pillow writer时FuncAnimation的repeat参数不生效问题

问题根源 #

1. repeat=False仅作用于交互式显示：FuncAnimation的repeat参数只控制plt.show()里的动画播放逻辑，保存GIF时，Pillow writer默认会设置无限循环，不受该参数影响。
2. repeat_delay不支持Pillow writer：该参数仅对交互式窗口的动画生效，保存为GIF时无法直接通过它实现最后一帧延迟效果。

解决步骤 #

1. 强制GIF只播放一次

保存GIF时，需显式给Pillow writer设置loop参数（0为无限循环，1为仅播放一次）：

from matplotlib.animation import PillowWriter

# 根据interval计算帧率：interval=600ms，fps=1000/600≈1.67
writer = PillowWriter(fps=1000/600, loop=1)
anim.save('test.gif', writer=writer)

2. 实现最后一帧延迟效果

若要模拟repeat_delay的最后停留效果，可以在动画的frames列表中添加重复的最后一帧，让最后一帧持续显示：

# 原4帧，添加8个重复的最后一帧，对应约5秒延迟（600ms*8≈4800ms）
frames = list(range(4)) + [3]*8

3. 优化动画更新逻辑（可选）

你当前每次删除再重建scatter的方式效率较低，建议直接更新已有scatter对象的属性：

# 初始化时创建scatter对象并保存引用
point_anim1 = ax.scatter([10], [10], s=circle_size, c='red')
point_anim2 = ax.scatter([-10], [-4], s=circle_size, c='blue')

def animate(i):
    if i % 2:
        # 更新散点大小
        point_anim1.set_sizes([circle_size * i])
        point_anim2.set_sizes([circle_size * i])
        arrow.set_visible(False)
    else:
        point_anim1.set_sizes([circle_size])
        point_anim2.set_sizes([circle_size])
        arrow.set_visible(True)
    return arrow, point_anim1, point_anim2

修改后的完整代码 #

import numpy as np
from matplotlib import pyplot as plt
from matplotlib.animation import FuncAnimation, PillowWriter
import matplotlib.patches as patches

fig, ax = plt.subplots()
ax.set_ylim(-20, 20)
ax.set_xlim(-20, 20)

circle_size = 400

# 初始化scatter，用列表传入坐标避免后续更新报错
point_anim1 = ax.scatter([10], [10], s=circle_size, c='red')
point_anim2 = ax.scatter([-10], [-4], s=circle_size, c='blue')

arrow = patches.Arrow(2, 2, 2, 2)
ax.add_patch(arrow)

# 原4帧+8个重复最后一帧实现延迟
frames = list(range(4)) + [3]*8

def init():
    arrow.set_visible(True)
    point_anim1.set_sizes([circle_size])
    point_anim2.set_sizes([circle_size])
    return arrow, point_anim1, point_anim2

def animate(i):
    if i % 2:
        point_anim1.set_sizes([circle_size * i])
        point_anim2.set_sizes([circle_size * i])
        arrow.set_visible(False)
    else:
        point_anim1.set_sizes([circle_size])
        point_anim2.set_sizes([circle_size])
        arrow.set_visible(True)
    return arrow, point_anim1, point_anim2

# 交互式显示用repeat=False，保存时靠writer控制循环
anim = FuncAnimation(fig, animate, init_func=init, frames=frames, interval=600, repeat=False)
plt.show()
plt.close()

# 设置writer为仅播放一次
writer = PillowWriter(fps=1000/600, loop=1)
anim.save('test.gif', writer=writer)

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