只想在某一小段代码里改配置、出了这段就恢复,用 tempconfig 上下文管理器最干净。上面的完整示例把「进入前 / 块内 / 退出后」三个时刻的 frame_rate、frame_width 读数并排显示,同时验证两个容易踩的坑:未知键会被静默过滤、块内抛异常也能还原。所有数值都在运行时从 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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
from manim import *
class TempConfigDemo(Scene):
"""tempconfig:只在 with 块内临时覆盖 config,退出后自动还原。
本例实跑验证三个关键行为:读值变化、未知键被静默过滤、异常也会还原。
注意渲染规格在 Scene 初始化时锁定,运行时改帧率只改变读到的值。
"""
def construct(self):
# 中文统一指定中文字体,避免豆腐块
kw = dict(font="STLiti")
title = Text("tempconfig 临时改配置", font_size=44, **kw).to_edge(UP, buff=0.32)
sub = Text("with 块内生效 · 退出自动还原", font_size=26, color=GREY_B, **kw)
sub.next_to(title, DOWN, buff=0.16)
# 块内只读取数值,不创建 Mobject,避免改动 frame_width 影响几何计算
before_fr, before_fw = config.frame_rate, config.frame_width
with tempconfig({"frame_rate": 30, "frame_width": 20.0, "no_such_key": 1}):
inside_fr, inside_fw = config.frame_rate, config.frame_width
unknown_in = "no_such_key" in config
after_fr, after_fw = config.frame_rate, config.frame_width
# 三行对照:进入前 / 块内 / 退出后,整组左对齐
specs = [
("进入前", before_fr, before_fw, WHITE),
("块内", inside_fr, inside_fw, YELLOW),
("退出后", after_fr, after_fw, GREEN),
]
rows = VGroup()
for label, fr, fw, color in specs:
line = VGroup(
Text(label, font_size=32, color=color, **kw),
Text("frame_rate = %g frame_width = %.2f" % (fr, fw),
font_size=30, color=color, **kw),
).arrange(RIGHT, buff=0.7)
rows.add(line)
rows.arrange(DOWN, buff=0.34, aligned_edge=LEFT).next_to(sub, DOWN, buff=0.5)
# 两个容易踩坑的细节,配合源码行为一起看
n1 = Text("未知键被静默过滤:no_such_key 写不进 config(%s)"
% ("是" if unknown_in else "否"), font_size=26, color=BLUE_B, **kw)
n2 = Text("块内抛异常也会还原:tempconfig 用 try/finally 回滚", font_size=26, color=BLUE_B, **kw)
foot = Text("渲染规格在 Scene 初始化时锁定,运行中改帧率不影响输出视频",
font_size=24, color=GREY_B, **kw)
notes = VGroup(n1, n2, foot).arrange(DOWN, buff=0.22, aligned_edge=LEFT)
notes.next_to(rows, DOWN, buff=0.55)
self.play(FadeIn(title, shift=DOWN * 0.2), FadeIn(sub), run_time=0.8)
self.play(LaggedStart(*[FadeIn(r, shift=RIGHT * 0.25) for r in rows],
lag_ratio=0.28, run_time=1.6))
self.play(LaggedStart(*[FadeIn(x) for x in notes], lag_ratio=0.25, run_time=1.2))
self.wait(2.2)

演示视频

下载 Python 脚本

要点

  • with tempconfig({...}): 只在 with 块内生效,退出时自动还原,不用手写恢复代码
  • 传入字典或 ManimConfig 都可以,键名与 config 的属性名一致,如 frame_rate、background_color
  • 未知键会被静默忽略:源码先做 {k: v for k, v in temp.items() if k in original},写错键名既不报错也不生效,排查时很容易漏
  • 异常安全:内部是 try: yield + finally: config.update(original),块内抛异常照样回滚
  • 别拿它改输出规格:分辨率、帧率、像素尺寸在 Scene 初始化时已锁定,运行中改只影响读到的值,不改变本次输出的视频
  • 中文文字要显式指定中文字体,例如 Text("中文", font="STLiti"),否则会出现豆腐块

原理:为什么是 update 而不是赋值

tempconfig 的实现有一处刻意设计,值得单独看(伪代码):

1
2
3
4
5
6
original = config.copy()
config.update({k: v for k, v in temp.items() if k in original})
try:
yield
finally:
config.update(original)

config 是 Manim 各模块共同引用的全局对象。若写成 config = {...},只是让当前函数的局部变量指向一个新字典,
其他模块持有的仍是旧对象,改动根本不会生效;用 config.update(...) 才是原地修改同一个对象。
退出时用 original 再 update 回去,所有模块看到的状态一起回滚。这也解释了为什么脚本里 from manim import * 导入的 config 能在 with 块内外读到不同数值——它始终指向同一个对象,只是内容被临时改过。

代码来源:Manim Community 官方教程 Guides / Configuration 的 tempconfig 用法;示例代码按 Manim CE 0.21.0 重写并实跑验证,演示视频由该脚本真实渲染生成(1920×1080 / 60fps)。