Manim Mobjects 完全参考：用代码构建数学动画的每一个可见元素

AI 技能/插件音视频视频处理人工智能【免费下载链接】video-useEdit videos with coding agents项目地址https://gitcode.com/GitHub_Trending/vid/video-use点击查看免费下载本篇技术指南围绕video-use仓库中 manim-video 技能包的 Mobjects 参考文档展开系统讲解 Manim Community Edition 中所有屏幕上可见的东西——从文本、几何形状到矩阵、SVG 与自定义复合对象。读完本文你将掌握 Mobjects 的完整类型体系、定位与分组规则、样式控制方法以及如何在数学/技术动画制作管线中正确组合它们直接服务于 3Blue1Brown 风格的讲解视频生产流程。什么是 Mobject一切可见元素的基类Mobjects 是 Manim 中所有可见对象的统称Mobject是它们的基类。屏幕上的一切——文字、圆、坐标轴、图片、公式——都是 Mobject。它们拥有三个核心属性位置position通过move_to、next_to、to_edge等定位方法控制颜色color通过set_color、set_fill、set_stroke等样式方法控制透明度opacity通过set_opacity控制用于实现不透明度分层的视觉注意力引导。此外所有 Mobject 都可以被动画化self.play(...)这也正是 Manim 区别于静态绘图库的根本所在。在video-use的 manim-video 技能体系中Mobjects 是所有场景的建筑材料。SKILL.md 中明确将架构图模式Architecture diagram的参考文档指向 mobjects.md可见本参考文档正是搭建系统架构图、复合图形与数据可视化场景的核心知识源。文本类 MobjectsText / MathTex / Tex / MarkupText文本是讲解视频中最常用的 MobjectManim 提供四类文本对象title Text(Hello World, font_size48, colorBLUE) eq MathTex(rE mc^2, font_size40) # 多片段拆分用于选择性着色 eq MathTex(ra^2, r, rb^2, r, rc^2) eq[0].set_color(RED) eq[4].set_color(BLUE) # 文本与数学混排 t Tex(rThe area is $\pi r^2$, font_size36) # 富文本标记Pango 标记语言 t MarkupText(span foreground#58C4DDBlue/span text, font_size30)各类型的适用场景类型渲染引擎典型用途TextPango普通文本、标题、标签MathTexLaTeX数学公式amsmath默认加载TexLaTeX文本与公式混排MarkupTextPango 标记富文本局部颜色、加粗、字距强制规则任何包含反斜杠的字符串必须使用原始字符串r。这是 SKILL.md 中 Critical Implementation Notes 反复强调的第一条铁律MathTex(r\frac{1}{2})是正确的而MathTex(\frac{1}{2})会因 Python 转义字符导致渲染错误。文本的字体与字号规范结合 visual-design.md 的排版规范项目中为文本建立了严格的字体约定默认使用等宽字体MenlomacOS 预装Linux 回退到 DejaVu Sans Mono。原因是 Manim 的 Pango 渲染器在比例字体Helvetica、Inter、Arial下会产生破损的字距kerning这是 Pango 本身的限制而非 Manim 的 bug。数学公式一律用MathTex走 LaTeX 渲染不经过 Pango。最小字号font_size18低于 18 在-ql草稿分辨率下会模糊即使-qh生产分辨率也几乎不可读。MONO Menlo # 在文件顶部定义一次全局复用 Text(Fourier Series, font_size48, colorPRIMARY, weightBOLD, fontMONO) # 标题 Text(n1: sin(x), font_size20, colorBLUE, fontMONO) # 标签MarkupText还支持 Pango 属性实现Text()不具备的精细控制如letter_spacing单位 1/1024 pointMarkupText(span letter_spacing6000HERMES/span, font_size18, fontMenlo) MarkupText(This is bimportant/b, font_size24, fontMenlo) MarkupText(Red span foreground#FF6B6Bwarning/span, font_size24, fontMenlo)基础形状Circle / Square / Rectangle / Dot / Line / Arrow几何形状是动画的主体所有基础形状都支持color与fill_opacity参数circle Circle(radius1, colorBLUE, fill_opacity0.5) square Square(side_length2, colorRED) rect Rectangle(width4, height2, colorGREEN) dot Dot(pointORIGIN, radius0.08, colorYELLOW) line Line(LEFT * 2, RIGHT * 2, colorWHITE) arrow Arrow(LEFT, RIGHT, colorORANGE) rrect RoundedRectangle(corner_radius0.3, width4, height2) brace Brace(rect, DOWN, colorYELLOW)几个值得注意的参数语义Circle(radius...)控制半径Square(side_length...)控制边长Rectangle(width..., height...)分别控制宽高Dot是一个小圆点常用于标记坐标点、数据点或粒子Line(start, end)接受两个点坐标Arrow(start, end)自动带箭头Brace(mobject, direction)生成花括号方向参数取DOWN/UP/LEFT/RIGHT常与get_text()配合做标注详见 decorations.md。多边形与圆弧Polygon / RegularPolygon / Arc# 任意顶点多边形 poly Polygon(LEFT, UP * 2, RIGHT, colorGREEN, fill_opacity0.3) # 正 n 边形 hexagon RegularPolygon(n6, colorTEAL, fill_opacity0.4) # 三角形RegularPolygon(n3) 的简写 tri Triangle(colorYELLOW, fill_opacity0.5) # 圆弧圆的一部分 arc Arc(radius2, start_angle0, anglePI / 2, colorBLUE) # 两点之间的圆弧 arc_between ArcBetweenPoints(LEFT * 2, RIGHT * 2, angleTAU / 4, colorRED) # 曲线箭头带箭头的弧 curved_arrow CurvedArrow(LEFT * 2, RIGHT * 2, colorORANGE)注意区分三个角度参数Arc(start_angle...)圆弧起始角度相对 x 轴正方向Arc(angle...)圆弧扫过的角度PI/2即 90°TAU即一整圈ArcBetweenPoints/CurvedArrow的angle由两点确定弦后弧线弯曲的程度。扇形与环Sector / Annulus / AnnularSector / Cutout# 扇形饼图切片 sector Sector(outer_radius2, start_angle0, anglePI / 3, fill_opacity0.7, colorBLUE) # 圆环环带 ring Annulus(inner_radius1, outer_radius2, fill_opacity0.5, colorGREEN) # 环形扇区部分圆环 partial_ring AnnularSector( inner_radius1, outer_radius2, anglePI / 2, start_angle0, fill_opacity0.7, colorTEAL ) # 镂空在形状上打洞 background Square(side_length4, fill_opacity1, colorBLUE) hole Circle(radius0.5) cutout Cutout(background, hole, fill_opacity1, colorBLUE)这一组的典型应用场景饼图、环形进度指示器、用弧线绘制的韦恩图、几何证明。Cutout是制作挖洞遮罩的有效手段——用一个带洞的实心背景实现取景框或聚光灯效果。定位系统move_to / next_to / to_edge / to_cornerManim 的坐标以屏幕中心为原点config.frame_width 14.222、config.frame_height 8.0详见常量一节。定位方法如下mob.move_to(ORIGIN) # 居中 mob.move_to(UP * 2 RIGHT) # 相对坐标上方 2 单位 右侧 1 单位 label.next_to(circle, DOWN, buff0.3) # 紧贴另一个对象的指定侧 title.to_edge(UP, buff0.5) # 贴屏幕边缘buff 0.5 mob.to_corner(UL, buff0.5) # 贴屏幕角落两个易错点to_edge的buff参数不要小于 0.5。这是 SKILL.md 中明确列出的实现注意项贴边文本过近会导致内容被裁剪或在-ql分辨率下溢出。next_to(mob, direction, buff...)的方向是相对于参照对象的UP/DOWN/LEFT/RIGHT以及斜向UR/UL/DR/DL均可用。方向常量UP, DOWN, LEFT, RIGHT, ORIGIN, UL, UR, DL, DR可以直接参与向量运算例如UP * 2 RIGHT表示上移 2 个单位再右移 1 个单位这正是 Manim 位置表达式的核心写法。VGroup 与 Group分组的正确选择分组是组织复杂场景的关键但两种分组容器有严格的适用边界# VGroup —— 仅限 VMobjectCircle、Square、Arrow、Line、MathTex 等矢量对象 shapes VGroup(circle, square, arrow) shapes.arrange(DOWN, buff0.5) shapes.set_color(BLUE) # Group —— 混合集合Text 形状或任意 Mobject 类型 labeled_shape Group(circle, Text(Label).next_to(circle, DOWN)) labeled_shape.move_to(ORIGIN) # 淡出屏幕上所有对象可能包含混合类型 self.play(FadeOut(Group(*self.mobjects)))核心规则分组内只要包含任何Text()对象就必须用Group不能用VGroup。原因在于 Manim CE v0.20 中VGroup只接受VMobjectText是Mobject而非VMobject混入会直接抛出TypeError。而MathTex和Tex属于VMobject可以安全放进VGroup。两种容器共同支持的操作arrange()、arrange_in_grid()、set_opacity()、shift()、scale()、move_to()。arrange_in_grid()与 visual-design.md 中 GRID 布局模板比较矩阵、多步骤流程直接对应。实战要点场景结尾清理屏幕的标准写法FadeOut(Group(*self.mobjects))SKILL.md 中 Clean exits 模式正是利用了Group对混合类型的兼容性——屏幕上通常同时存在标题、图形、公式类型混杂。样式控制set_color / set_fill / set_stroke / set_opacity / set_z_indexmob.set_color(BLUE) mob.set_fill(RED, opacity0.5) mob.set_stroke(WHITE, width2) mob.set_opacity(0.4) mob.set_z_index(1) # 层叠顺序样式方法与不透明度分层设计原则紧密配合visual-design.md主元素PRIMARY透明度 1.0用于当前焦点内容上下文元素CONTEXT透明度 0.4用于辅助说明结构元素axes、grids透明度 0.15用于背景参照。set_z_index控制对象在屏幕上的叠放顺序数值越大越靠前是处理标签盖在图形上图形盖在网格上等场景的关键参数。专用 MobjectsNumberLine / Table / Code / SurroundingRectangle / BackgroundRectanglenl NumberLine(x_range[-3, 3, 1], length8, include_numbersTrue) table Table([[A, B], [C, D]], row_labels[Text(R1), Text(R2)]) code Code(example.py, tab_width4, font_size20, languagepython) highlight SurroundingRectangle(target, colorYELLOW, buff0.2) bg BackgroundRectangle(equation, fill_opacity0.7, buff0.2)逐个说明NumberLine数轴x_range[起点, 终点, 步长]include_numbersTrue自动标数字。更完整的数轴用法配合指针与ValueTracker的实时标注见 graphs-and-data.md。Table表格注意行/列标签中若使用Text该Table内部即含Mobject分组时需用Group。Code代码块languagepython指定语法高亮tab_width控制缩进宽度。SurroundingRectangle高亮框是 decorations.md 中标注体系的核心工具可配合buff、corner_radius、stroke_width微调还能对MathTex的局部片段如eq[2:]画框。BackgroundRectangle为公式提供半透明底衬提高复杂背景下的可读性但在图形/图表上方标注文字时项目更推荐set_stroke(backgroundTrue)方案见后文Backstroke。自定义 Mobjects面向对象的组合复用当内置对象无法满足需求时通过继承Group或VMobject自定义复合 Mobject。原文档给出的示例是网络节点class NetworkNode(Group): def __init__(self, label_text, colorBLUE, **kwargs): super().__init__(**kwargs) self.circle Circle(radius0.4, colorcolor, fill_opacity0.3) self.label Text(label_text, font_size20).move_to(self.circle) self.add(self.circle, self.label)要点分析因为内部包含Text基类选择Group而非VGroup避免TypeError**kwargs透传给父类构造器使外部仍可传z_index等通用参数self.add(...)把子对象注册进容器随后整个NetworkNode可以整体move_to、animate、FadeIn。自定义 Mobject 与 SKILL.md 的单脚本多场景模式天然契合把可复用的复合图形节点、卡片、流程图块定义为类多个场景共享保证场景间视觉语言一致。矩阵 MobjectsIntegerMatrix / DecimalMatrix / MobjectMatrix矩阵在数学动画中高频出现Manim 提供了三个专用 Mobject 以网格形式展示数字或对象# 整数矩阵 m IntegerMatrix([[1, 2], [3, 4]]) # 小数矩阵控制小数位数 m DecimalMatrix([[1.5, 2.7], [3.1, 4.9]], element_to_mobject_config{num_decimal_places: 2}) # Mobject 矩阵每个格子放任意 Mobject m MobjectMatrix([ [MathTex(r\pi), MathTex(re)], [MathTex(r\phi), MathTex(r\tau)] ]) # 括号类型( [ | 或 \\{ m IntegerMatrix([[1, 0], [0, 1]], left_bracket[, right_bracket])参数说明element_to_mobject_config是传给内部数字元素的配置字典num_decimal_places控制小数点后位数left_bracket/right_bracket支持(、[、|和\\{注意需写成原始字符串形式。应用场景线性代数、变换矩阵、方程组的系数矩阵展示。需要逐元素动画或逐格着色时使用矩阵 Mobject而不是MathTex的 LaTeX matrix 环境正如 equations.md 所指出的\begin{bmatrix}等 LaTeX 环境适合静态整体展示而逐格控制必须用IntegerMatrix/DecimalMatrix/MobjectMatrix。常量速查# 方向 UP, DOWN, LEFT, RIGHT, ORIGIN, UL, UR, DL, DR # 颜色 RED, BLUE, GREEN, YELLOW, WHITE, GRAY, ORANGE, PINK, PURPLE, TEAL, GOLD # 画布尺寸默认帧 config.frame_width 14.222 config.frame_height 8.0颜色常量直接来自 Manim 内置调色板visual-design.md 进一步给出了四套完整场景配色方案Classic 3B1B、Warm academic、Neon tech、Monochrome其中 Classic 3B1B 的主色#58C4DD正是文档 MarkupText 示例中使用的青色。SVGMobject导入矢量图形logo SVGMobject(path/to/logo.svg) logo.set_color(WHITE).scale(0.5).to_corner(UR) self.play(FadeIn(logo)) # SVG 子对象可以单独动画 for part in logo.submobjects: self.play(part.animate.set_color(random_color()))关键特性SVGMobject支持链式调用set_color().scale().to_corner()一步完成着色、缩放与定位SVG 是矢量格式其submobjects可逐个访问——这对 Logo 逐部件变色、架构图中逐模块点亮非常有用配合random_color()需要from manim import random_color可以做出多彩渐变效果。ImageMobject显示位图img ImageMobject(screenshot.png) img.set_height(3).to_edge(RIGHT) self.play(FadeIn(img))重要限制位图不能用.animate做形变动画它们不是矢量无法插值变形。只应使用FadeIn/FadeOut以及shift/scale这类不改变几何拓扑的操作。Variable自动更新的数值显示var Variable(0, Text(x), num_decimal_places2) var.move_to(ORIGIN) self.add(var) # 动画化数值 self.play(var.tracker.animate.set_value(5), run_time2) # 显示自动更新为 x 5.00Variable内部封装了一个ValueTracker通过var.tracker访问值变化时文本自动刷新。相比手动DecimalNumberadd_updater的方案Variable是带标签数值显示的更简洁替代。动态数值场景的完整能力ValueTracker、add_updater、always_redraw可进一步参考 updaters-and-trackers.md 与 animations.md。BulletedList逐条呈现的要点列表bullets BulletedList( First key point, Second important fact, Third conclusion, font_size28 ) bullets.to_edge(LEFT, buff1.0) self.play(Write(bullets)) # 高亮单个条目 self.play(bullets[1].animate.set_color(YELLOW))BulletedList的每条目是独立子对象支持按下标访问bullets[1]因此可以逐条Write、逐条高亮——非常适合 visual-design.md 中的 PROGRESSIVE 布局要点自上而下逐步出现。DashedLine 与角度标记# 虚线渐近线、辅助线 dashed DashedLine(LEFT * 3, RIGHT * 3, colorSUBTLE, dash_length0.15) # 两条线之间的角度标记 line1 Line(ORIGIN, RIGHT * 2) line2 Line(ORIGIN, UP * 2 RIGHT) angle Angle(line1, line2, radius0.5, colorYELLOW) angle_label angle.get_value() # 返回弧度值 # 直角标记 right_angle RightAngle(line1, Line(ORIGIN, UP * 2), length0.3, colorWHITE)注意DashedLine的dash_length控制每段虚线的长度SUBTLE是适合辅助线的低存在感颜色结构元素透明度层级Angle.get_value()返回两条线夹角的弧度值可直接用于生成文字标签RightAngle绘制几何证明中经典的小直角方块标记。更多标注组合Cross、Underline、DashedVMobject等见 decorations.md。布尔运算CSGUnion / Intersection / Difference / Exclusion对二维形状进行并、交、差、异或circle Circle(radius1.5, colorBLUE, fill_opacity0.5).shift(LEFT * 0.5) square Square(side_length2, colorRED, fill_opacity0.5).shift(RIGHT * 0.5) # 并集、交集、差集、异或 union Union(circle, square, colorGREEN, fill_opacity0.5) intersect Intersection(circle, square, colorYELLOW, fill_opacity0.5) diff Difference(circle, square, colorPURPLE, fill_opacity0.5) exclude Exclusion(circle, square, colorORANGE, fill_opacity0.5)四种运算的语义运算结果Union两者覆盖的全部区域Intersection两者重叠区域Difference(A, B)A 减去与 B 重叠的部分Exclusion重叠区之外的两者区域每个运算都支持传入新形状的color与fill_opacity。应用场景韦恩图、集合论演示、几何证明、面积计算。结合前文Arc/ArcBetweenPoints的用弧线画韦恩图能力可以构建完整的集合可视化。LabeledArrow / LabeledLine自带标签的连线# 带内置标签的箭头自动定位标签 arr LabeledArrow(Text(force, font_size18), startLEFT, endRIGHT, colorRED) # 带标签的线段 line LabeledLine(Text(d 5m, font_size18), startLEFT * 2, endRIGHT * 2)标签位置由 Manim 自动处理比手动ArrowText().next_to()组合更干净。这在物理/力学图中标注力向量、距离等场景非常实用。逐子串文本控制t2c / t2f / t2s / t2w一个Text对象内对不同子串施加颜色、字体、斜体与字重# 逐词着色t2c text-to-color text Text( Gradient descent minimizes the loss function, t2c{Gradient descent: BLUE, loss function: RED} ) # 逐词换字体t2f text-to-font text Text( Use Menlo for code and Inter for prose, t2f{Menlo: Menlo, Inter: Inter} ) # 逐词斜体t2s text-to-slant text Text(Normal and italic text, t2s{italic: ITALIC}) # 逐词加粗t2w text-to-weight text Text(Normal and bold text, t2w{bold: BOLD})四个参数的语义对照参数含义示例键值t2ctext-to-color{gradient: BLUE}t2ftext-to-font{Menlo: Menlo}t2stext-to-slant{italic: ITALIC}t2wtext-to-weight{bold: BOLD}相比创建多个Text再分组这一机制在单对象内完成混排后续整体animate更简单。公式的等价能力是set_color_by_tex按 LaTeX 子串着色见 equations.md和MarkupText的span标记。Backstroke复杂背景上的文字可读性当文字与图形、图表、图片重叠时为文字添加深色描边背衬是最佳实践# CE 语法背景描边 label.set_stroke(BLACK, width5, backgroundTrue) # 应用于一组对象 for mob in labels: mob.set_stroke(BLACK, width4, backgroundTrue)backgroundTrue的描边只画在文字笔画背后形成类似描边光晕的效果。这正是 3Blue1Brown 在复杂背景上保持文字可读的方法——不使用BackgroundRectangle那种矩形底衬视觉上更干净。同一模式也出现在 decorations.md 中作为Backdrop 效果的推荐做法。复变函数变换apply_complex_function / apply_function对整个 Mobject 施加复变函数实质上是变换整个平面c_grid ComplexPlane() moving_grid c_grid.copy() moving_grid.prepare_for_nonlinear_transform() # 增加采样点以获得平滑形变 self.play( moving_grid.animate.apply_complex_function(lambda z: z**2), run_time5, ) # 同样支持 R3 - R3 函数 self.play(grid.animate.apply_function( lambda p: [p[0] 0.5 * math.sin(p[1]), p[1] 0.5 * math.sin(p[0]), p[2]] ), run_time5)关键警告应用非线性函数之前必须调用prepare_for_nonlinear_transform()。没有它网格的采样点过少变形会呈现明显的锯齿状。这是复分析可视化如z → z²的保角映射中最高频的坑之一。ComplexPlane的完整用法n2p坐标转换、add_coordinates()可参考 graphs-and-data.md。实战组合一个可运行的架构图场景将上述知识组装进 manim-video 的标准场景模板SKILL.md 的script.py模式一个完整的微服务架构图场景可以是from manim import * BG #1C1C1C PRIMARY #58C4DD SECONDARY #83C167 ACCENT #FFFF00 MONO Menlo class ServiceNode(Group): def __init__(self, label, colorPRIMARY, **kwargs): super().__init__(**kwargs) self.box RoundedRectangle(corner_radius0.2, width2.5, height1.0, colorcolor, fill_opacity0.3) self.text Text(label, font_size24, fontMONO).move_to(self.box) self.add(self.box, self.text) class ArchitectureScene(Scene): def construct(self): self.camera.background_color BG api ServiceNode(API Gateway, PRIMARY).move_to(UP * 1.5) auth ServiceNode(Auth, SECONDARY).to_edge(LEFT, buff1.0) data ServiceNode(Database, ACCENT).to_edge(RIGHT, buff1.0) self.play(FadeIn(api)) self.wait(1.0) self.play(FadeIn(auth), FadeIn(data)) self.wait(0.5) conn LabeledArrow(Text(JWT, font_size18, fontMONO), startapi.get_bottom(), endauth.get_top(), colorSECONDARY) self.play(GrowArrow(conn)) self.wait(1.0) self.play(FadeOut(Group(*self.mobjects)), run_time0.5)这个场景完整运用了本文的核心知识RoundedRectangleText组合成自定义Group注意内部有Text必须用Group而非VGroup、move_to/to_edge定位、LabeledArrow自动标签连线、FadeIn/GrowArrow/FadeOut(Group(*self.mobjects))动画节奏以及self.wait()的呼吸感留白。渲染命令沿用 SKILL.md 的标准管线manim -ql script.py ArchitectureScene # 草稿迭代 manim -qh script.py ArchitectureScene # 生产渲染总结Mobjects 是 Manim 动画的原子单位。本文从Text/MathTex文本族、Circle/Polygon/Arc形状族、Sector/Annulus/Cutout组合族到VGroup/Group分组规则、set_*样式体系、IntegerMatrix/SVGMobject/Variable等专用类型以及t2c逐子串控制、prepare_for_nonlinear_transform等易错细节完整覆盖了 mobjects.md 的全部知识并做了源码级延伸。建议结合 visual-design.md布局模板与不透明度分层、decorations.md标注装饰体系与 animations.md动画编排一起使用即可从能画出对象进阶到能讲好故事。赞分享AI 技能/插件音视频视频处理人工智能【免费下载链接】video-useEdit videos with coding agents项目地址https://gitcode.com/GitHub_Trending/vid/video-use点击查看免费下载相关推荐如何快速掌握Qwen3-235B-A22B-Thinking-2507-FP881.0分INCLUDE多语言理解模型的完整指南 如何快速掌握Qwen3 235B A22B Thinking 2507 FP881.0分INCLUDE多语言理解模型的完整指南 Qwen3 235B A大模型深度学习hku-nlp/instructor-base革命性文本嵌入模型无需训练即可生成领域与任务感知向量hku nlp/instructor base革命性文本嵌入模型无需训练即可生成领域与任务感知向量 hku nlp/instructor base是一款革命Manim数学动画框架终极指南用Python创建惊艳数学可视化效果Manim数学动画框架终极指南用Python创建惊艳数学可视化效果 Manim数学动画框架是一个革命性的开源工具专为数学教育工作者、科研人员和编程爱好者设计图形学教育创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考