对于长篇大段的文本显示,manim中专门提供了一个Paragraph类。 使用Paragraph,就不需要用拼接Text的方式来显示大段的文本。

1. 主要参数

Paragraph可以看作是基于Text的扩展,所以Text的默认参数Paragraph也可以使用。不过当你需要显示多行文本的时候,用Paragraph更加方便。

当然Paragraph特有的参数还有:

参数名称 类型 说明
text list 可以输入多个字符串
line_spacing float 行间距
alignment str 对齐方向

Text也有text参数,是str类型,只能输入一个字符串, 而Paragraph的text参数是不定长的列表,可以输入多个字符串,每个字符串显示成一行。

line_spacing参数Text也有,不过Text多用来显示单行的文本,这个参数用处不大, 而Paragraph则用来显示多行文本,所以line_spacing对Paragraph更加有用。

alignment参数用来设置段落文本各行的对齐方式的,默认左对齐,还可以设置右对齐和居中对齐。

2. 使用示例

段落Paragraph也可以使用Text的各种参数,这里前两个示例演示Paragraph常用的两个参数, 最后一个示例演示使用Text的参数来设置颜色。Text中设置字体,样式的参数,Paragraph也同样支持,这里不再演示。

2.1. 调整行间距

通过line_spacing设置不同的行间距。

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
# -*- coding: utf-8 -*-
# 示例 2.1:Paragraph 的行间距 line_spacing(对应视频 20240826201304000)
# 本地复现:manim -qh 20240826201304000.py LineSpacingDemo
# 知识点:Paragraph(*text) 里每个字符串就是一行;line_spacing 控制行与行的垂直距离,
# 默认 -1 由 Manim 自动取值,数值越大段落越高。它只改行距,不改字号和字形。
# 中文注意:Paragraph 基于 Text,含中文必须显式指定中文字体,否则会渲染成白色方块。
from manim import *
# STLiti = 华文隶书(C:\Windows\Fonts\STLITI.TTF);西文等宽字体不含中文字形。
FONT = "STLiti"
# 三行故意写成不同长度,行距变化时更容易看出各行垂直位置的变化。
LINES = ("第一行:内容中等内容中等", "第二行:内容短", "第三行:内容较长内容较长内容较长")
# t2c 是 Text 的参数,Paragraph 同样支持:按子串给字符上色,三行一眼可分。
COLORS = {"第一行": RED, "第二行": BLUE, "第三行": GREEN}
class LineSpacingDemo(Scene):
def construct(self):
title = Text("Paragraph 行间距 line_spacing", font=FONT, font_size=44)
title.to_edge(UP, buff=0.45)
# 固定参考框:三档行距都在同一个框里展示,方便对比段落总高度。
frame = Rectangle(width=10.2, height=3.6, color="#9AA0A6", stroke_width=2)
frame.shift(DOWN * 0.45)
self.play(FadeIn(title, shift=DOWN * 0.2), Create(frame), run_time=0.7)
cases = [(0.5, "0.5 紧凑", "行距约 0.5 倍字高,三行贴得很近"),
(1.5, "1.5 适中", "行距约 1.5 倍,阅读比较舒服"),
(2.5, "2.5 宽松", "行距约 2.5 倍,段落明显变高")]
for sp, label, tip in cases:
# line_spacing 是构造参数,不能事后修改,所以每档都新建一个 Paragraph。
para = Paragraph(*LINES, line_spacing=sp, font=FONT, font_size=32, t2c=COLORS)
para.move_to(frame)
badge = Text("line_spacing = " + str(sp) + " " + label, font=FONT, font_size=30, color=YELLOW)
badge.next_to(frame, DOWN, buff=0.28)
note = Text(tip, font=FONT, font_size=24, color="#BDC1C6")
note.next_to(badge, DOWN, buff=0.14)
self.play(FadeIn(para, shift=UP * 0.12), FadeIn(badge), FadeIn(note), run_time=0.5)
self.wait(1.0)
# 前两档淡出,最后一档留在屏上作为完成态(封面取第 5 秒帧)。
if sp != 2.5:
self.play(FadeOut(para), FadeOut(badge), FadeOut(note), run_time=0.35)
self.wait(2.2)

