弧形多边形是一种结合了圆弧和多边形的图形,这类几何图形在设计中应用非常广泛。

比如在家居设计中,看看家里的沙发,餐桌和座椅等,它们的边角,靠背等地方都是弧形的设计,这种设计有效柔化了室内空间,使整体氛围更加和谐自然。

还有景观和建筑设计中,弧形多边形常被用于道路规划、花坛布局等,

特别是儿童游乐的区域,通过自由的弧线设计,不仅符合儿童活泼好动的天性,还能激发他们的想象力和创造力。

在艺术设计领域,弧形多边形用的就更多了,在图形、标志、海报等的创作中,弧形多边形独特的形状和视觉效果能够吸引观众的注意力,传达出设计者的意图和情感。

manim中提供了2个模块来构造弧形多边形:

  1. ArcPolygon:通过顶点和弧度来构造弧形多边形
  2. ArcPolygonFromArcs:通过圆弧来构造弧形多边形

manim边学边做--弧形多边形

这两个模块的主要区别在于构造弧形多边形的过程不同,一个是通过顶点,一个是通过圆弧,

最终构造出的弧形多边形并没有什么不同。

1. 主要参数

ArcPolygon的主要参数有:

参数名称 类型 说明
vertices Point3D 多边形的顶点列表
angle float 统一设置所有弧的弧度
radius float 统一设置所有弧的半径
arc_config list[dict] 分别设置每个弧的弧度

顶点vertices确定之后,angle和radius设置每两个顶点之间弧的弯曲程度。

angle和radius参数只能使用一个,同时使用的话,angle参数无效。

angle和radius是统一设置多边形所有弧的弧度,arc_config可以设置每个弧拥有不同的弧度。

0.21 实测补充:arc_config 是 list[dict],元素个数必须等于顶点数(源码里有 assert len(arc_config) == n),少一个会直接 AssertionError。每个 dict 会原样传给 ArcBetweenPoints,所以除了 angle / radius,也能逐条写 color、stroke_width。顺序按顶点依次闭合:vertices[0]→vertices[1]、vertices[1]→vertices[2]……最后一条回到起点。

ArcPolygonFromArcs的参数比较简单。

参数名称 类型 说明
arcs Arc 弧形的集合

注意,如果参数传入的弧形列表arcs不能构成一个闭合的多边形,

那么,manim会自动把arcs中最后一个弧形的终点与第一个弧形的起点用直线连接起来,形成闭合的多边形。

这两个模块(ArcPolygon和ArcPolygonFromArcs)构造的弧形多边形没有区别,在制作动画时根据实际情况选用不同的模块。

如果有顶点信息,那么用ArcPolygon来构造多边形,如果有各个圆弧的信息,那么用ArcPolygonFromArcs来构造多边形。

2. 使用示例

2.1. 统一设置弧度

使用angle可以统一设置弧形多边形中每条边的弧度,弧度设置的越大,边的弯曲度越大。

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
from manim import *
class ArcPolygonAngle(Scene):
"""2.1 angle 统一设置每条边的弧度:值越大,边越向外鼓。
ArcPolygon(*vertices) 返回的是可上屏的 VMobject,必须 add / play 才会显示;
原文那样只调用不接住返回值,画面上什么也没有。
"""
def construct(self):
kw = dict(font="STLiti")
title = Text("2.1 统一设置弧度 angle", font_size=36, color=RED, **kw).to_edge(UP, buff=0.3)
rule = Line(LEFT * 6.6, RIGHT * 6.6, color=BLUE_B, stroke_width=3).next_to(title, DOWN, buff=0.18)
verts = [UR, UL, DL, DR]
specs = [(0, GREY_B, "angle = 0 度"), (60 * DEGREES, BLUE, "angle = 60 度"),
(120 * DEGREES, RED, "angle = 120 度")]
group = VGroup()
for ang, color, label in specs:
poly = ArcPolygon(*verts, angle=ang, color=color, stroke_width=5,
fill_color=color, fill_opacity=0.22).scale(0.85)
cap = Text(label, font_size=26, color=color, **kw)
group.add(VGroup(poly, cap).arrange(DOWN, buff=0.42))
group.arrange(RIGHT, buff=1.35).shift(DOWN * 0.45)
note = Text("angle 越大边越向外弯,angle = 0 时退化成直线多边形",
font_size=24, color=GREY_B, **kw).to_edge(DOWN, buff=0.35)
self.play(FadeIn(title), FadeIn(rule), run_time=0.7)
self.play(LaggedStart(*[FadeIn(g) for g in group], lag_ratio=0.3, run_time=1.5))
self.play(FadeIn(note), run_time=0.6)
self.wait(3.0)

