动画组合类的作用是将多个动画组合起来,以实现更复杂的动画效果。

Manim中有4个用于动画组合的类:

  1. AnimationGroup:将多个动画组合在一起同时播放,能一次性呈现多个对象的不同变化
  2. LaggedStart:按照添加顺序依次启动多个动画,每个动画间有延迟,使动画呈现出清晰的先后顺序
  3. LaggedStartMap:对一组对象应用相同动画,并按顺序逐个启动且有延迟,快速实现批量相似动画效果
  4. Succession:严格按照添加顺序依次播放多个动画,前一个完成后下一个才开始,确保动画按特定流程进行

1. 动画概述

1.1. AnimationGroup

当需要同时播放多个动画时,AnimationGroup非常有用。

例如,在一个场景中,需要同时移动多个图形、改变它们的颜色或执行其他操作。

AnimationGroup中包含的所有动画会同时开始和结束,可以通过设置lag_ratio参数来调整动画之间的延迟比例。

它的参数主要有:

参数名称 类型 说明
animations [Animation] 要播放的动画对象序列
group Group 包含多个Mobject的组
run_time float 动画持续时间
rate_func func 基于相对运行时间定义动画进度的函数
lag_ratio float 定义动画应用于子对象的延迟

参数lag_ratio默认为0,表示所有动画同时播放。

若lag_ratio=0.5,表示下一个动画将在前一个动画播放到 50% 时开始。

1.2. LaggedStart

当需要按顺序播放多个动画,但希望它们之间有一定的延迟时,LaggedStart是一个很好的选择。

例如,依次显示一系列的文本内容或逐个移动多个对象。

LaggedStart用于创建具有节奏感的动画序列,使观众能够清晰地看到每个动画的发生过程。

动画会按照它们被添加的顺序依次启动,每个动画之间有一定的延迟。

它的参数主要有:

参数名称 类型 说明
animations [Animation] 要播放的动画对象序列
lag_ratio float 定义动画应用于子对象的延迟
run_time float 动画的持续时间

1.3. LaggedStartMap

当需要对一组对象应用相同的动画,但希望它们之间有一定的延迟时,LaggedStartMap非常实用。

例如,逐个显示一组文本对象或逐个移动一组图形。

LaggedStartMap适用于处理大量相似对象的动画,通过简洁的方式实现逐个动画的延迟效果。

它的参数主要有:

参数名称 类型 说明
AnimationClass func 要应用于mobject的动画类
mobject Mobject 动画要应用到的Mobject
arg_creator func 要应用于Mobject的函数
run_time float 动画的持续时间
lag_ratio float 定义动画应用于子对象的延迟

1.4. Succession

当需要按顺序依次播放多个动画,且每个动画必须在前一个动画完成后才能开始时,Succession是首选。

例如,先移动一个对象,然后再对其进行旋转或缩放等操作。

Succession用于创建复杂的动画流程,确保动画按照特定的顺序执行,动画会按照它们被添加的顺序依次播放,前一个动画完成后,下一个动画才会开始。

它的参数主要有:

参数名称 类型 说明
animations [Animation] 要播放的动画对象序列
lag_ratio float 定义动画应用于子对象的延迟
run_time float 动画的持续时间

2. 使用示例

下面通过一些示例演示这4个动画组合类的使用。

2.1. 同时移动和变色多个图形

此示例中,展示了AnimationGroup并行处理多个动画的能力。

示例中同时启动圆形的移动动画和正方形的变色动画,让多个对象的不同动画效果同时呈现,且所有动画在同一时刻开始和结束。

1
2
3
4
5
6
7
8
9
10
11
12
13
from manim import *
class GroupDemo(Scene):
def construct(self):
title = Text("AnimationGroup:多个动画同时播放", font="STLiti", font_size=30).to_edge(UP)
self.play(FadeIn(title), run_time=0.6)
c = Circle(radius=1.0, color=BLUE, stroke_width=8).shift(LEFT * 3)
s = Square(side_length=1.8, color=WHITE, stroke_width=8).shift(RIGHT * 3)
self.play(FadeIn(c), FadeIn(s), run_time=0.8)
self.play(AnimationGroup(c.animate(run_time=2.2).shift(RIGHT * 2).set_color(YELLOW),
s.animate(run_time=2.2).set_color(RED)), run_time=2.2)
note = Text("组内的两个变换同一时刻开始、同一时刻结束", font="STLiti", font_size=21, color=YELLOW).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.4)
self.wait(2.4)

