OpenMontage 中的 ManimCE LaTeX 渲染全指南MathTex/Tex、公式分段着色与数学动画实战【免费下载链接】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 这套开源、面向 Agent 的视频生产系统中math_animate 工具负责把任意 LaTeX 数学表达式渲染成可播出的动画素材而其底层能力规范来自.agents/skills/manimce-best-practices技能包。本文以其中 rules/latex.md 为骨架系统讲解 Manim CommunityManimCE中 MathTex 与 Tex 的渲染机制、逐段着色、自定义宏包、对齐与字号控制等完整技法并结合仓库中的可运行示例与场景约定帮助你直接写出可渲染、可动效、可上色的公式动画代码。在项目中的位置一条从公式到成片的链路在深入语法之前先建立全局观。OpenMontage 中 ManimCE 并不是孤立运行的技能定义位于 .agents/skills/manimce-best-practices/SKILL.md其元数据规定当用户提到 manim、MathTex、Create()或代码中出现from manim import *时Agent 应加载该技能包并按 rules/latex.md 等 23 个规则文件撰写场景代码。工具层在 tools/graphics/math_animate.py 中声明provider manim、依赖cmd:manim并把agent_skills [manimce-best-practices, manim-composer]作为生成场景代码时强制挂载的技能上下文——也就是说Agent 写的每段 MathTex 代码都应以本规则为依据。生成后的动画还要服从 skills/creative/manim-usage.md 中定义的 OpenMontage 出片约定-qh渲染、深色背景、语义化配色、单场景单概念等最终并入视频流水线。因此本文讲解的 LaTeX 语法不是学术笔记而是 OpenMontage 数学动画生产链路中最容易被忽略、也最容易写坏的一环——公式渲染的错误往往是整段场景重渲染的根因。前置LaTeX 是 Manim 数学排版的地基Manim 本身不做数学排版它调用系统 LaTeX实际底层经过latex→dvipng或dvisvgm由 manimpango 配合排版来渲染数学表达式与格式化文本。这条规则文档开宗明义地指出Manim uses LaTeX to render mathematical expressions and formatted text.这带来三个直接推论也是后面所有实践的出发点公式文本不是普通字符串它是交给 TeX 引擎解析的源码因此必须使用原始字符串r...避免 Python 把\alpha、\frac中的反斜杠提前转义是否处于数学模式决定你写E mc^2还是$E mc^2$——这正是 MathTex 与 Tex 的关键区别机器必须装有可用的 LaTeX 发行版如 TeX Live / MiKTeX。在 OpenMontage 的 math_animate.py 中前置检查失败时会提示用户先执行pip install manim与manim checkhealth。MathTex vs Tex两种数学文本对象ManimCE 提供两个常用数学文本类规则文档用一个对照表式的描述给出定位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)两者的关键差异在仓库技能文档 SKILL.md 的对照表中被再次强调——这是 ManimCE 与 3b1b/ManimGL 最常见混淆点ManimCE 用MathTex(r\pi)而 ManimGL 写Tex(R\pi)。在 OpenMontage 的场景代码里统一遵循 ManimCE 约定from manim import *由 math_animate.py 在缺省时自动补写。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)要点上标^与下标_后跟单个字符无需花括号多个字符必须加{}例如e^{-x}、\sum_{n1}^{\infty}积分上下限\int_0^\infty、求和上下限\sum_{n1}^{\infty}都是同一套上/下标机制在不同运算符上的体现\frac{分子}{分母}是分数最常用的排版命令\sqrt{n}是根式希腊字母直接以反斜杠命令书写小写\alpha与大写\Gamma分开记忆即可。同一规则文件下仓库的完整示例 math_visualization.py 进一步演示了这类基础表达式如何进入动画Write逐笔写入、SurroundingRectangle给结论加框、LaggedStart依次揭示多段结论公式之间用.to_edge(UP)/.next_to(...)排版。公式着色把观众的注意力引到关键项数学动画最有价值的动作之一是高亮某个符号/某项。规则文档给出四条层层递进的策略。方式一set_color_by_tex字符串匹配上色最简单直接按文本子串着色。注意着色目标是 MathTex 解析后拆分出的独立SingleStringMathTex子对象按你传入的字符串片段匹配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)这里 e、i 与\pi会被分别染成红、绿、蓝正好演绎欧拉恒等式e^{iπ} 1 0中每个角色的含义。方式二substrings_to_isolate先隔离再精确着色若同一个子串在公式中多次出现例如多个 xManimCE 默认不会把每个字符都拆成独立可寻址对象直接set_color_by_tex可能命中不了预期片段。规则文档的推荐做法是在构造时就显式声明要隔离的子串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 拆为独立可索引对象随后set_color_by_tex(x, ...)即可稳定命中全部 x——这对幂级数展开、泰勒级数这类同一符号反复出现的场景至关重要。方式三构造期颜色映射tex_to_color_map除了规则文档的先建后染仓库示例 math_visualization.py 还展示了一种更声明式的等价写法——直接在构造参数里传字典映射适合在生成代码时就固定语义配色example 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在 MathTex/Tex 构造阶段完成匹配隔离与着色两步可读性更高。OpenMontage 在 manim-usage.md 中进一步将这种语义着色制度化黄色 待求解变量、红色 矩阵/算子、青色 特征向量/结果、蓝色 已知常数且要求避免红绿唯一区分兼顾色弱观众。方式四index_labels调试与直接索引当你要对公式某个位置上色时最可靠的办法是先弄清对象的索引结构。规则文档提供了两个配套手段。先给对象贴上索引标签让每个可访问片段显示自己的编号方便肉眼确认 哪一段是哪个下标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)确认下标后即可直接按下标改颜色。注意 ManimCE 的索引是二维的第一层是 MathTex 拆分出的段第二层是段内按字符拆出的更小子对象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这里eq[0]是整条 a b c未隔离时整串算一段eq[0][k]再按字符索引a、空格、、空格、b……因此0/2/4分别落在 a、b、c 上。这种隔位取字符的写法依赖空白与运算符占位规则文档明确提示要精细控制时优先显式拆分或隔离而不是赌索引位置。多段公式拆开写才有动画控制权数学动画的常见需求是公式各部分先后出现/逐个变色。ManimCE 的 MathTex 允许把一条公式作为多个字符串传入每个字符串会成为一个独立子对象eq[i]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))此时eq[0]、eq[3]、eq[6]分别对应 a、b、c索引一目了然不再需要猜字符位置。仓库示例 math_visualization.py 中的ColorCodedEquation正是这种模式的进阶用法——它不仅拆段、上色还用TransformMatchingTex完成旧公式 → 新公式的逐符号匹配变换让推导过程中不变的符号如重复的\vec{v}_1自然过渡这是视频推导场景最出效果的动画原语之一。多段写法的另一大收益在tex_to_color_map失灵时依然可控每个分段都是独立 mobject可以单独.animate.set_color(...)做动态高亮先写入整式、再逐段点亮见 math_visualization.py 中TexHighlighting的E / / m / c^2四段式教学演示。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))这段代码会渲染出 The area is A πr² 的完整一行$A \pi r^2$部分按数学模式排版其余按文本模式排版。规则文档给出的选型结论是纯数学用 MathTex混合内容用 Tex——前者省去反复写$后者把模式控制权还给你。自定义 LaTeX 宏包与模板TexTemplate默认模板只加载了 ManimCE 的常用宏包集合如 amsmath、amssymb 等。当公式需要特殊字体/符号如花体\mathscr{L}、某些扩展符号时就要自定义TexTemplate并向导言区追加宏包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本身也接受tex_environment、documentclass等参数add_to_preamble是最常用的加一行宏包入口该模板对象可以在多个公式间复用。若整份脚本都要用某个宏包更推荐放进项目级manim.cfg或统一在此规则文件外封装模板避免每个场景重复创建。从 OpenMontage 的工程化视角看math_animate.py 是每次渲染生成独立临时工作目录tempfile.mkdtemp(prefixmanim_)因此模板内联在每个场景中比依赖全局配置更符合 Agent 逐场景生成、独立可渲染的代码模型。公式对齐多行推导的标准排版多行推导是数学视频的常见形态。MathTex 的多段字符串配合align*环境的对齐符与换行符\\即可获得教科书式的等号对齐class AlignedEquations(Scene): def construct(self): eqs MathTex( ra b c \\, rd e f g \\, rh i ) self.add(eqs)声明对齐点这里放在每个等号前\\声明换行。整组多行公式仍是一个 MathTex 对象其子索引按行划分因此之后仍可以对某一行甚至某一行中的某段独立做动画。这是规则文档推荐在推导类场景中把整组公式当整体、按行/按段控制的直接依据。常用 LaTeX 数学符号速查规则文档整理了一组高频符号速查可直接照抄进 MathTex# 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)按类别记忆更高效希腊字母小写/大写、二元运算符、关系符、箭头单/双、左右、集合论符号、微积分符号。遇到未收录的符号规则文档隐含给出通用路径——先查标准 LaTeX 命令若标准命令缺失再考虑TexTemplate追加宏包。仓库示例 math_visualization.py 中出现的\begin{bmatrix}...\end{bmatrix}矩阵、\lim_{x \to 0}、\vec{v}_1、\lambda等都是这一速查的实战延伸。字号控制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构造参数在 LaTeX 排版阶段就决定字号等价于直接控制 TeX 字号适合一开始就知道公式要大的场景——数值语义上与普通 mobject 的font_size一致ManimCE 默认约为 48.scale(factor)事后方法对已渲染出的整体做几何缩放适合先排版、后根据版面调整的场景也可用在动画中如equation.animate.scale(1.5)制造强调效果。两者可混用先小字号排版、动画里放大比大字号再缩放更利于性能与视觉平滑。规则文档之外OpenMontage 的 manim-usage.md 给出的出片约定是最终素材以-qh1920×1080/60fps渲染公式Write的run_time控制在 1.5–2.0 秒——字体够大、节奏从容是数学动画可读性的两个硬指标。六大最佳实践清单将规则文档的结论与 OpenMontage 的生产经验合并得到一套可直接执行的行为准则一律使用原始字符串r...LaTeX 反斜杠命令极多普通字符串会被 Python 转义规则破坏\a、\t等会悄悄变质用r...是零成本且必须的习惯纯数学用 MathTex自动数学模式免去到处写$...$代码更干净、不易漏写分隔符图文混排用 Tex正文与$...$公式混排时把模式控制权交给 Tex为动画而拆分会被分别动效出现、变色、位移、变换的部分在构造时就拆成独立字符串参数或声明substrings_to_isolate避免事后靠脆弱的字符索引重复元素用substrings_to_isolate同一符号多次出现时构造期隔离是set_color_by_tex可靠命中的前提先index_labels后索引不确定拆分结构时先打调试标签确认下标再写eq[i]/eq[i][j]的着色代码。配合仓库的技能总纲还有一条 OpenMontage 特有的最佳实践所有数学场景都应单场景单概念、深色背景BLACK或#1a1a2e、语义化配色并让场景时长与脚本旁白对齐见 skills/creative/manim-usage.md。验证与渲染让公式代码真正跑起来规则文档本身聚焦语法但在 OpenMontage 的链路上写好的场景需要经过工具与 CLI 的双重校验环境检查先确认manim可用manim checkhealthLaTeX 组件缺失是最常见的公式渲染失败源渲染命令开发期用manim -pql scene.py MyScene低清预览出片用-qh高清输出ManimCE 质量标志-ql/-qm/-qh/-qk详见 SKILL.md 与 manim-usage.md 的规格表工具封装在 tools/graphics/math_animate.py 中Agent 生成的场景会被自动补全from manim import *写入独立临时目录后以manim命令渲染缺manim时工具会给出pip install manim与manim checkhealth的安装提示。换句话说你写的每个 MathTex 都应达到直接粘贴进一个.py文件即可用manim渲染的自洽标准——这正是该规则文档每个示例都给出完整Scene类的原因。延伸阅读本规则所属技能总纲.agents/skills/manimce-best-practices/SKILL.md含 ManimCE 与 ManimGL 差异对照、渲染质量标志、安装与常见坑配套文字排版规则.agents/skills/manimce-best-practices/rules/text.md数学可视化完整示例.agents/skills/manimce-best-practices/examples/math_visualization.pyColorCodedEquation、EquationDerivation、MatrixTransformation、IntegralVisualization、TexHighlighting等 10 个可直接运行的场景OpenMontage 数学动画生产约定skills/creative/manim-usage.mdManim 渲染工具实现tools/graphics/math_animate.py场景动画与动效相关规则.agents/skills/manimce-best-practices/rules/animations.md、.agents/skills/manimce-best-practices/rules/creation-animations.md【免费下载链接】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），仅供参考