弧形多边形是一种结合了圆弧和多边形的图形,这类几何图形在设计中应用非常广泛。
比如在家居设计中,看看家里的沙发,餐桌和座椅等,它们的边角,靠背等地方都是弧形的设计,这种设计有效柔化了室内空间,使整体氛围更加和谐自然。
还有景观和建筑设计中,弧形多边形常被用于道路规划、花坛布局等,
特别是儿童游乐的区域,通过自由的弧线设计,不仅符合儿童活泼好动的天性,还能激发他们的想象力和创造力。
在艺术设计领域,弧形多边形用的就更多了,在图形、标志、海报等的创作中,弧形多边形独特的形状和视觉效果能够吸引观众的注意力,传达出设计者的意图和情感。
manim中提供了2个模块来构造弧形多边形:
ArcPolygon:通过顶点和弧度来构造弧形多边形
ArcPolygonFromArcs:通过圆弧来构造弧形多边形

这两个模块的主要区别在于构造弧形多边形的过程不同,一个是通过顶点,一个是通过圆弧,
最终构造出的弧形多边形并没有什么不同。
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)。
主观感受,仅供参考。本文采用 本文采用 CC BY-NC-SA 4.0 许可 协议,
完整转载请注明来自
数学动画引擎。