下载 Python 脚本

2.2. 调整对齐方向

通过alignment设置不同的对齐方向。

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 -*-
# 示例 2.2:Paragraph 的对齐方向 alignment(对应视频 20240826201304001)
# 本地复现:manim -qh 20240826201304001.py AlignmentDemo
# 知识点:alignment 只管同一段落内各行的水平对齐,取值 "left" / "right" / "center",
# 默认左对齐。它不改文字内容,也不决定整段在画面上的位置——位置由 move_to 决定。
# 中文注意:Paragraph 基于 Text,含中文必须显式指定中文字体,否则会渲染成白色方块。
from manim import *
# STLiti = 华文隶书(C:\Windows\Fonts\STLITI.TTF);西文等宽字体不含中文字形。
FONT = "STLiti"
# 三行长度不同,才能看出「左端齐」「右端齐」「中线对称」的区别。
LINES = ("第一行:内容中等内容中等", "第二行:内容短", "第三行:内容较长内容较长内容较长")
# t2c 是 Text 的参数,Paragraph 同样支持:按子串给字符上色,三行一眼可分。
COLORS = {"第一行": RED, "第二行": BLUE, "第三行": GREEN}
class AlignmentDemo(Scene):
def construct(self):
title = Text("Paragraph 对齐方向 alignment", font=FONT, font_size=44)
title.to_edge(UP, buff=0.45)
frame = Rectangle(width=8.4, height=3.4, color="#9AA0A6", stroke_width=2)
frame.shift(DOWN * 0.45)
# x_edge 是这三行文字(32 号字)的自然半宽;两条边线 + 一条中线当标尺,
# 左对齐贴左线、右对齐贴右线、居中对齐关于中线对称,肉眼即可分辨。
x_edge = 3.57
guides = VGroup(
DashedLine(frame.get_top() + LEFT * x_edge, frame.get_bottom() + LEFT * x_edge,
dash_length=0.12, color="#5F6368"),
DashedLine(frame.get_top() + RIGHT * x_edge, frame.get_bottom() + RIGHT * x_edge,
dash_length=0.12, color="#5F6368"),
DashedLine(frame.get_top(), frame.get_bottom(),
dash_length=0.12, color="#3C4043"),
)
self.play(FadeIn(title, shift=DOWN * 0.2), Create(frame), Create(guides), run_time=0.7)
cases = [("left", "左对齐(默认)", "三行左端对齐,右侧参差"),
("right", "右对齐", "三行右端对齐,左侧参差"),
("center", "居中对齐", "三行关于中线对称")]
for a, label, tip in cases:
# alignment 同样是构造参数,每档新建一个 Paragraph。
para = Paragraph(*LINES, alignment=a, font=FONT, font_size=32, t2c=COLORS)
para.move_to(frame)
badge = Text("alignment = \"" + a + "\" " + label, font=FONT, font_size=30, color=YELLOW)
badge.next_to(frame, DOWN, buff=0.28)
note = Text(tip, font=FONT, font_size=24, color="#BDC1C6")
note.next_to(badge, DOWN, buff=0.14)
self.play(FadeIn(para, shift=UP * 0.12), FadeIn(badge), FadeIn(note), run_time=0.5)
self.wait(1.0)
# 最后一档留在屏上作为完成态(封面取第 5 秒帧)。
if a != "center":
self.play(FadeOut(para), FadeOut(badge), FadeOut(note), run_time=0.35)
self.wait(2.2)

下载 Python 脚本

2.3. 设置颜色

设置颜色这个示例是为了演示Paragraph也可以使用Text的参数。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
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 R023_02(Scene):
def construct(self):
sc = self
p = Paragraph('第一行:内容中等内容中等', '第二行:内容短', '第三行:内容较长内容较长内容较长', t2c={'第一行': RED, '第二行': BLUE, '第三行': GREEN}, t2g={'内容中等': (BLUE, GREEN), '内容短': (GREEN, RED), '内容较长': (RED, BLUE)})
self.play(FadeIn(p), run_time=1.0)
self.wait(1)
self.wait(0.5)
self.wait(3.10)

下载 Python 脚本

3. 附件