直线是最常用的二维结构,也是构造其他二维图形的基础。
manim中针对线性结构提供了很多模块,本篇主要介绍常用的几个直线类的模块。

  1. Line:通用直线
  2. DashedLine:各种类型的虚线
  3. TangentLine:根据已有的几何体,绘制它的切线
  4. LabeledLine:带有标签的直线

其中,DashedLine,TangentLine和LabeledLine都继承自Line。
manim边学边做--直线类
直线系列的模块也位于manim中的Mobject之下。

1. 主要参数

模块Line的常用参数有:

参数名称 类型 说明
start Point3D 直线的起点
end Point3D 直线的终点
path_arc float 直线的弯曲程度

Line模块常用的就是start和end参数,path_arc参数是调节直线弯曲度的,用的不多。

模块DashedLine除了包含Line的参数之外,还有两个特有的参数:

参数名称 类型 说明
dash_length float 每小段虚线的长度
dashed_ratio float 虚线的疏密程度

模块TangentLine是专门用来绘制切线的,它的参数有:

参数名称 类型 说明
vmob VMobject 绘制切线的几何体,一般是圆形
alpha float 切线围绕在几何体上的方向,范围从0~1
d_alpha float 切线的偏移度,默认是很小的值
length float 切线长度

这里的alpha参数范围从0~1,代表了围绕vmob一周。

模块LabeledLine可以在直线上加一个便签,这在制作动画时非常有用,可以给线段添加说明信息。

参数名称 类型 说明
label str 标签中文字,可支持数学公式
label_position float 标签位置,默认在直线正中间
font_size float 标签字体大小
label_color Color 标签颜色
label_frame bool 是否显示标签背景
frame_fill_color Color 标签背景颜色
frame_fill_opacity float 标签背景透明度

2. 主要方法

模块Line的常用方法有:

名称 说明
get_angle 直线相对于水平方向的角度
get_projection 直线外一点在直线上的投影
get_slot 直线的斜率
get_unit_vector 直线对应的单位向量
get_vector 直线对应的向量
put_start_and_end_on 重新设置直线的起点和终点
set_angle 重新设置直线的角度
set_length 重新设置直线的长度
set_path_arc 重新设置直线的弯曲度
set_points_by_ends 重新设置直线的起点和终点,类似 put_start_and_end_on

通过Line提供的get_*和set_*方法,可以灵活的获取直线的信息,进行计算之后,再改变直线的状态。
这在制作数学动画时非常有用。

模块DashedLine的常用方法有:

名称 说明
get_start 虚线的起点
get_end 虚线的终点
get_first_handle 贝塞尔曲线的第一个控制点
get_last_handle 贝塞尔曲线的最后一个控制点

manim中,直线也可以有弯曲度,所以直线都是通过贝塞尔曲线的方式绘制的,
get_first_handle和get_last_handle是为了获取贝塞尔曲线的控制点。

模块TangentLine和LabeledLine没有自己特殊的方法,但是它们继承自Line的方法基本都可以使用。

3. 使用示例

下面通过示例来演示直线类模块的效果。

3.1. 直线样式

直线Line从形状上看比较简单,能够设置的属性也就是长度,弯曲度等等。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
from manim import *
import numpy as np
from numpy import array, pi, cos, sin
run_time = 1
data = [[1, 2], [3, 4]]
def dot(pos, **kwargs):
return Dot(pos, **kwargs)
class N038_01(Scene):
def construct(self):
sc = self
self.play(*[FadeIn(_o) for _o in [Line(LEFT * 2, RIGHT * 2)]], run_time=1.0)
self.play(*[FadeIn(_o) for _o in [Line(LEFT, RIGHT)]], run_time=1.0)
self.play(*[FadeIn(_o) for _o in [Line(LEFT * 1.5, ORIGIN, path_arc=0.5)]], run_time=1.0)
self.play(*[FadeIn(_o) for _o in [Line(ORIGIN, RIGHT * 1.5, path_arc=1.5)]], run_time=1.0)
self.wait(0.5)
self.wait(1.10)

下载 Python 脚本

3.2. 动态改变直线

通过直线的方法,可以动态的改变直线。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
from manim import *
import numpy as np
from numpy import array, pi, cos, sin
run_time = 1
data = [[1, 2], [3, 4]]
def dot(pos, **kwargs):
return Dot(pos, **kwargs)
class N038_02(Scene):
def construct(self):
sc = self
l = Line(LEFT * 2, RIGHT * 2)
self.play(FadeIn(l), run_time=1.0)
l.set_length(2)
l.set_angle(0.785)
l.set_path_arc(1)
self.wait(1)
self.wait(0.5)
self.wait(3.10)