下载 Python 脚本

2.2. 统一设置半径

使用radius也可以设置弧形多边形中每条边的弯曲度,radius是指构成弧形的两个顶点所在圆的半径。

所以radius越大,边的弯曲度越小。

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
from manim import *
class ArcPolygonRadius(Scene):
"""2.2 radius 统一设置每条边所在圆的半径:半径越大,边越平直。
注意 ArcPolygon 源码是 if radius: ... else: angle,同时给两个参数时 angle 会被忽略。
"""
def construct(self):
kw = dict(font="STLiti")
title = Text("2.2 统一设置半径 radius", font_size=36, color=RED, **kw).to_edge(UP, buff=0.3)
rule = Line(LEFT * 6.6, RIGHT * 6.6, color=BLUE_B, stroke_width=3).next_to(title, DOWN, buff=0.18)
verts = [UR, UL, DL, DR]
specs = [(10, BLUE, "radius = 10"), (2, GREEN, "radius = 2"),
(1, YELLOW, "radius = 1")]
group = VGroup()
for rad, color, label in specs:
poly = ArcPolygon(*verts, radius=rad, color=color, stroke_width=5,
fill_color=color, fill_opacity=0.22).scale(0.85)
cap = Text(label, font_size=26, color=color, **kw)
group.add(VGroup(poly, cap).arrange(DOWN, buff=0.42))
group.arrange(RIGHT, buff=1.35).shift(DOWN * 0.45)
note = Text("radius 越大边越平直;同时传 angle 与 radius 时 angle 无效",
font_size=24, color=GREY_B, **kw).to_edge(DOWN, buff=0.35)
self.play(FadeIn(title), FadeIn(rule), run_time=0.7)
self.play(LaggedStart(*[FadeIn(g) for g in group], lag_ratio=0.3, run_time=1.5))
self.play(FadeIn(note), run_time=0.6)
self.wait(3.0)

下载 Python 脚本

2.3. 分别设置每个弧

参数angle和radius是用来统一设置所有边的弯曲度的,

如果我们想给弧形多边形的每条边设置不同的弧度,就要使用arc_config参数。

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
from manim import *
class ArcPolygonConfig(Scene):
"""2.3 arc_config 逐条设置每条边:list 长度必须等于顶点数(源码里有 assert)。
顺序对应 UR→UL(上)、UL→DL(左)、DL→DR(下)、DR→UR(右);
dict 直接透传给 ArcBetweenPoints,所以 color / stroke_width 也能逐条设置。
"""
def construct(self):
kw = dict(font="STLiti")
title = Text("2.3 分别设置每个弧 arc_config", font_size=36, color=RED, **kw).to_edge(UP, buff=0.3)
rule = Line(LEFT * 6.6, RIGHT * 6.6, color=BLUE_B, stroke_width=3).next_to(title, DOWN, buff=0.18)
verts = [UR, UL, DL, DR]
arc_config = [
{"angle": 30 * DEGREES, "color": RED, "stroke_width": 6},
{"angle": 90 * DEGREES, "color": YELLOW, "stroke_width": 6},
{"radius": 2, "color": GREEN, "stroke_width": 6},
{"radius": 5, "color": PURPLE, "stroke_width": 6},
]
poly = ArcPolygon(*verts, arc_config=arc_config,
fill_color=TEAL, fill_opacity=0.28).scale(1.2).shift(DOWN * 0.25)
caps = VGroup(
Text("angle = 30 度", font_size=26, color=RED, **kw).next_to(poly, UP, buff=0.35),
Text("angle = 90 度", font_size=26, color=YELLOW, **kw).next_to(poly, LEFT, buff=0.35),
Text("radius = 2", font_size=26, color=GREEN, **kw).next_to(poly, DOWN, buff=0.35),
Text("radius = 5", font_size=26, color=PURPLE, **kw).next_to(poly, RIGHT, buff=0.35),
)
note = Text("arc_config 是 list[dict],元素个数必须和顶点数相同",
font_size=24, color=GREY_B, **kw).to_edge(DOWN, buff=0.3)
self.play(FadeIn(title), FadeIn(rule), run_time=0.7)
self.play(FadeIn(poly), run_time=1.2)
self.play(LaggedStart(*[FadeIn(c) for c in caps], lag_ratio=0.2, run_time=1.0))
self.play(FadeIn(note), run_time=0.6)
self.wait(2.2)

