1. 概要

Manim 是一个基于Python的动画库,主要用于创建数学和科学中难以用普通视频制作工具制作的图形和动画。

它提供了各种基础的动画对象,比如,点,线,面,三角形,矩形,立方体等等,
基于它们,可以组合定制出自己需要表达的动画效果。

本篇介绍如何基于Manim封装一个圆规动画。

2. 动画原理

对于单个的元素,manim本身就提供了非常多的动画函数。
比如:创建/消除的动画,移动元素的动画,旋转元素的动画等等,具体可以参考: Animations

但是,对于多个元素联动的动画,则需要编写各个元素之间的联动规则,来封装符合要求的动画。
圆规动画就是多个元素联动的动画,下面演示其如何封装。

圆规动画目的是画一个 圆弧,只是在绘制的圆弧的过程中还需要展示了圆弧的起点,终点,
以及绘制过程中动态更新起点终点之间的线。

首先,定义绘制函数:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
def ruler(sc: Scene, p1, p2, color=GREEN, angle=PI, axis=OUT):
"""
圆规动画

Parameters
---------
sc
绘制动画的场景
p1
代表圆规的针,绘制时不动的点
p2
代表圆规的笔芯,绘制圆弧的点
color
圆弧的颜色,默认绿色
angle
绘制圆弧的角度,默认PI,相当于绘制半个圆
axis
只有2个值 IN/OUT,分别表示顺时针还是逆时针作弧
"""
... # 完整实现见下一段

下载 Python 脚本

各个参数的含义参见注释。

实现动画的思路如下:

  1. 构建3个元素,即:
    1. d1(根据参数中p1坐标绘制的点)
    2. d2(根据参数中p2坐标绘制的点)
    3. dl(连接p1和p2的虚线)
  2. 设置dl的动画,随着 d1和d2变化不断重新绘制(这里 d1其实是不会变的)
  3. 再设置圆弧的动画,随着 d2的变动,不断绘制新的圆弧(圆弧就是起点到d2的弧)
  4. 通过 manim自带的动画函数让 d2先动,其他动画随之运动
  5. 最后删除不必要的元素,只保留圆弧在场景(sc)中
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
def ruler(sc: Scene, p1, p2, color=GREEN, angle=PI, axis=OUT):
d1 = Dot(point=p1, color=RED)
d2 = Dot(point=p2, color=color)
dl = DashedLine(d1.get_center(), d2.get_center())

r = np.linalg.norm(p2 - p1)
arc = ArcBetweenPoints(p2, p2, stroke_width=2)

dl.add_updater(lambda z: z.become(DashedLine(d1.get_center(), d2.get_center())))
if np.array_equal(axis, OUT):
arc.add_updater(
lambda z: z.become(
ArcBetweenPoints(
p2, d2.get_center(), radius=r, stroke_color=color, stroke_width=2
)
)
)
if np.array_equal(axis, IN):
arc.add_updater(
lambda z: z.become(
ArcBetweenPoints(
d2.get_center(), p2, radius=r, stroke_color=color, stroke_width=2
)
)
)

sc.add(d1, d2, dl, arc)
sc.play(
Rotate(
d2,
about_point=d1.get_center(),
axis=axis,
angle=angle,
rate_func=linear,
)
)

arc.clear_updaters()
dl.clear_updaters()
sc.remove(d1, d2, dl)
return arc

下载 Python 脚本

add_updater 在本篇里的分工

add_updater 是 Mobject 的方法:给对象挂一个每帧调用的更新函数,函数的第一个参数就是对象自己。本篇的虚线 dl 和圆弧 arc 都靠它跟着 d2 变。它的签名、参数含义、每帧执行机制与常见坑,已在 多个动画怎么联动(add_updater 完整说明) 里完整写过;联动原理与尺规作图的关系另见 多个对象怎么联动(含圆规示例)。这里只讲本篇代码里的分工,不重复通用概念。

ruler() 里两处 add_updater 都从 d2.get_center() 取值,再重建自己:

  • dl.add_updater(...):每帧用 DashedLine(d1.get_center(), d2.get_center()) 重建虚线,让圆规两脚之间的连线随转动张开;
  • arc.add_updater(...):每帧用 ArcBetweenPoints(p2, d2.get_center(), radius=r, ...) 重建圆弧。起点 p2 固定、终点是当前笔尖,圆弧因此逐渐「长」出来;axis 取 OUT 或 IN 时起点终点对调,对应两种作弧方向。

两处都不逐项改属性,而是用 become(...) 整体重建:端点与圆弧的起止点每帧都在变,重建比逐项设置更直接。