下载 Python 脚本

2.2. 逐个显示文本内容

在这个示例中,LaggedStart的特点是按照添加动画的顺序依次启动,每个动画之间根据lag_ratio(这里设置为 0.3)产生延迟。

动画中可以清晰地看到每个文本依次淡入,营造出一种有序的节奏感,适合用于展示一系列相关元素的逐个出现效果。

1
2
3
4
5
6
7
8
9
10
11
12
from manim import *
class LaggedTextDemo(Scene):
def construct(self):
title = Text("LaggedStart:逐行错开显示文本", font="STLiti", font_size=30).to_edge(UP)
self.play(FadeIn(title), run_time=0.6)
lines = VGroup(*[Text(t, font="STLiti", font_size=30, color=WHITE) for t in
["死去元知万事空", "但悲不见九州同", "王师北定中原日", "家祭无忘告乃翁"]])
lines.arrange(DOWN, buff=0.38)
self.play(LaggedStart(*[FadeIn(x, shift=RIGHT * 0.4) for x in lines], lag_ratio=0.25), run_time=3.0)
note = Text("lag_ratio 控制相邻动画的错开比例", font="STLiti", font_size=21, color=YELLOW).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.4)
self.wait(1.6)

下载 Python 脚本

2.3. 逐个移动一组点并变色

此例中,用LaggedStart把一组.animate包起来,通过lag_ratio(设置为 0.2)实现逐个对象动画的延迟效果。注意 Manim CE 0.21.0 里LaggedStartMap的首参是动画类而不是函数,旧教程的LaggedStartMap(函数, 对象组)写法已不适用;逐个错开用LaggedStart更直接。

这使得一组点能够逐个向下移动并变色,展示了批量处理相似对象动画且控制延迟的能力,适用于处理多个相同类型元素的动画序列。

1
2
3
4
5
6
7
8
9
10
11
12
13
from manim import *
class LaggedDotsDemo(Scene):
def construct(self):
title = Text("逐点错开:移动并同时变色", font="STLiti", font_size=30).to_edge(UP)
self.play(FadeIn(title), run_time=0.6)
dots = VGroup(*[Dot(radius=0.18, color=BLUE) for _ in range(5)])
dots.arrange(RIGHT, buff=0.9).shift(UP * 0.6)
self.play(FadeIn(dots), run_time=0.8)
self.play(LaggedStart(*[d.animate(run_time=1.0).shift(DOWN * 1.8).set_color(YELLOW) for d in dots],
lag_ratio=0.2), run_time=2.8)
note = Text("0.21 用 LaggedStart 包一组 animate,不必依赖 LaggedStartMap", font="STLiti", font_size=20, color=YELLOW).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.4)
self.wait(1.2)

下载 Python 脚本

2.4. 先旋转后移动图形

在该示例中,Succession严格按照顺序依次执行动画。

先旋转五角星图形,然后向上下左右四个方向分别射出不同颜色的点。

1
2
3
4
5
6
7
8
9
10
11
12
from manim import *
class SuccessionDemo(Scene):
def construct(self):
title = Text("Succession:先旋转、后移动", font="STLiti", font_size=30).to_edge(UP)
self.play(FadeIn(title), run_time=0.6)
star = Star(color=YELLOW, stroke_width=7).scale(1.1).shift(LEFT * 3)
self.play(FadeIn(star), run_time=0.6)
self.play(Succession(Rotate(star, angle=PI, run_time=1.6),
star.animate(run_time=1.6).shift(RIGHT * 5)), run_time=3.2)
note = Text("Succession 按顺序串行播放,总时长是各段之和", font="STLiti", font_size=21, color=YELLOW).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.4)
self.wait(1.2)

下载 Python 脚本

3. 附件