下载 Python 脚本

通过arc_config不仅可以设置每个弧的弯曲度,也可以设置它们线的粗细,颜色等等属性。上面的示例给四条边分别设了红、黄、绿、紫,并填充半透明青色,方便看清各条边不同的弯曲程度。

最容易踩的坑:ArcPolygon(...) 只是构造出一个 Mobject,必须 self.add(...) 或 self.play(FadeIn(...)) 把它加入场景才会显示。只调用、不接住返回值的写法,渲染出来就是一片黑。本文 5 段示例都改成了完整可运行的 Scene。

2.4. 通过圆弧构造多边形

ArcPolygonFromArcs是通过一系列圆弧来构造多边形的,所以不需要angle和radius这些参数了。

必须写对的地方:ArcBetweenPoints 的签名是 ArcBetweenPoints(start, end, angle=PI/4, radius=None, **kwargs),start 与 end 是必需的位置参数。旧教程里那种 ArcBetweenPoints(angle=PI/6, color=BLUE) 在 Manim CE 0.21.0 会直接抛 TypeError: missing 2 required positional arguments。上面的代码用 UR, UL, DL, DR 四个角点,让四段弧首尾相接。

因为构造每个圆弧时已经设置好圆弧的弯曲度和相关属性了。

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
from manim import *
class ArcPolygonFromArcsDemo(Scene):
"""2.4 用四段首尾相接的圆弧拼出闭合弧形多边形。
关键:ArcBetweenPoints 的 start / end 是必需的位置参数,
必须写成 ArcBetweenPoints(A, B, angle=..., color=...);
只给 angle 和 color 会直接 TypeError(旧版教程里的写法已失效)。
"""
def construct(self):
kw = dict(font="STLiti")
title = Text("2.4 通过圆弧构造多边形", font_size=36, color=RED, **kw).to_edge(UP, buff=0.3)
rule = Line(LEFT * 6.6, RIGHT * 6.6, color=BLUE_B, stroke_width=3).next_to(title, DOWN, buff=0.18)
A, B, C, D = UR, UL, DL, DR
arc1 = ArcBetweenPoints(A, B, angle=PI / 6, color=BLUE, stroke_width=6)
arc2 = ArcBetweenPoints(B, C, angle=PI / 3, color=GREEN, stroke_width=6)
arc3 = ArcBetweenPoints(C, D, angle=PI / 2, color=YELLOW, stroke_width=6)
arc4 = ArcBetweenPoints(D, A, angle=2 * PI / 3, color=RED, stroke_width=6)
poly = ArcPolygonFromArcs(arc1, arc2, arc3, arc4).scale(1.2).shift(DOWN * 0.25)
caps = VGroup(
Text("30 度", font_size=26, color=BLUE, **kw).next_to(poly, UP, buff=0.4),
Text("60 度", font_size=26, color=GREEN, **kw).next_to(poly, LEFT, buff=0.4),
Text("90 度", font_size=26, color=YELLOW, **kw).next_to(poly, DOWN, buff=0.4),
Text("120 度", font_size=26, color=RED, **kw).next_to(poly, RIGHT, buff=0.4),
)
note = Text("四段弧首尾相接即为闭合多边形,ArcPolygonFromArcs 负责拼合",
font_size=24, color=GREY_B, **kw).to_edge(DOWN, buff=0.3)
self.play(FadeIn(title), FadeIn(rule), run_time=0.7)
self.play(FadeIn(poly), run_time=1.5)
self.play(LaggedStart(*[FadeIn(c) for c in caps], lag_ratio=0.2, run_time=1.0))
self.play(FadeIn(note), run_time=0.6)
self.wait(2.2)

