OpenMontage 实战ManimCE 中的 LaTeX 数学公式渲染与方程样式化完全指南【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage导读本指南以 OpenMontage 仓库中manimce-best-practices技能的 latex.md 规则文档为骨架系统讲解 Manim Community EditionManimCE中MathTex、Tex两个核心类的 LaTeX 渲染机制、方程着色、多段拆分、自定义宏包与对齐技巧并延伸到仓库中 math_animate 工具的落地用法与 LaTeX 环境配置。读完本文你将能写出可运行、可动画、可精确着色的数学公式场景并在 OpenMontage 的数学动画流水线中直接产出高质量公式视频。一、LaTeX 在 Manim 中的地位Manim 本身是一个 Python 动画引擎但它本身并不认识数学公式。它通过调用系统 LaTeX 编译器把MathTex/Tex对象中的 LaTeX 源码编译为 TeX 排版结果media/Tex/缓存目录下的中间产物再以 SVG/向量路径的形式加载为场景中的 Mobject。因此数学表达式的质量取决于 LaTeX 排版而非 Pango 文本渲染Text类走 Pango/Cairo不能渲染 LaTeX见 text.md系统中必须存在可用的 TeX 发行版见下文环境要求一节LaTeX 源码使用r...原始字符串传递避免反斜杠被 Python 转义。在 OpenMontage 中LaTeX 渲染能力由 math_animate 工具承载。该工具直接以 ManimCE 为后端provider manim其安装说明明确写道Requires: Python 3.8, FFmpeg, LaTeX (optional, for math formulas) Windows:choco install miktex ffmpegmacOS:brew install mactex ffmpegLinux:sudo apt install texlive-full ffmpeg同时该工具的user_visible_verification字段把数学公式是否渲染正确需 LaTeX列为渲染后的必检项。可见 LaTeX 是整个数学动画链路的可选但关键的依赖。二、MathTex 与 Tex两种 LaTeX 对象的选择ManimCE 提供两个 LaTeX 相关类核心区别在于数学模式的自动包裹MathTex自动把内容包裹进数学模式内部使用align*环境无需手动写$...$Tex原始 LaTeX数学模式由你自己控制——纯文本直接写数学部分用$...$包裹。规则文档给出的对比示例from manim import * class LaTeXComparison(Scene): def construct(self): # MathTex - auto math mode math MathTex(rE mc^2) # Tex - need explicit math delimiters tex Tex(r$E mc^2$) # Both render the same VGroup(math, tex).arrange(DOWN) self.add(math, tex)选择原则很清晰纯数学用MathTex混合文本与数学用Tex。例如文案 The area is $A \pi r^2$ 就必须用Tex因为整句是文本、只有公式部分是数学模式。仓库的 math_visualization.py 示例中所有纯公式场景如DerivativeChainRule、LimitNotation全部使用MathTex而标题类文字使用Text正是这一原则的体现。三、基础 MathTex常用数学结构的写法规则文档给出了六个覆盖最常用数学结构的入门示例class MathTexExample(Scene): def construct(self): # Simple equation eq1 MathTex(rx^2 y^2 z^2) # Fractions eq2 MathTex(r\frac{a}{b}) # Square roots eq3 MathTex(r\sqrt{2}) # Greek letters eq4 MathTex(r\alpha \beta \gamma) # Integrals eq5 MathTex(r\int_0^\infty e^{-x} dx) # Summations eq6 MathTex(r\sum_{n1}^{\infty} \frac{1}{n^2}) equations VGroup(eq1, eq2, eq3, eq4, eq5, eq6).arrange_in_grid(2, 3) self.add(equations)要点上下标^与_、分数\frac{}{}、根号\sqrt{}、积分\int_下限^上限、求和\sum_{起点}^{终点}都是标准 LaTeX 语法可直接套用使用VGroup(...).arrange_in_grid(2, 3)将多个公式排成 2 行 3 列的网格适合公式画廊式的展示。仓库示例 math_visualization.py 还展示了更丰富的真实场景例如矩阵与向量matrix MathTex( rA \begin{bmatrix} 2 1 \\ 1 3 \end{bmatrix} ).scale(1.2) vector MathTex( r\vec{x} \begin{bmatrix} 1 \\ 1 \end{bmatrix}, colorYELLOW )以及极限、积分与级数limit MathTex(r\lim_{x \to 0} \frac{\sin x}{x} 1, font_size64) formula MathTex(r\sum_{n1}^{\infty} \frac{1}{n^2} \frac{\pi^2}{6}, font_size64) integral MathTex(r\int_0^1 x^2 \, dx \frac{1}{3}, font_size64)注意\,是 LaTeX 中的小间距命令用于在微分符号前留出间隙让公式更易读。四、方程的局部着色让观众聚焦关键项数学讲解的核心是让眼睛跟着逻辑走局部着色是最有效的注意力引导手段。规则文档介绍了四种互补的方法。4.1 set_color_by_tex按 TeX 子串着色class ColoredEquation(Scene): def construct(self): eq MathTex(re^{i\pi} 1 0) eq.set_color_by_tex(e, RED) eq.set_color_by_tex(r\pi, BLUE) eq.set_color_by_tex(i, GREEN) self.add(eq)set_color_by_tex(substring, color)会把所有匹配该 LaTeX 子串的字符重新着色适合快速突出变量、常量、运算符。4.2 substrings_to_isolate先隔离再着色当同一字符出现多次、或需要精准控制时推荐先通过substrings_to_isolate参数把子串拆成独立的小 Mobject再逐个着色class IsolatedColoring(Scene): def construct(self): eq MathTex( re^x x^0 x^1 \frac{1}{2}x^2 \cdots, substrings_to_isolate[x] ) eq.set_color_by_tex(x, YELLOW) self.add(eq)规则文档特别强调用substrings_to_isolate处理重复出现的元素如多次出现的x最为可靠因为每个隔离子串都会被拆成独立对象着色不会误伤其他结构。4.3 index_labels调试用的索引标签着色前需要知道每个片段对应的下标index_labels()工具可以在屏幕上直接标出每个子 Mobject 的索引class DebugLabels(Scene): def construct(self): eq MathTex(r\frac{a}{b}) # Add index labels to see which index is which part self.add(index_labels(eq[0])) self.add(eq)index_labels来自manim.utils.tex会在每个子片段下方打印索引号是排查着色对象选错问题的利器。4.4 直接索引按位置精确取子对象MathTex构造时会把内容拆成若干子 Mobjecteq[0]、eq[1]……可直接按索引着色。字符级别的子对象再通过二级索引访问eq MathTex(ra b c) eq[0][0].set_color(RED) # a eq[0][2].set_color(BLUE) # b eq[0][4].set_color(GREEN) # c需要注意直接索引对字符位置敏感若 LaTeX 源码改动导致切分变化索引会失效因此规则文档的 Best Practices 明确推荐能隔离就隔离。4.5 补充tex_to_color_map 一键映射仓库示例 math_visualization.py 中还出现了一种更简洁的写法——构造时直接传tex_to_color_mapexample MathTex( r\frac{d}{dx}[\sin(x^2)] \cos(x^2) \cdot 2x, tex_to_color_map{ r\sin: BLUE, r\cos: BLUE, rx^2: YELLOW, r2x: YELLOW, }, font_size44 )tex_to_color_map是set_color_by_tex的构造期等价物适合公式从一开始就确定好配色的场景代码更紧凑。五、多段方程拆分以获得逐段动画控制将等式按语义拆成多个字符串传入MathTex会为每一段生成独立的子 Mobject从而可以对每段独立着色、独立动画class MultiPartEquation(Scene): def construct(self): eq MathTex(a, ^2, , b, ^2, , c, ^2) eq[0].set_color(RED) # a eq[3].set_color(BLUE) # b eq[6].set_color(GREEN) # c self.play(Write(eq))这里的a、^2、是显式切分切分粒度完全由你控制比依赖 Manim 自动切分更可预测。结合 manim-usage.md 的节奏建议公式类的Write动画建议run_time1.5~2.0s给观众留出解读 LaTeX 的时间。仓库示例 math_visualization.py 的ColorCodedEquation是更完整的进阶版本不仅拆分着色还通过TransformMatchingTex实现推导步骤之间的匹配变换相同 TeX 片段会原位变形新增片段渐入equation MathTex( r\vec{v}_1, r, r\begin{bmatrix} 1 \\ \lambda_1 \end{bmatrix} ) equation.scale(1.5) equation[0].set_color(TEAL) # \vec{v}_1 self.play(Write(equation)) self.wait() equation2 MathTex(rA, r\vec{v}_1, r, r\lambda_1, r\vec{v}_1) equation2[0].set_color(RED) # A equation2[1].set_color(TEAL) # first \vec{v}_1 equation2[3].set_color(YELLOW) # \lambda_1 equation2[4].set_color(TEAL) # second \vec{v}_1 self.play(TransformMatchingTex(equation, equation2))这正是分步推导类科普视频的标准模式先展示起始式再变换为下一形式观众始终能追踪每个符号的去向。六、文本与数学混排Tex 的应用当一句话中既有说明文字又有公式时使用Tex并在公式两侧显式加$...$class MixedContent(Scene): def construct(self): # Mix text and math tex Tex(rThe area is $A \pi r^2$) self.play(Write(tex))对比记忆MathTex若放入文本会因数学模式解析而出错或排版怪异所以文本 公式场景一律选择Tex。七、自定义 LaTeX 宏包TexTemplate 与前言扩展当内置的amsmath/amssymb等宏包不足以表达所需符号如书法体\mathscr、花体\mathcal的扩展集、tikz等时可以自定义TexTemplate并向前言preamble追加\usepackage{...}class CustomPackage(Scene): def construct(self): template TexTemplate() template.add_to_preamble(r\usepackage{mathrsfs}) eq Tex( r$\mathscr{L}$, tex_templatetemplate ) self.add(eq)TexTemplate支持链式叠加多个宏包需要频繁使用的模板可定义为模块级常量复用。此外Manim 的配置文件config.md也支持在manim.cfg的[tex]节中全局定制前言与编译器[tex] # Custom preamble preamble \usepackage{amsmath}\usepackage{amssymb} # Tex compiler tex_compiler latexTexTemplate只影响当前对象manim.cfg的[tex]影响整个项目两者按需选择。八、方程对齐多行推导的排版规范多行推导公式使用指定对齐点、\\换行MathTex会自动包裹进align*环境class AlignedEquations(Scene): def construct(self): eqs MathTex( ra b c \\, rd e f g \\, rh i ) self.add(eqs)所在列会在各行的同一水平位置对齐等号竖排整齐是教科书式推导的标准排版。注意\\在原始字符串r...中表示单个反斜杠加换行命令不会被 Python 转义破坏。九、常用 LaTeX 符号速查规则文档整理了五类高频符号可直接复制使用# Greek letters MathTex(r\alpha \beta \gamma \delta \epsilon) MathTex(r\Gamma \Delta \Theta \Lambda \Pi) # Operators MathTex(r\times \div \pm \mp \cdot) # Relations MathTex(r\leq \geq \neq \approx \equiv) # Arrows MathTex(r\rightarrow \leftarrow \Rightarrow \Leftrightarrow) # Sets MathTex(r\in \notin \subset \supset \cup \cap) # Calculus MathTex(r\int \iint \oint \partial \nabla)其中大写希腊字母命令\Gamma、\Delta……对应大写形态小写命令对应小写形态\iint/\oint属于扩展数学符号通常需amsmath支持Manim 默认前言已含若失效请参考上文自定义宏包一节补装。十、字号控制font_size 与 scale两种方式等效调节公式视觉大小# Using font_size parameter eq MathTex(rE mc^2, font_size72) # Using scale eq MathTex(rE mc^2).scale(2)差异在于语义font_size在构造期设定排版字号scale在生成后对整体几何做缩放。仓库示例中主公式常使用font_size64~96保证画面清晰辅助推导行用font_size40~48形成层级。与 manim-usage.md 的视觉规范一致主公式大、注释小、对比明显。十一、LaTeX 环境要求与常见故障排查11.1 安装 TeX 发行版LaTeX 渲染依赖系统级 TeX 发行版按平台安装与 math_animate 的install_instructions一致# Linux sudo apt install texlive-full ffmpeg # macOS brew install mactex ffmpeg # Windows choco install miktex ffmpeg安装完成后可用 Manim 自带的健康检查验证整条工具链pip install manim manim checkhealthcheckhealth会逐一检查 Python 版本、FFmpeg、LaTeX 等依赖任何一个缺失都会在输出中明确标红。若只做纯图形动画不渲染公式LaTeX 可以缺席但只要场景中出现MathTex/Tex编译就会因找不到 TeX 而失败。11.2 渲染命令与质量档位规则文档所属技能的 SKILL.md 给出标准渲染命令manim -pql scene.py MyScene # Preview low quality开发期 manim -pqh scene.py MyScene # Preview high quality质量档位速查来自 manim-usage.md 的渲染设置表标志分辨率FPS用途-ql480x36015开发/联调-qm1280x72030草稿评审-qh1920x108060标准 YouTube 输出-qp2560x144060高质量导出-qk3840x2160604K 归档/旗舰在 OpenMontage 的math_animate工具中质量档位被封装为quality参数默认medium其QUALITY_PRESETS与 CLI 标志一一对应math_animate.pyquality 参数CLI 标志分辨率FPSlow-ql854x48015medium-qm1280x72030high-qh1920x1080604k-qk3840x216060preview-ql --format gif854x48015若需精确匹配 OpenMontage 的 YouTube 横向画布1920x1080/30fps可渲染-qh后转码为 30fps或在manim.cfg中定制[CLI] pixel_width 1920 pixel_height 1080 frame_rate 3011.3 LaTeX 缓存与常见报错Manim 会把编译好的 TeX 结果缓存在media/Tex/目录输出目录结构见 config.md重复渲染相同公式不会重复编译。常见故障LaTeX is not installed系统缺 TeX 发行版按 11.1 安装Package xxx not found缺宏包用TexTemplate.add_to_preamble或manim.cfg的[tex] preamble补充公式渲染成红叉/乱码LaTeX 源码语法错误检查花括号配对与未转义字符缓存导致改动不生效在[CLI]中设置disable_caching True临时关闭缓存调试。十二、在 OpenMontage 中落地math_animate 的 LaTeX 链路12.1 渲染流程math_animate.py 是 OpenMontage 中承载 ManimCE 的生成类工具Tier.GENERATE、本地运行、零 API 成本。其渲染链路为接收scene_codePython 源码若缺少from manim import *则自动补全通过静态 AST 扫描做安全门禁见下文 12.2自动探测Scene子类名_detect_scene_name用正则匹配Scene|ThreeDScene|MovingCameraScene|ZoomedScene子类将代码写入临时目录按quality/format/background_color/transparent等参数拼装manimCLI 命令并执行在media/目录递归查找产物_find_output用ffprobe探测时长、分辨率、编码信息后返回。工具对渲染质量的验证项明确包含Verify math formulas render correctly (requires LaTeX)因此 LaTeX 环境缺失时公式类场景会被标记为渲染失败而非静默通过。12.2 安全门禁与场景代码边界由于scene_code是调用方通常由 LLM 生成提供的本地可执行 Python工具默认开启静态安全扫描test_math_animate_safety.py 中有一整套回归用例阻止os、sys、subprocess、socket、requests、pathlib等危险导入阻止eval、exec、open、__builtins__、getattr等危险标识符含别名间接调用阻止除__init__/__name__之外的一切 dunder 属性访问堵住().__class__...与print.__self__逃逸路径允许from manim import *、import numpy as np、import math等正常数学/动画依赖只有当调用方显式传入allow_unsafe_codetrue时才放行math_animate.py 中有完整说明与 issue #219 背景。对文章读者而言这意味着在 OpenMontage 里写 LaTeX 场景代码时应只使用 Manim 数学/动画相关 API不要引入系统级模块公式本身MathTex、Tex、TexTemplate完全不受扫描限制。12.3 实战节奏建议结合 manim-usage.md 的节奏规范面向公式讲解场景的推荐参数环节推荐值公式Writerun_time1.5~2.0ssmooth公式变换推导run_time1.5s使用TransformMatchingTex颜色高亮run_time0.5s作为注意力提示逐项揭示LaggedStartlag_ratio0.1~0.2揭示后停留self.wait(1.0~2.0s)复杂公式取更长画布背景深色BLACK或#1a1a2e配合 OpenMontage 深色视觉体系配色上OpenMontage 建议语义化用色求解变量YELLOW、矩阵/算子RED、特征向量/结果TEAL、已知常量BLUE_C、批注GREEN、弱化GREYopacity0.5并避免仅靠红绿区分结合_A~_E明度变化提升可访问性。十三、最佳实践清单规则文档给出的五条铁律结合仓库实战补充如下始终使用原始字符串r...—— LaTeX 反斜杠命令密集普通字符串会被 Python 转义破坏纯数学用MathTex—— 免去手写$...$自动align*包裹文本 数学混排用Tex—— 只在公式两侧写$...$按动画目标拆分方程—— 需要独立着色/独立变换的片段显式拆成独立参数配合substrings_to_isolate保证隔离可靠性重复元素优先substrings_to_isolate—— 比脆弱的直接索引更稳调试时用index_labels核对下标复杂公式放慢节奏——Write公式给 1.5~2.0s揭示后wait(1.5s)起推导用TransformMatchingTex—— 相同片段原位变形逻辑连续性强自定义符号用TexTemplate.add_to_preamble全局前言写入manim.cfg的[tex]节渲染前先manim checkhealth—— 一次性确认 Python/FFmpeg/LaTeX 链路完整开发期用-ql、正式输出用-qhOpenMontage 的math_animate工具通过quality参数映射同一套档位。延伸阅读latex.md本指南的源规则文档SKILL.mdManimCE 技能总览含场景结构、动画、CLI 速查math_visualization.py可直接运行的公式可视化示例manim -pql math_visualization.py ColorCodedEquationmanim-usage.mdOpenMontage 实战渲染设置、节奏与配色规范config.mdmanim.cfg完整配置说明与[tex]前言配置math_animate.pyOpenMontage 的 Manim 渲染工具实现test_math_animate_safety.py场景代码安全扫描的回归测试。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
OpenMontage 实战：ManimCE 中的 LaTeX 数学公式渲染与方程样式化完全指南
OpenMontage 实战ManimCE 中的 LaTeX 数学公式渲染与方程样式化完全指南【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage导读本指南以 OpenMontage 仓库中manimce-best-practices技能的 latex.md 规则文档为骨架系统讲解 Manim Community EditionManimCE中MathTex、Tex两个核心类的 LaTeX 渲染机制、方程着色、多段拆分、自定义宏包与对齐技巧并延伸到仓库中 math_animate 工具的落地用法与 LaTeX 环境配置。读完本文你将能写出可运行、可动画、可精确着色的数学公式场景并在 OpenMontage 的数学动画流水线中直接产出高质量公式视频。一、LaTeX 在 Manim 中的地位Manim 本身是一个 Python 动画引擎但它本身并不认识数学公式。它通过调用系统 LaTeX 编译器把MathTex/Tex对象中的 LaTeX 源码编译为 TeX 排版结果media/Tex/缓存目录下的中间产物再以 SVG/向量路径的形式加载为场景中的 Mobject。因此数学表达式的质量取决于 LaTeX 排版而非 Pango 文本渲染Text类走 Pango/Cairo不能渲染 LaTeX见 text.md系统中必须存在可用的 TeX 发行版见下文环境要求一节LaTeX 源码使用r...原始字符串传递避免反斜杠被 Python 转义。在 OpenMontage 中LaTeX 渲染能力由 math_animate 工具承载。该工具直接以 ManimCE 为后端provider manim其安装说明明确写道Requires: Python 3.8, FFmpeg, LaTeX (optional, for math formulas) Windows:choco install miktex ffmpegmacOS:brew install mactex ffmpegLinux:sudo apt install texlive-full ffmpeg同时该工具的user_visible_verification字段把数学公式是否渲染正确需 LaTeX列为渲染后的必检项。可见 LaTeX 是整个数学动画链路的可选但关键的依赖。二、MathTex 与 Tex两种 LaTeX 对象的选择ManimCE 提供两个 LaTeX 相关类核心区别在于数学模式的自动包裹MathTex自动把内容包裹进数学模式内部使用align*环境无需手动写$...$Tex原始 LaTeX数学模式由你自己控制——纯文本直接写数学部分用$...$包裹。规则文档给出的对比示例from manim import * class LaTeXComparison(Scene): def construct(self): # MathTex - auto math mode math MathTex(rE mc^2) # Tex - need explicit math delimiters tex Tex(r$E mc^2$) # Both render the same VGroup(math, tex).arrange(DOWN) self.add(math, tex)选择原则很清晰纯数学用MathTex混合文本与数学用Tex。例如文案 The area is $A \pi r^2$ 就必须用Tex因为整句是文本、只有公式部分是数学模式。仓库的 math_visualization.py 示例中所有纯公式场景如DerivativeChainRule、LimitNotation全部使用MathTex而标题类文字使用Text正是这一原则的体现。三、基础 MathTex常用数学结构的写法规则文档给出了六个覆盖最常用数学结构的入门示例class MathTexExample(Scene): def construct(self): # Simple equation eq1 MathTex(rx^2 y^2 z^2) # Fractions eq2 MathTex(r\frac{a}{b}) # Square roots eq3 MathTex(r\sqrt{2}) # Greek letters eq4 MathTex(r\alpha \beta \gamma) # Integrals eq5 MathTex(r\int_0^\infty e^{-x} dx) # Summations eq6 MathTex(r\sum_{n1}^{\infty} \frac{1}{n^2}) equations VGroup(eq1, eq2, eq3, eq4, eq5, eq6).arrange_in_grid(2, 3) self.add(equations)要点上下标^与_、分数\frac{}{}、根号\sqrt{}、积分\int_下限^上限、求和\sum_{起点}^{终点}都是标准 LaTeX 语法可直接套用使用VGroup(...).arrange_in_grid(2, 3)将多个公式排成 2 行 3 列的网格适合公式画廊式的展示。仓库示例 math_visualization.py 还展示了更丰富的真实场景例如矩阵与向量matrix MathTex( rA \begin{bmatrix} 2 1 \\ 1 3 \end{bmatrix} ).scale(1.2) vector MathTex( r\vec{x} \begin{bmatrix} 1 \\ 1 \end{bmatrix}, colorYELLOW )以及极限、积分与级数limit MathTex(r\lim_{x \to 0} \frac{\sin x}{x} 1, font_size64) formula MathTex(r\sum_{n1}^{\infty} \frac{1}{n^2} \frac{\pi^2}{6}, font_size64) integral MathTex(r\int_0^1 x^2 \, dx \frac{1}{3}, font_size64)注意\,是 LaTeX 中的小间距命令用于在微分符号前留出间隙让公式更易读。四、方程的局部着色让观众聚焦关键项数学讲解的核心是让眼睛跟着逻辑走局部着色是最有效的注意力引导手段。规则文档介绍了四种互补的方法。4.1 set_color_by_tex按 TeX 子串着色class ColoredEquation(Scene): def construct(self): eq MathTex(re^{i\pi} 1 0) eq.set_color_by_tex(e, RED) eq.set_color_by_tex(r\pi, BLUE) eq.set_color_by_tex(i, GREEN) self.add(eq)set_color_by_tex(substring, color)会把所有匹配该 LaTeX 子串的字符重新着色适合快速突出变量、常量、运算符。4.2 substrings_to_isolate先隔离再着色当同一字符出现多次、或需要精准控制时推荐先通过substrings_to_isolate参数把子串拆成独立的小 Mobject再逐个着色class IsolatedColoring(Scene): def construct(self): eq MathTex( re^x x^0 x^1 \frac{1}{2}x^2 \cdots, substrings_to_isolate[x] ) eq.set_color_by_tex(x, YELLOW) self.add(eq)规则文档特别强调用substrings_to_isolate处理重复出现的元素如多次出现的x最为可靠因为每个隔离子串都会被拆成独立对象着色不会误伤其他结构。4.3 index_labels调试用的索引标签着色前需要知道每个片段对应的下标index_labels()工具可以在屏幕上直接标出每个子 Mobject 的索引class DebugLabels(Scene): def construct(self): eq MathTex(r\frac{a}{b}) # Add index labels to see which index is which part self.add(index_labels(eq[0])) self.add(eq)index_labels来自manim.utils.tex会在每个子片段下方打印索引号是排查着色对象选错问题的利器。4.4 直接索引按位置精确取子对象MathTex构造时会把内容拆成若干子 Mobjecteq[0]、eq[1]……可直接按索引着色。字符级别的子对象再通过二级索引访问eq MathTex(ra b c) eq[0][0].set_color(RED) # a eq[0][2].set_color(BLUE) # b eq[0][4].set_color(GREEN) # c需要注意直接索引对字符位置敏感若 LaTeX 源码改动导致切分变化索引会失效因此规则文档的 Best Practices 明确推荐能隔离就隔离。4.5 补充tex_to_color_map 一键映射仓库示例 math_visualization.py 中还出现了一种更简洁的写法——构造时直接传tex_to_color_mapexample MathTex( r\frac{d}{dx}[\sin(x^2)] \cos(x^2) \cdot 2x, tex_to_color_map{ r\sin: BLUE, r\cos: BLUE, rx^2: YELLOW, r2x: YELLOW, }, font_size44 )tex_to_color_map是set_color_by_tex的构造期等价物适合公式从一开始就确定好配色的场景代码更紧凑。五、多段方程拆分以获得逐段动画控制将等式按语义拆成多个字符串传入MathTex会为每一段生成独立的子 Mobject从而可以对每段独立着色、独立动画class MultiPartEquation(Scene): def construct(self): eq MathTex(a, ^2, , b, ^2, , c, ^2) eq[0].set_color(RED) # a eq[3].set_color(BLUE) # b eq[6].set_color(GREEN) # c self.play(Write(eq))这里的a、^2、是显式切分切分粒度完全由你控制比依赖 Manim 自动切分更可预测。结合 manim-usage.md 的节奏建议公式类的Write动画建议run_time1.5~2.0s给观众留出解读 LaTeX 的时间。仓库示例 math_visualization.py 的ColorCodedEquation是更完整的进阶版本不仅拆分着色还通过TransformMatchingTex实现推导步骤之间的匹配变换相同 TeX 片段会原位变形新增片段渐入equation MathTex( r\vec{v}_1, r, r\begin{bmatrix} 1 \\ \lambda_1 \end{bmatrix} ) equation.scale(1.5) equation[0].set_color(TEAL) # \vec{v}_1 self.play(Write(equation)) self.wait() equation2 MathTex(rA, r\vec{v}_1, r, r\lambda_1, r\vec{v}_1) equation2[0].set_color(RED) # A equation2[1].set_color(TEAL) # first \vec{v}_1 equation2[3].set_color(YELLOW) # \lambda_1 equation2[4].set_color(TEAL) # second \vec{v}_1 self.play(TransformMatchingTex(equation, equation2))这正是分步推导类科普视频的标准模式先展示起始式再变换为下一形式观众始终能追踪每个符号的去向。六、文本与数学混排Tex 的应用当一句话中既有说明文字又有公式时使用Tex并在公式两侧显式加$...$class MixedContent(Scene): def construct(self): # Mix text and math tex Tex(rThe area is $A \pi r^2$) self.play(Write(tex))对比记忆MathTex若放入文本会因数学模式解析而出错或排版怪异所以文本 公式场景一律选择Tex。七、自定义 LaTeX 宏包TexTemplate 与前言扩展当内置的amsmath/amssymb等宏包不足以表达所需符号如书法体\mathscr、花体\mathcal的扩展集、tikz等时可以自定义TexTemplate并向前言preamble追加\usepackage{...}class CustomPackage(Scene): def construct(self): template TexTemplate() template.add_to_preamble(r\usepackage{mathrsfs}) eq Tex( r$\mathscr{L}$, tex_templatetemplate ) self.add(eq)TexTemplate支持链式叠加多个宏包需要频繁使用的模板可定义为模块级常量复用。此外Manim 的配置文件config.md也支持在manim.cfg的[tex]节中全局定制前言与编译器[tex] # Custom preamble preamble \usepackage{amsmath}\usepackage{amssymb} # Tex compiler tex_compiler latexTexTemplate只影响当前对象manim.cfg的[tex]影响整个项目两者按需选择。八、方程对齐多行推导的排版规范多行推导公式使用指定对齐点、\\换行MathTex会自动包裹进align*环境class AlignedEquations(Scene): def construct(self): eqs MathTex( ra b c \\, rd e f g \\, rh i ) self.add(eqs)所在列会在各行的同一水平位置对齐等号竖排整齐是教科书式推导的标准排版。注意\\在原始字符串r...中表示单个反斜杠加换行命令不会被 Python 转义破坏。九、常用 LaTeX 符号速查规则文档整理了五类高频符号可直接复制使用# Greek letters MathTex(r\alpha \beta \gamma \delta \epsilon) MathTex(r\Gamma \Delta \Theta \Lambda \Pi) # Operators MathTex(r\times \div \pm \mp \cdot) # Relations MathTex(r\leq \geq \neq \approx \equiv) # Arrows MathTex(r\rightarrow \leftarrow \Rightarrow \Leftrightarrow) # Sets MathTex(r\in \notin \subset \supset \cup \cap) # Calculus MathTex(r\int \iint \oint \partial \nabla)其中大写希腊字母命令\Gamma、\Delta……对应大写形态小写命令对应小写形态\iint/\oint属于扩展数学符号通常需amsmath支持Manim 默认前言已含若失效请参考上文自定义宏包一节补装。十、字号控制font_size 与 scale两种方式等效调节公式视觉大小# Using font_size parameter eq MathTex(rE mc^2, font_size72) # Using scale eq MathTex(rE mc^2).scale(2)差异在于语义font_size在构造期设定排版字号scale在生成后对整体几何做缩放。仓库示例中主公式常使用font_size64~96保证画面清晰辅助推导行用font_size40~48形成层级。与 manim-usage.md 的视觉规范一致主公式大、注释小、对比明显。十一、LaTeX 环境要求与常见故障排查11.1 安装 TeX 发行版LaTeX 渲染依赖系统级 TeX 发行版按平台安装与 math_animate 的install_instructions一致# Linux sudo apt install texlive-full ffmpeg # macOS brew install mactex ffmpeg # Windows choco install miktex ffmpeg安装完成后可用 Manim 自带的健康检查验证整条工具链pip install manim manim checkhealthcheckhealth会逐一检查 Python 版本、FFmpeg、LaTeX 等依赖任何一个缺失都会在输出中明确标红。若只做纯图形动画不渲染公式LaTeX 可以缺席但只要场景中出现MathTex/Tex编译就会因找不到 TeX 而失败。11.2 渲染命令与质量档位规则文档所属技能的 SKILL.md 给出标准渲染命令manim -pql scene.py MyScene # Preview low quality开发期 manim -pqh scene.py MyScene # Preview high quality质量档位速查来自 manim-usage.md 的渲染设置表标志分辨率FPS用途-ql480x36015开发/联调-qm1280x72030草稿评审-qh1920x108060标准 YouTube 输出-qp2560x144060高质量导出-qk3840x2160604K 归档/旗舰在 OpenMontage 的math_animate工具中质量档位被封装为quality参数默认medium其QUALITY_PRESETS与 CLI 标志一一对应math_animate.pyquality 参数CLI 标志分辨率FPSlow-ql854x48015medium-qm1280x72030high-qh1920x1080604k-qk3840x216060preview-ql --format gif854x48015若需精确匹配 OpenMontage 的 YouTube 横向画布1920x1080/30fps可渲染-qh后转码为 30fps或在manim.cfg中定制[CLI] pixel_width 1920 pixel_height 1080 frame_rate 3011.3 LaTeX 缓存与常见报错Manim 会把编译好的 TeX 结果缓存在media/Tex/目录输出目录结构见 config.md重复渲染相同公式不会重复编译。常见故障LaTeX is not installed系统缺 TeX 发行版按 11.1 安装Package xxx not found缺宏包用TexTemplate.add_to_preamble或manim.cfg的[tex] preamble补充公式渲染成红叉/乱码LaTeX 源码语法错误检查花括号配对与未转义字符缓存导致改动不生效在[CLI]中设置disable_caching True临时关闭缓存调试。十二、在 OpenMontage 中落地math_animate 的 LaTeX 链路12.1 渲染流程math_animate.py 是 OpenMontage 中承载 ManimCE 的生成类工具Tier.GENERATE、本地运行、零 API 成本。其渲染链路为接收scene_codePython 源码若缺少from manim import *则自动补全通过静态 AST 扫描做安全门禁见下文 12.2自动探测Scene子类名_detect_scene_name用正则匹配Scene|ThreeDScene|MovingCameraScene|ZoomedScene子类将代码写入临时目录按quality/format/background_color/transparent等参数拼装manimCLI 命令并执行在media/目录递归查找产物_find_output用ffprobe探测时长、分辨率、编码信息后返回。工具对渲染质量的验证项明确包含Verify math formulas render correctly (requires LaTeX)因此 LaTeX 环境缺失时公式类场景会被标记为渲染失败而非静默通过。12.2 安全门禁与场景代码边界由于scene_code是调用方通常由 LLM 生成提供的本地可执行 Python工具默认开启静态安全扫描test_math_animate_safety.py 中有一整套回归用例阻止os、sys、subprocess、socket、requests、pathlib等危险导入阻止eval、exec、open、__builtins__、getattr等危险标识符含别名间接调用阻止除__init__/__name__之外的一切 dunder 属性访问堵住().__class__...与print.__self__逃逸路径允许from manim import *、import numpy as np、import math等正常数学/动画依赖只有当调用方显式传入allow_unsafe_codetrue时才放行math_animate.py 中有完整说明与 issue #219 背景。对文章读者而言这意味着在 OpenMontage 里写 LaTeX 场景代码时应只使用 Manim 数学/动画相关 API不要引入系统级模块公式本身MathTex、Tex、TexTemplate完全不受扫描限制。12.3 实战节奏建议结合 manim-usage.md 的节奏规范面向公式讲解场景的推荐参数环节推荐值公式Writerun_time1.5~2.0ssmooth公式变换推导run_time1.5s使用TransformMatchingTex颜色高亮run_time0.5s作为注意力提示逐项揭示LaggedStartlag_ratio0.1~0.2揭示后停留self.wait(1.0~2.0s)复杂公式取更长画布背景深色BLACK或#1a1a2e配合 OpenMontage 深色视觉体系配色上OpenMontage 建议语义化用色求解变量YELLOW、矩阵/算子RED、特征向量/结果TEAL、已知常量BLUE_C、批注GREEN、弱化GREYopacity0.5并避免仅靠红绿区分结合_A~_E明度变化提升可访问性。十三、最佳实践清单规则文档给出的五条铁律结合仓库实战补充如下始终使用原始字符串r...—— LaTeX 反斜杠命令密集普通字符串会被 Python 转义破坏纯数学用MathTex—— 免去手写$...$自动align*包裹文本 数学混排用Tex—— 只在公式两侧写$...$按动画目标拆分方程—— 需要独立着色/独立变换的片段显式拆成独立参数配合substrings_to_isolate保证隔离可靠性重复元素优先substrings_to_isolate—— 比脆弱的直接索引更稳调试时用index_labels核对下标复杂公式放慢节奏——Write公式给 1.5~2.0s揭示后wait(1.5s)起推导用TransformMatchingTex—— 相同片段原位变形逻辑连续性强自定义符号用TexTemplate.add_to_preamble全局前言写入manim.cfg的[tex]节渲染前先manim checkhealth—— 一次性确认 Python/FFmpeg/LaTeX 链路完整开发期用-ql、正式输出用-qhOpenMontage 的math_animate工具通过quality参数映射同一套档位。延伸阅读latex.md本指南的源规则文档SKILL.mdManimCE 技能总览含场景结构、动画、CLI 速查math_visualization.py可直接运行的公式可视化示例manim -pql math_visualization.py ColorCodedEquationmanim-usage.mdOpenMontage 实战渲染设置、节奏与配色规范config.mdmanim.cfg完整配置说明与[tex]前言配置math_animate.pyOpenMontage 的 Manim 渲染工具实现test_math_animate_safety.py场景代码安全扫描的回归测试。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