播完后还有一步不能省:arc.clear_updaters() 与 dl.clear_updaters()。updater 注册后会持续生效,不摘除的话后续动画里 arc 仍会跟着 d2 变;摘除后圆弧被「定格」,配合 sc.remove(d1, d2, dl) 清掉辅助元素,场景里只留下画好的 arc。这也是 ruler() 能把 arc 作为返回值交给调用方继续使用的前提。

3. 动画效果

封装之后,看看使用的效果。
首先,试试按照逆时针(默认是逆时针)和顺时针方式绘制半圆。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# -*- coding: utf-8 -*-
import numpy as np
from manim import *
def ruler(sc: Scene, p1, p2, color=GREEN, angle=PI, axis=OUT):
"""圆规动画:p1 是针(不动),p2 是笔芯(绕 p1 转动画弧)"""
d1 = Dot(point=p1, color=RED)
d2 = Dot(point=p2, color=color)
dl = DashedLine(d1.get_center(), d2.get_center())
r = np.linalg.norm(p2 - p1)
arc = ArcBetweenPoints(p2, p2, stroke_width=2)
dl.add_updater(lambda z: z.become(DashedLine(d1.get_center(), d2.get_center())))
if np.array_equal(axis, OUT):
arc.add_updater(
lambda z: z.become(
ArcBetweenPoints(
p2, d2.get_center(), radius=r, stroke_color=color, stroke_width=2
)
)
)
if np.array_equal(axis, IN):
arc.add_updater(
lambda z: z.become(
ArcBetweenPoints(
d2.get_center(), p2, radius=r, stroke_color=color, stroke_width=2
)
)
)
sc.add(d1, d2, dl, arc)
sc.play(
Rotate(
d2, about_point=d1.get_center(), axis=axis, angle=angle, rate_func=linear
)
)
arc.clear_updaters()
dl.clear_updaters()
sc.remove(d1, d2, dl)
return arc
class Sample(Scene):
def construct(self):
ruler(self, np.array([-1, 0, 0]), np.array([-1, 1, 0]))
ruler(self, np.array([1, 0, 0]), np.array([1, 1, 0]), axis=IN)
self.wait()
# 纯静态画面也保证能出片:把已有元素再淡入一次
if self.mobjects:
self.play(FadeIn(Group(*self.mobjects)))
else:
self.wait(1)
self.wait(1.60)

下载 Python 脚本

然后,试试绘制2个圆弧的交叉点。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# -*- coding: utf-8 -*-
import numpy as np
from manim import *
def ruler(sc: Scene, p1, p2, color=GREEN, angle=PI, axis=OUT):
"""圆规动画:p1 是针(不动),p2 是笔芯(绕 p1 转动画弧)"""
d1 = Dot(point=p1, color=RED)
d2 = Dot(point=p2, color=color)
dl = DashedLine(d1.get_center(), d2.get_center())
r = np.linalg.norm(p2 - p1)
arc = ArcBetweenPoints(p2, p2, stroke_width=2)
dl.add_updater(lambda z: z.become(DashedLine(d1.get_center(), d2.get_center())))
if np.array_equal(axis, OUT):
arc.add_updater(
lambda z: z.become(
ArcBetweenPoints(
p2, d2.get_center(), radius=r, stroke_color=color, stroke_width=2
)
)
)
if np.array_equal(axis, IN):
arc.add_updater(
lambda z: z.become(
ArcBetweenPoints(
d2.get_center(), p2, radius=r, stroke_color=color, stroke_width=2
)
)
)
sc.add(d1, d2, dl, arc)
sc.play(
Rotate(
d2, about_point=d1.get_center(), axis=axis, angle=angle, rate_func=linear
)
)
arc.clear_updaters()
dl.clear_updaters()
sc.remove(d1, d2, dl)
return arc
class Sample(Scene):
def construct(self):
ruler(self, np.array([-1, -1, 0]), np.array([1.1, -0.2222, 0]), angle=PI / 3)
ruler(
self,
np.array([1, -1, 0]),
np.array([-1.1, -0.2222, 0]),
axis=IN,
angle=PI / 3,
)
self.wait()
# 纯静态画面也保证能出片:把已有元素再淡入一次
if self.mobjects:
self.play(FadeIn(Group(*self.mobjects)))
else:
self.wait(1)
self.wait(1.60)

下载 Python 脚本

4. 总结

联动动画的实现其实也不难,关键在于先确认起始的动画是哪个元素开始的,
比如,上文中起始动画是由d2发起的。

确定了起始动画,其他元素的联动都要基于起始动画的元素,
比如,上文中的dl和arc元素。
这样,联动的效果就形成了。

我在视频号中基于此做了一个高斯正17边形的尺规作图动画(weixin.qq.com/sph/AkfwsX)…%25E3%2580%2582 “https://weixin.qq.com/sph/AkfwsX)%E3%80%82“)

注: 此链接是视频号中视频的链接,只能在微信中打开。