下载 Python 脚本

2.5. 缺失圆弧时的多边形

上面的示例中,使用ArcPolygonFromArcs构造多变形时,传入的4个圆弧合起来正好是闭合的。

如果传入的圆弧不是闭合的会怎么样呢?

ArcPolygonFromArcs会自动将不闭合部分用直线相连,

也就是前一个圆弧的终点和下一个圆弧的起点用直线相连,最终构成一个闭合的多边形。

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
from manim import *
class ArcPolygonMissingArcs(Scene):
"""2.5 只给两段不相连的圆弧时,ArcPolygonFromArcs 自动用直线补上缺口。
同样注意 ArcBetweenPoints 必须显式给出 start 与 end 两个位置参数。
"""
def construct(self):
kw = dict(font="STLiti")
title = Text("2.5 缺失圆弧时的多边形", font_size=36, color=RED, **kw).to_edge(UP, buff=0.3)
rule = Line(LEFT * 6.6, RIGHT * 6.6, color=BLUE_B, stroke_width=3).next_to(title, DOWN, buff=0.18)
A, B, C, D = UR, UL, DL, DR
arc1 = ArcBetweenPoints(A, B, angle=PI / 6, color=BLUE, stroke_width=6)
arc3 = ArcBetweenPoints(C, D, angle=PI / 2, color=YELLOW, stroke_width=6)
poly = ArcPolygonFromArcs(arc1, arc3).scale(1.2).shift(DOWN * 0.25)
caps = VGroup(
Text("30 度", font_size=26, color=BLUE, **kw).next_to(poly, UP, buff=0.4),
Text("90 度", font_size=26, color=YELLOW, **kw).next_to(poly, DOWN, buff=0.4),
Text("自动补直线", font_size=24, color=WHITE, **kw).next_to(poly, LEFT, buff=0.45),
Text("自动补直线", font_size=24, color=WHITE, **kw).next_to(poly, RIGHT, buff=0.45),
)
note = Text("弧不闭合时,缺口由白色直线自动连接,最终仍是闭合多边形",
font_size=24, color=GREY_B, **kw).to_edge(DOWN, buff=0.3)
self.play(FadeIn(title), FadeIn(rule), run_time=0.7)
self.play(FadeIn(poly), run_time=1.5)
self.play(LaggedStart(*[FadeIn(c) for c in caps], lag_ratio=0.2, run_time=1.0))
self.play(FadeIn(note), run_time=0.6)
self.wait(2.2)

下载 Python 脚本

缺失的部分就是上面白色直线连接的部分。也就是说,只要把已知的那几段弧交给 ArcPolygonFromArcs,它会自动补齐缺口,不必自己算连接线。

提示:自动补出来的直线用的是默认白色;想改颜色或粗细,把 color / stroke_width 作为 **kwargs 传给 ArcPolygonFromArcs 即可。

3. 附件

本文 5 段示例均为完整可运行的 Scene,可直接复制保存为 .py 后用 manim -qh 文件名.py 场景名 渲染;每段视频下方也提供了对应的站内脚本下载链接。中文文字统一显式指定 font="STLiti",避免默认西文字体渲染中文时出现豆腐块。

环境:Manim CE 0.21.0;演示视频由上述脚本真实渲染生成(1920×1080 / 60fps)。