尧图网站建设 
OpenMontage × ManimCE 变形动画实战Transform / ReplacementTransform / Morphing 全家族原理与最佳实践【免费下载链接】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 技能规则文档 transform-animations.md 为核心系统讲解 Manim Community Edition 中将一个 mobject 变形morph为另一个 mobject的动画家族Transform、ReplacementTransform、TransformFromCopy、TransformMatchingShapes、TransformMatchingTex、MoveToTarget、path_arc弧线变形与链式变形。文章会同时结合仓库源码 tools/graphics/math_animate.py 与其配套安全测试 tests/tools/test_math_animate_safety.py说明这些动画类在 OpenMontage 的数学/科学可视化管线下如何被真实调用、渲染与安全执行。读完你将能依据源对象保留与否、目标是否入场、逐形/逐公式匹配等维度为任何推导类场景精准选型并写出可运行的 ManimCE 场景代码。一、这些动画在 OpenMontage 中的角色一条独立的技能 工具链路ManimCEfrom manim import *区别于 3b1b 版manimlib/manimgl是 OpenMontage 中数学与科学可视化的推荐动画运行时。技能路由文档 animation-runtime-selector.md 的决策矩阵里针对 Mathematical / scientific visualization 明确指向两个技能.agents/skills/manim-composer与.agents/skills/manimce-best-practices。ManimCE 场景的实际执行入口是本地免费渲染工具math_animate定义在 tools/graphics/math_animate.py该工具agent_skills [manimce-best-practices, manim-composer]会在收到 Agent 生成的 Python 场景代码后若代码缺少from manim import自动在头部补上from manim import *见_render中if from manim import not in scene_code分支通过正则class\s(\w)\s*\(\s*(?:Scene|ThreeDScene|MovingCameraScene|ZoomedScene)\s*\)自动探测场景类名多场景时默认取最后一个将代码写入临时目录拼装manimCLI 命令-ql/-qm/-qh/-qk质量标志、--format gif/webm、-s截帧、--transparent、--background_color、--disable_caching等执行渲染在media/下递归定位产物并拷贝到输出路径最后用ffprobe回读分辨率、时长、码率信息。因此本规则文件中每一个变形动画类都既可以直接在独立.py文件中运行也可以作为scene_code传入math_animate工具。本文所有示例都遵循该工具的写法约定一个继承Scene、含construct()方法的类即可。二、Transform就地in-place变形Transform(source, target)会把源对象在动画过程中持续插值为目标对象的形状动画结束时源对象呈现为目标的外形。源对象自身被修改这是它与后续所有变体的根本差异。class TransformExample(Scene): def construct(self): square Square() circle Circle() self.play(Create(square)) self.play(Transform(square, circle)) # Note: square now looks like circle but is still square关键事实变形结束后变量square仍然引用原来的 mobject 对象它只是看起来像circle。从源码结构看Transform通过对源对象施加与目标匹配的点位/插值逻辑实现视觉渐变而不会把对象引用切换到目标。若后续代码对square继续操作如square.shift(...)、square.set_color(...)修改仍然生效——但请记住你在操作的是一个被改造成目标形状的源对象这在链式推导中容易造成认知负担。因此该规则文档给出的结论是Transform 适合同一个概念换个形态继续讲——例如 basic_animations.py 中的ShapeCreation场景就使用了self.play(Transform(circle, square.copy().shift(UP * 2)))把圆直接演变成移动到上方的正方形整个过程不引入第二个永久对象。三、ReplacementTransform变形的语义升级版ReplacementTransform(source, target)同样执行变形但额外做了场景对象替换源对象从场景中移除目标对象成为场景中实际存在的对象。对大多数引入新对象的需求它比Transform更符合直觉。class ReplacementTransformExample(Scene): def construct(self): square Square() circle Circle() triangle Triangle() self.play(Create(square)) self.play(ReplacementTransform(square, circle)) # square is removed, circle is now in the scene self.play(ReplacementTransform(circle, triangle)) # circle is removed, triangle is now in the scene注意这里每轮结束后变量与场景中对象才真正一致第一次变形后场景中是circle第二次变形后场景中是triangle。后续若想继续引用或改样式直接使用新的变量名即可不会踩到对象幽灵残留的坑。四、Transform vs ReplacementTransform一张对照表两种动画在变形视觉效果上几乎相同差异集中在谁还留在场景、谁真正拥有最终形态# Transform - source variable changes appearance self.play(Transform(A, B)) # A is still in scene (but looks like B) # B is NOT in scene # ReplacementTransform - source is replaced by target self.play(ReplacementTransform(A, B)) # A is removed from scene # B is now in scene选择建议你需要继续持有并操作那个新形态着色、位移、继续变形成下一形态→ 用ReplacementTransform变量语义最干净你只想让现有对象改头换面且不关心对象身份、或者源与目标本质是同一个数学实体 → 可用Transform你接下来要对该形态做销毁式收尾如FadeOut、Uncreate两种皆可但ReplacementTransform的对象归属更清晰。配套规则 animations.md 同样将两者列为最常用的变形类Transform(mob1, mob2) — Morph mob1 into mob2、ReplacementTransform(mob1, mob2) — Replace mob1 with mob2与TransformFromCopy形成去留三种语义的完整组合。五、TransformFromCopy源对象保留复制体去变形当画面里需要同时看到源对象和它的目标形态比如由旧公式推导出新公式二者并列展示时用TransformFromCopy(source, target)它复制源对象让副本变形为目标源对象原封不动地留在场景里。class TransformFromCopyExample(Scene): def construct(self): square Square().shift(LEFT * 2) circle Circle().shift(RIGHT * 2) self.add(square) self.play(TransformFromCopy(square, circle)) # Both square and circle are now visible变形结束后左侧square与右侧变形成形的circle同时在场。注意这里的入场方式circle通常需预先self.add或以其他方式注册否则某些版本组合下变形目标可能先闪现规则文档中的写法是先用self.add(square)放源对象circle作为纯目标由TransformFromCopy内部生成副本并接管最终两个对象均可见。在公式推导、比较两个表达式的讲解场景中这是保持旧内容不消失的标准手法。六、TransformMatchingShapes按形状智能配对当源与目标由多个子形状构成尤其文本TransformMatchingShapes(source, target)会尽力把形状相似/位置相近的部件互相配对再变形其余部分做淡入淡出观感远胜于整体粗暴变形。class MatchingShapesExample(Scene): def construct(self): source Text(ABC) target Text(ABCD) self.play(Write(source)) self.play(TransformMatchingShapes(source, target))这里的典型收益是ABC的三个字符作为相同字形优先原地继承新增的D以浮现方式补入而不是整行文字被打散重组。配对算法是启发式的对字形一致、数量递增/递减的文本最可靠。七、TransformMatchingTex公式推导的主力动画TransformMatchingTex(eq1, eq2)针对MathTex/Tex专项设计它按 TeX 字符串片段进行配对让推导过程中没变的部分留在原地、新增/删改的部分单独动画是数学视频中做恒等变形、展开、消元最优雅的工具。class MatchingTexExample(Scene): def construct(self): eq1 MathTex(a, ^2, , b, ^2) eq2 MathTex(a, ^2, , 2ab, , b, ^2) self.play(Write(eq1)) self.play(TransformMatchingTex(eq1, eq2))在 OpenMontage 的数学内容实践里这一动画有明确的节奏约定。manim-usage.md 的动画节奏表中将 Equation transform 列为独立条目推荐run_time1.5s、rate_funcsmooth并明确 UseTransformMatchingTexfor derivations——即公式推导一律优先使用按 TeX 片段匹配的变体避免整条公式闪烁跳变。可运行佐证见 basic_animations.py 的TextAnimations场景它用Write写出e^{i\pi} 1 0后以TransformMatchingTex(equation, expanded)变形到e^{i\pi} -1实现等号一侧保留、另一侧收敛的教科书式推导转场。八、MoveToTarget先生成目标态再统一动画MoveToTarget提供另一种变形思路不创建第二个 mobject而是先通过generate_target()让对象复制出.target占位再自由修改.target的位移、颜色、缩放最后一次性MoveToTarget把对象平滑送到预设状态。适合对象自身多项属性同时变化的场景。class MoveToTargetExample(Scene): def construct(self): square Square() self.add(square) # Generate and modify target square.generate_target() square.target.shift(RIGHT * 2) square.target.set_color(RED) square.target.scale(2) self.play(MoveToTarget(square))与直接写self.play(square.animate.shift(RIGHT*2).set_color(RED).scale(2))见 animations.md 的.animate语法相比generate_targetMoveToTarget的价值在于允许你把目标态的构建分散到若干步代码里、甚至交由计算逻辑决定最后再统一播放代码可读性更好。两套机制底层都走插值.animate适合单行链式快捷写法MoveToTarget适合目标态需要预先复杂计算的场合。九、Path Arc Transforms用 path_arc 控制变形路径默认变形沿两点间直线进行传path_arc角度后变形的运动轨迹变为一段圆弧角度用弧度表达如PI/2为 90°让画面更有飞入/环绕的动感。class PathArcExample(Scene): def construct(self): dot1 Dot(LEFT * 2) dot2 Dot(RIGHT * 2) self.add(dot1) # Transform along an arc self.play(Transform(dot1, dot2, path_arcPI/2))参数补充ManimCE 通用插值参数path_arc取正值/负值可控制弧线凸起方向沿需要时还可与path_arc_axis组合指定旋转轴。path_arc对Transform系列、MoveAlongPath、甚至.animate的移动类动画都适用是打破直线平移枯燥感的最小成本手段——规则文档 Best Practices 第 4 条即建议用它增加视觉趣味。十、Chained Transformations把同一对象连续演变成多个形态在推导演示里经常需要让一个核心对象依次变身成多个后续形态。此时用循环 单次Transform即可维持同一个对象一路演变的叙事class ChainedExample(Scene): def construct(self): shape Square() self.play(Create(shape)) # Chain of transformations for target in [Circle(), Triangle(), Star()]: self.play(Transform(shape, target)) self.wait(0.5)每次循环用同一个shape变量作为源让它依次呈现圆形、三角形、星形的外形。正因为Transform是就地修改链式场景中它天然合适——你不需要像ReplacementTransform那样在每轮循环里更新当前对象变量。若希望每段停留更久可把self.wait(0.5)调大或结合 timing.md 的节奏建议处理。十一、在 OpenMontage 中渲染这些动画math_animate 的工程化约束写好场景类后在 OpenMontage 中有两条运行路径路径 A直接用 Manim CLI本技能建议的开发方式# Preview low quality (development) manim -pql scene.py TransformExample # Preview high quality manim -pqh scene.py TransformExample # Output as GIF / check install / list plugins manim --format gif scene.py TransformExample manim checkhealth manim plugins -l注意技能面向 Manim Community 版导入用from manim import *、CLI 用manim若误装 3b1b 版manimlibmanimgl上述命令与类名会不匹配。更多 CLI/配置细节见本技能的 cli.md、config.md 与 SKILL.md。路径 B作为scene_code交给math_animate工具OpenMontage 管道内用法工具输入参数源自 math_animate.py 的input_schema核心如下参数取值/默认说明scene_code必填字符串含继承Sceneconstruct()的 Python 源码from manim import *缺失时自动补全scene_name自动探测不传时按class X(Scene/ThreeDScene/…)正则探测多类取最后一个qualitylow/medium/high/4k/preview默认medium映射到 CLI 质量标志与分辨率见下表formatmp4/gif/png/webmpng走-s截取末帧output_path可选渲染产物拷贝目标默认当前目录manim_SceneName.exttransparent/background_color布尔 / 十六进制色透明背景、自定义背景色如#1a1a2eallow_unsafe_code默认False显式放行下方安全扫描仅对完全可信代码开启工具内置质量预设QUALITY_PRESETSlow→ 854x48015fps-ql、medium→ 1280x72030fps-qm、high→ 1920x108060fps-qh、4k→ 3840x216060fps-qk、preview→-ql --format gif。OpenMontage 侧的内容实践 manim-usage.md 建议成片用-qh、草稿用-qm并保持每屏 ≤3-4 个新元素、关键揭示后wait(1.5)以上的叙事纪律。安全边界scene_code 是本地代码执行边界由于scene_code由 Agent/LLM 生成并在主机上被 Manim 真实执行工具把调用者代码视为一条本地执行边界默认执行静态安全扫描issue #219 的上下文见 math_animate.py 内注释与 test_math_animate_safety.py。扫描规则可以概括为阻断危险导入os、sys、subprocess、socket、shutil、requests、urllib、http、pickle、importlib、builtins等阻断危险内建名eval、exec、compile、__import__、open、input、globals、getattr/setattr/delattr、__builtins__等阻断反射逃逸用的双下划线属性访问仅放行__init__、__name__保证自定义 Mobject 的super().__init__(...)与偶尔取类名合法其余 dunder 一律拒绝可选allow_unsafe_codetrue显式绕过用于完全可信代码。配套测试用例提供了极具参考价值的合法与非法边界样例合法的数学场景如self.play(Create(Circle(radiusnp.pi / math.tau)))必须零告警通过而__builtins__open.read()、print.__self__.open(...)、getattr(object(), __class__)、f open; f(.env)、().__class__.__bases__[0].__subclasses__()等绕过手法都会被逐一拦截。这意味着我们在写变形动画场景时应保持纯 Manim 绘制代码的纯度——只操作 mobject 与动画类不要试图在scene_code里做文件读写、网络或进程操作。十二、Best Practices何时用哪一个规则文档 transform-animations.md 给出四条铁律这里结合全篇做一张速查表需求首选理由变量语义清晰、目标真正入场ReplacementTransform源移除、目标接管后续操作变量名与场景一致需要新旧两个对象同屏可见TransformFromCopy源保留副本去变成目标形态公式/恒等式推导LaTeXTransformMatchingTex按 TeX 片段配对保留不动部分run_time建议 1.5s文本/形状部件对应关系明显TransformMatchingShapes按字形/形状启发式配对对象多属性同时走向预设终态MoveToTargetgenerate_target().target自由构建让变形轨迹更生动path_arc…直线变弧线正负控制凸起方向同一对象连续变身多次循环 Transform就地修改天然适配链式叙事单个对象的简单位移/缩放/变色.animate一行链式最简表达见 animations.md规则原文四条最佳实践完整如下Use ReplacementTransform for clarity—— 变量行为更直观默认优先选它Use TransformFromCopy to preserve original—— 需要源与目标同屏时使用Use TransformMatchingTex for equations—— 公式推导用 TeX 片段匹配对齐度最好Set path_arc for visual interest—— 弧线路径比直线更富动态。再叠加创作纪律使用 manim-usage.md 的节奏推导run_time≈1.5s、平滑缓动、揭示后留白1.0-2.0s并先Create/Write让源对象入场、再触发变形就能在 OpenMontage 的math_animate管道中产出流畅、可复现的数学可视化镜头。十三、常见误区速查误把Transform当ReplacementTransformTransform(A, B)后场景中并没有真正的 B只有长得像 B 的 A若要引用目标做后续操作请换ReplacementTransform。忘记导入独立运行时文件需from manim import *走math_animate工具时缺失会被自动补全无需担心。在scene_code里做非绘制操作会被 math_animate.py 的静态安全扫描拦截默认配置保持场景代码纯 Manim。套用 ManimGL 教程ManimCE本技能主题与 3b1b/ManimGLmanimlib/manimgl仓库另设.claude/skills/manimgl-best-practices/等技能树API 与 CLI 均不同示例代码需对应正确的运行时。掌握上述选择逻辑后无论是要演示圆 → 方的最小变形还是完成整屏公式的逐步推导都可以直接复用本仓库技能文件中的代码骨架在 math_animate 下快速渲染验证。【免费下载链接】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 变形动画实战：Transform / ReplacementTransform / Morphing 全家族原理与最佳实践
OpenMontage × ManimCE 变形动画实战Transform / ReplacementTransform / Morphing 全家族原理与最佳实践【免费下载链接】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 技能规则文档 transform-animations.md 为核心系统讲解 Manim Community Edition 中将一个 mobject 变形morph为另一个 mobject的动画家族Transform、ReplacementTransform、TransformFromCopy、TransformMatchingShapes、TransformMatchingTex、MoveToTarget、path_arc弧线变形与链式变形。文章会同时结合仓库源码 tools/graphics/math_animate.py 与其配套安全测试 tests/tools/test_math_animate_safety.py说明这些动画类在 OpenMontage 的数学/科学可视化管线下如何被真实调用、渲染与安全执行。读完你将能依据源对象保留与否、目标是否入场、逐形/逐公式匹配等维度为任何推导类场景精准选型并写出可运行的 ManimCE 场景代码。一、这些动画在 OpenMontage 中的角色一条独立的技能 工具链路ManimCEfrom manim import *区别于 3b1b 版manimlib/manimgl是 OpenMontage 中数学与科学可视化的推荐动画运行时。技能路由文档 animation-runtime-selector.md 的决策矩阵里针对 Mathematical / scientific visualization 明确指向两个技能.agents/skills/manim-composer与.agents/skills/manimce-best-practices。ManimCE 场景的实际执行入口是本地免费渲染工具math_animate定义在 tools/graphics/math_animate.py该工具agent_skills [manimce-best-practices, manim-composer]会在收到 Agent 生成的 Python 场景代码后若代码缺少from manim import自动在头部补上from manim import *见_render中if from manim import not in scene_code分支通过正则class\s(\w)\s*\(\s*(?:Scene|ThreeDScene|MovingCameraScene|ZoomedScene)\s*\)自动探测场景类名多场景时默认取最后一个将代码写入临时目录拼装manimCLI 命令-ql/-qm/-qh/-qk质量标志、--format gif/webm、-s截帧、--transparent、--background_color、--disable_caching等执行渲染在media/下递归定位产物并拷贝到输出路径最后用ffprobe回读分辨率、时长、码率信息。因此本规则文件中每一个变形动画类都既可以直接在独立.py文件中运行也可以作为scene_code传入math_animate工具。本文所有示例都遵循该工具的写法约定一个继承Scene、含construct()方法的类即可。二、Transform就地in-place变形Transform(source, target)会把源对象在动画过程中持续插值为目标对象的形状动画结束时源对象呈现为目标的外形。源对象自身被修改这是它与后续所有变体的根本差异。class TransformExample(Scene): def construct(self): square Square() circle Circle() self.play(Create(square)) self.play(Transform(square, circle)) # Note: square now looks like circle but is still square关键事实变形结束后变量square仍然引用原来的 mobject 对象它只是看起来像circle。从源码结构看Transform通过对源对象施加与目标匹配的点位/插值逻辑实现视觉渐变而不会把对象引用切换到目标。若后续代码对square继续操作如square.shift(...)、square.set_color(...)修改仍然生效——但请记住你在操作的是一个被改造成目标形状的源对象这在链式推导中容易造成认知负担。因此该规则文档给出的结论是Transform 适合同一个概念换个形态继续讲——例如 basic_animations.py 中的ShapeCreation场景就使用了self.play(Transform(circle, square.copy().shift(UP * 2)))把圆直接演变成移动到上方的正方形整个过程不引入第二个永久对象。三、ReplacementTransform变形的语义升级版ReplacementTransform(source, target)同样执行变形但额外做了场景对象替换源对象从场景中移除目标对象成为场景中实际存在的对象。对大多数引入新对象的需求它比Transform更符合直觉。class ReplacementTransformExample(Scene): def construct(self): square Square() circle Circle() triangle Triangle() self.play(Create(square)) self.play(ReplacementTransform(square, circle)) # square is removed, circle is now in the scene self.play(ReplacementTransform(circle, triangle)) # circle is removed, triangle is now in the scene注意这里每轮结束后变量与场景中对象才真正一致第一次变形后场景中是circle第二次变形后场景中是triangle。后续若想继续引用或改样式直接使用新的变量名即可不会踩到对象幽灵残留的坑。四、Transform vs ReplacementTransform一张对照表两种动画在变形视觉效果上几乎相同差异集中在谁还留在场景、谁真正拥有最终形态# Transform - source variable changes appearance self.play(Transform(A, B)) # A is still in scene (but looks like B) # B is NOT in scene # ReplacementTransform - source is replaced by target self.play(ReplacementTransform(A, B)) # A is removed from scene # B is now in scene选择建议你需要继续持有并操作那个新形态着色、位移、继续变形成下一形态→ 用ReplacementTransform变量语义最干净你只想让现有对象改头换面且不关心对象身份、或者源与目标本质是同一个数学实体 → 可用Transform你接下来要对该形态做销毁式收尾如FadeOut、Uncreate两种皆可但ReplacementTransform的对象归属更清晰。配套规则 animations.md 同样将两者列为最常用的变形类Transform(mob1, mob2) — Morph mob1 into mob2、ReplacementTransform(mob1, mob2) — Replace mob1 with mob2与TransformFromCopy形成去留三种语义的完整组合。五、TransformFromCopy源对象保留复制体去变形当画面里需要同时看到源对象和它的目标形态比如由旧公式推导出新公式二者并列展示时用TransformFromCopy(source, target)它复制源对象让副本变形为目标源对象原封不动地留在场景里。class TransformFromCopyExample(Scene): def construct(self): square Square().shift(LEFT * 2) circle Circle().shift(RIGHT * 2) self.add(square) self.play(TransformFromCopy(square, circle)) # Both square and circle are now visible变形结束后左侧square与右侧变形成形的circle同时在场。注意这里的入场方式circle通常需预先self.add或以其他方式注册否则某些版本组合下变形目标可能先闪现规则文档中的写法是先用self.add(square)放源对象circle作为纯目标由TransformFromCopy内部生成副本并接管最终两个对象均可见。在公式推导、比较两个表达式的讲解场景中这是保持旧内容不消失的标准手法。六、TransformMatchingShapes按形状智能配对当源与目标由多个子形状构成尤其文本TransformMatchingShapes(source, target)会尽力把形状相似/位置相近的部件互相配对再变形其余部分做淡入淡出观感远胜于整体粗暴变形。class MatchingShapesExample(Scene): def construct(self): source Text(ABC) target Text(ABCD) self.play(Write(source)) self.play(TransformMatchingShapes(source, target))这里的典型收益是ABC的三个字符作为相同字形优先原地继承新增的D以浮现方式补入而不是整行文字被打散重组。配对算法是启发式的对字形一致、数量递增/递减的文本最可靠。七、TransformMatchingTex公式推导的主力动画TransformMatchingTex(eq1, eq2)针对MathTex/Tex专项设计它按 TeX 字符串片段进行配对让推导过程中没变的部分留在原地、新增/删改的部分单独动画是数学视频中做恒等变形、展开、消元最优雅的工具。class MatchingTexExample(Scene): def construct(self): eq1 MathTex(a, ^2, , b, ^2) eq2 MathTex(a, ^2, , 2ab, , b, ^2) self.play(Write(eq1)) self.play(TransformMatchingTex(eq1, eq2))在 OpenMontage 的数学内容实践里这一动画有明确的节奏约定。manim-usage.md 的动画节奏表中将 Equation transform 列为独立条目推荐run_time1.5s、rate_funcsmooth并明确 UseTransformMatchingTexfor derivations——即公式推导一律优先使用按 TeX 片段匹配的变体避免整条公式闪烁跳变。可运行佐证见 basic_animations.py 的TextAnimations场景它用Write写出e^{i\pi} 1 0后以TransformMatchingTex(equation, expanded)变形到e^{i\pi} -1实现等号一侧保留、另一侧收敛的教科书式推导转场。八、MoveToTarget先生成目标态再统一动画MoveToTarget提供另一种变形思路不创建第二个 mobject而是先通过generate_target()让对象复制出.target占位再自由修改.target的位移、颜色、缩放最后一次性MoveToTarget把对象平滑送到预设状态。适合对象自身多项属性同时变化的场景。class MoveToTargetExample(Scene): def construct(self): square Square() self.add(square) # Generate and modify target square.generate_target() square.target.shift(RIGHT * 2) square.target.set_color(RED) square.target.scale(2) self.play(MoveToTarget(square))与直接写self.play(square.animate.shift(RIGHT*2).set_color(RED).scale(2))见 animations.md 的.animate语法相比generate_targetMoveToTarget的价值在于允许你把目标态的构建分散到若干步代码里、甚至交由计算逻辑决定最后再统一播放代码可读性更好。两套机制底层都走插值.animate适合单行链式快捷写法MoveToTarget适合目标态需要预先复杂计算的场合。九、Path Arc Transforms用 path_arc 控制变形路径默认变形沿两点间直线进行传path_arc角度后变形的运动轨迹变为一段圆弧角度用弧度表达如PI/2为 90°让画面更有飞入/环绕的动感。class PathArcExample(Scene): def construct(self): dot1 Dot(LEFT * 2) dot2 Dot(RIGHT * 2) self.add(dot1) # Transform along an arc self.play(Transform(dot1, dot2, path_arcPI/2))参数补充ManimCE 通用插值参数path_arc取正值/负值可控制弧线凸起方向沿需要时还可与path_arc_axis组合指定旋转轴。path_arc对Transform系列、MoveAlongPath、甚至.animate的移动类动画都适用是打破直线平移枯燥感的最小成本手段——规则文档 Best Practices 第 4 条即建议用它增加视觉趣味。十、Chained Transformations把同一对象连续演变成多个形态在推导演示里经常需要让一个核心对象依次变身成多个后续形态。此时用循环 单次Transform即可维持同一个对象一路演变的叙事class ChainedExample(Scene): def construct(self): shape Square() self.play(Create(shape)) # Chain of transformations for target in [Circle(), Triangle(), Star()]: self.play(Transform(shape, target)) self.wait(0.5)每次循环用同一个shape变量作为源让它依次呈现圆形、三角形、星形的外形。正因为Transform是就地修改链式场景中它天然合适——你不需要像ReplacementTransform那样在每轮循环里更新当前对象变量。若希望每段停留更久可把self.wait(0.5)调大或结合 timing.md 的节奏建议处理。十一、在 OpenMontage 中渲染这些动画math_animate 的工程化约束写好场景类后在 OpenMontage 中有两条运行路径路径 A直接用 Manim CLI本技能建议的开发方式# Preview low quality (development) manim -pql scene.py TransformExample # Preview high quality manim -pqh scene.py TransformExample # Output as GIF / check install / list plugins manim --format gif scene.py TransformExample manim checkhealth manim plugins -l注意技能面向 Manim Community 版导入用from manim import *、CLI 用manim若误装 3b1b 版manimlibmanimgl上述命令与类名会不匹配。更多 CLI/配置细节见本技能的 cli.md、config.md 与 SKILL.md。路径 B作为scene_code交给math_animate工具OpenMontage 管道内用法工具输入参数源自 math_animate.py 的input_schema核心如下参数取值/默认说明scene_code必填字符串含继承Sceneconstruct()的 Python 源码from manim import *缺失时自动补全scene_name自动探测不传时按class X(Scene/ThreeDScene/…)正则探测多类取最后一个qualitylow/medium/high/4k/preview默认medium映射到 CLI 质量标志与分辨率见下表formatmp4/gif/png/webmpng走-s截取末帧output_path可选渲染产物拷贝目标默认当前目录manim_SceneName.exttransparent/background_color布尔 / 十六进制色透明背景、自定义背景色如#1a1a2eallow_unsafe_code默认False显式放行下方安全扫描仅对完全可信代码开启工具内置质量预设QUALITY_PRESETSlow→ 854x48015fps-ql、medium→ 1280x72030fps-qm、high→ 1920x108060fps-qh、4k→ 3840x216060fps-qk、preview→-ql --format gif。OpenMontage 侧的内容实践 manim-usage.md 建议成片用-qh、草稿用-qm并保持每屏 ≤3-4 个新元素、关键揭示后wait(1.5)以上的叙事纪律。安全边界scene_code 是本地代码执行边界由于scene_code由 Agent/LLM 生成并在主机上被 Manim 真实执行工具把调用者代码视为一条本地执行边界默认执行静态安全扫描issue #219 的上下文见 math_animate.py 内注释与 test_math_animate_safety.py。扫描规则可以概括为阻断危险导入os、sys、subprocess、socket、shutil、requests、urllib、http、pickle、importlib、builtins等阻断危险内建名eval、exec、compile、__import__、open、input、globals、getattr/setattr/delattr、__builtins__等阻断反射逃逸用的双下划线属性访问仅放行__init__、__name__保证自定义 Mobject 的super().__init__(...)与偶尔取类名合法其余 dunder 一律拒绝可选allow_unsafe_codetrue显式绕过用于完全可信代码。配套测试用例提供了极具参考价值的合法与非法边界样例合法的数学场景如self.play(Create(Circle(radiusnp.pi / math.tau)))必须零告警通过而__builtins__open.read()、print.__self__.open(...)、getattr(object(), __class__)、f open; f(.env)、().__class__.__bases__[0].__subclasses__()等绕过手法都会被逐一拦截。这意味着我们在写变形动画场景时应保持纯 Manim 绘制代码的纯度——只操作 mobject 与动画类不要试图在scene_code里做文件读写、网络或进程操作。十二、Best Practices何时用哪一个规则文档 transform-animations.md 给出四条铁律这里结合全篇做一张速查表需求首选理由变量语义清晰、目标真正入场ReplacementTransform源移除、目标接管后续操作变量名与场景一致需要新旧两个对象同屏可见TransformFromCopy源保留副本去变成目标形态公式/恒等式推导LaTeXTransformMatchingTex按 TeX 片段配对保留不动部分run_time建议 1.5s文本/形状部件对应关系明显TransformMatchingShapes按字形/形状启发式配对对象多属性同时走向预设终态MoveToTargetgenerate_target().target自由构建让变形轨迹更生动path_arc…直线变弧线正负控制凸起方向同一对象连续变身多次循环 Transform就地修改天然适配链式叙事单个对象的简单位移/缩放/变色.animate一行链式最简表达见 animations.md规则原文四条最佳实践完整如下Use ReplacementTransform for clarity—— 变量行为更直观默认优先选它Use TransformFromCopy to preserve original—— 需要源与目标同屏时使用Use TransformMatchingTex for equations—— 公式推导用 TeX 片段匹配对齐度最好Set path_arc for visual interest—— 弧线路径比直线更富动态。再叠加创作纪律使用 manim-usage.md 的节奏推导run_time≈1.5s、平滑缓动、揭示后留白1.0-2.0s并先Create/Write让源对象入场、再触发变形就能在 OpenMontage 的math_animate管道中产出流畅、可复现的数学可视化镜头。十三、常见误区速查误把Transform当ReplacementTransformTransform(A, B)后场景中并没有真正的 B只有长得像 B 的 A若要引用目标做后续操作请换ReplacementTransform。忘记导入独立运行时文件需from manim import *走math_animate工具时缺失会被自动补全无需担心。在scene_code里做非绘制操作会被 math_animate.py 的静态安全扫描拦截默认配置保持场景代码纯 Manim。套用 ManimGL 教程ManimCE本技能主题与 3b1b/ManimGLmanimlib/manimgl仓库另设.claude/skills/manimgl-best-practices/等技能树API 与 CLI 均不同示例代码需对应正确的运行时。掌握上述选择逻辑后无论是要演示圆 → 方的最小变形还是完成整屏公式的逐步推导都可以直接复用本仓库技能文件中的代码骨架在 math_animate 下快速渲染验证。【免费下载链接】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），仅供参考