变速¶

ChangeSpeed 能在一个动画播放期间多次改变它的播放速度——慢动作、急加速、中途暂停都可用一个 dict 描述。这是 rate_func 做不到的事：rate_func 是"一条进度映射曲线"，ChangeSpeed 是"分段速度倍率表"。

ChangeSpeed¶

ChangeSpeed(anim, speedinfo, rate_func=None, affects_speed_updaters=True, **kwargs) 官方文档 ↗

ChangeSpeed(
    anim: Animation | _AnimationBuilder,
    speedinfo: dict[float, float],
    rate_func: Callable[[float], float] | None = None,
    affects_speed_updaters: bool = True,
    **kwargs,
)

name	type	default	desc
`anim`	Animation \| .animate 构造器	—	被包裹的内层动画
`speedinfo`	dict[float, float]	—	键是内层动画进度的比例节点（0~1），值是该区间的速度倍率
`rate_func`	function \| None	None	覆盖内层动画的 rate_func，在变速之前应用
`affects_speed_updaters`	bool	True	是否同时影响通过 `ChangeSpeed.add_updater` 注册的 updater 的 dt

speedinfo 的关键规则：

键是内层动画 run_time 的百分比节点，不是秒。{0.5: 0.1, 0.7: 1} 表示"进度 50% 到 70% 之间以 0.1 倍速播放"。
缺 0 键时首段速度按 1 处理；缺 1 键时末段继承前一个倍率。
实际总时长会被自动拉长或压缩：慢放段越长，视频越长。

speedinfo={0: 1, 0.5: 1, 0.7: 0.15, 1: 0.15}：圆点先全速走一半，随后进入 0.15 倍慢动作直到结束——总时长由 1 秒自动拉长到约 2.8 秒。

查看源码 change_speed.py

"""ChangeSpeedDemo: speedinfo 在动画进度的关键节点上改变播放速度。"""

from manim import *


class ChangeSpeedDemo(Scene):
    def construct(self):
        dot = Dot(LEFT * 3)
        self.add(dot)

        # 键是内层动画进度（0~1 的比例），值是速度倍率；
        # 0.5~0.7 段以 0.15 倍慢速播放，实际时长会被拉长
        self.play(
            ChangeSpeed(
                dot.animate.shift(RIGHT * 6),
                speedinfo={0: 1, 0.5: 1, 0.7: 0.15, 1: 0.15},
                rate_func=linear,
            )
        )

ChangeSpeed 与 rate_func 的区别¶

维度	`rate_func`	`ChangeSpeed`
形式	一条 0→1 映射曲线	分段速度倍率表
能否中途变向	曲线可以任意弯折	只能分段变速，不能倒退
影响 updater 的 dt	否	是（`affects_speed_updaters=True` 时）
适用	单一致式节奏	先快后慢、慢动作回放等复合节奏

让 updater 跟着变速¶

普通 updater（mob.add_updater）默认不受 ChangeSpeed 影响——它们仍按真实帧时间推进。想让 updater 也"跟着慢放"，需要改用类方法 ChangeSpeed.add_updater(mob, func) 注册；该 updater 会遵循当前正在播放的 ChangeSpeed 的速度。

ChangeSpeed.add_updater(dot, lambda mob, dt: mob.shift(RIGHT * dt))
self.play(
    ChangeSpeed(Wait(2), speedinfo={0.5: 1, 0.7: 0.1, 1: 0.1}),
)

常见错误

affects_speed_updaters=True 时，同一时间只能有一个 ChangeSpeed 在播放（源码有断言），否则抛 AssertionError。另外 speedinfo 的键是比例而不是秒，把它当秒表读是新手最容易犯的错。

自测¶

下一步¶

变速控制的是"时间维度上的节奏"，下一节进入最后一个进阶主题：全量 rate functions 速查——每一条曲线的形状、适用场景与组合工具。