下载 Python 脚本

3.3. 虚线样式

虚线DashedLine除了上面直线Line的属性之外,还可以设置自己特有的虚线样式。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
from manim import *
import numpy as np
from numpy import array, pi, cos, sin
run_time = 1
data = [[1, 2], [3, 4]]
def dot(pos, **kwargs):
return Dot(pos, **kwargs)
class N038_04(Scene):
def construct(self):
sc = self
c = Circle(radius=1).shift(DOWN)
self.play(*[FadeIn(_o) for _o in [TangentLine(c, alpha=0)]], run_time=1.0)
self.play(*[FadeIn(_o) for _o in [TangentLine(c, alpha=0.125)]], run_time=1.0)
self.play(*[FadeIn(_o) for _o in [TangentLine(c, alpha=0.375)]], run_time=1.0)
self.play(*[FadeIn(_o) for _o in [TangentLine(c, alpha=0.75)]], run_time=1.0)
self.wait(0.5)
self.wait(1.10)

3.4. 切线样式

切线TangentLine本身就是一个普通的直线Line。
它的主要作用是制作动画时不用自己去手工计算,就能方便的绘制一个图形的切线。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
from manim import *
# 切线样式:在圆的 0 / 1/8 / 3/8 / 3/4 四处各画一条切线
# 复现:manim -qh --disable_caching -a 20240822173706003.py
class TangentLineDemo(Scene):
def construct(self):
# 中文必须指定中文字体,否则 Text 会渲染成白色方块
title = Text("切线样式:", font="STLiti", font_size=36)
title.set_color_by_gradient(RED, YELLOW, GREEN)
title.to_edge(UP, buff=0.3)
rule = Line(LEFT * 6.5, RIGHT * 6.5, color=BLUE)
rule.next_to(title, DOWN, buff=0.25)
# 红色圆是切线的目标曲线,下移一点给标题留空间
circle = Circle(radius=1.6, color=RED).shift(DOWN * 0.4)
# alpha 是圆参数方程上的位置比例;length 决定切线向两端延伸多长
specs = [(0, GREEN), (0.125, YELLOW), (0.375, BLUE), (0.75, PURPLE)]
tangents = VGroup(*[
TangentLine(circle, alpha=a, length=5.5, color=c) for a, c in specs
])
self.play(Write(title), Create(rule), run_time=1)
self.play(Create(circle), run_time=1)
for line in tangents:
self.play(Create(line), run_time=0.8)
self.wait(1.6)

下载 Python 脚本

下载 Python 脚本

3.5. 直线上的标签

LabeledLine在需要给动画中的某些线加说明的时候非常有用。

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
from manim import *
# 直线上的标签:LabeledLine 把标签压在线中央,并自动加底框遮住线条
# 复现:manim -qh --disable_caching -a 20240822173706004.py
class LabeledLineDemo(Scene):
def construct(self):
title = Text("直线上的标签:", font="STLiti", font_size=36)
title.set_color_by_gradient(RED, YELLOW, GREEN)
title.to_edge(UP, buff=0.3)
rule = Line(LEFT * 6.5, RIGHT * 6.5, color=BLUE)
rule.next_to(title, DOWN, buff=0.25)
start, end = LEFT * 3, RIGHT * 3
# 字符串标签由 LaTeX 排版,适合写数学公式;字号要放 label_config
l_formula = LabeledLine(label=r"y=kx+b", start=start, end=end,
label_config={"font_size": 28})
# 中文不能交给 LaTeX,必须传 Text 对象并指定中文字体
l_chinese = LabeledLine(label=Text("中文说明", font="STLiti", font_size=28),
start=start, end=end)
l_root = LabeledLine(label=r"z=\sqrt{x^2+y^2}", start=start, end=end,
label_config={"font_size": 28})
# box_config 控制标签底框,这里换成绿色实心背景
l_box = LabeledLine(label=Text("标签背景", font="STLiti", font_size=28),
start=start, end=end,
box_config={"fill_color": GREEN, "fill_opacity": 1})
lines = VGroup(l_formula, l_chinese, l_root, l_box)
lines.arrange(DOWN, buff=0.8).shift(DOWN * 0.6)
self.play(Write(title), Create(rule), run_time=1)
for line in lines:
self.play(FadeIn(line, shift=UP * 0.15), run_time=1)
self.wait(1.5)

下载 Python 脚本

4. 附件

文中示例的完整脚本如下,与上方代码块、演示视频逐字一致;用 manim -qh 脚本.py 本地渲染即可复现。