Manim Community v0.3.0 版本深度解析Graph 布局、IPython 集成与单位系统新特性【免费下载链接】manimA community-maintained Python framework for creating mathematical animations.项目地址: https://gitcode.com/GitHub_Trending/man/manim本文以 Manim Community v0.3.0 的官方发布说明docs/source/changelog/0.3.0-changelog.rst为主线逐项剖析该版本引入的核心新特性与重要修复并结合当前仓库源码验证其实现细节。读完本文你将掌握Graph对象的多布局与 networkx 互操作、%%manimIPython 魔法命令、单位换算系统Pixels/Munits/Percent以及配置文件驱动的画幅控制等实战能力。一、版本概况Manim Community v0.3.0 发布于 2021 年 2 月 1 日是自 v0.2.0 之后的一次重要功能迭代。该版本新增了 14 项新特性并包含约 40 项 Bug 修复与增强核心方向集中在三块图Graph对象的布局能力扩展、IPython/Jupyter 环境的深度集成、以及单位系统与配置灵活性的提升。这些能力中的绝大多数至今仍是 Manim 日常开发的基础设施理解 v0.3.0 的演进脉络有助于更准确地使用当前版本中的同名 API。二、Graph 对象能力全面升级v0.3.0 对Graphmobject 的投入是本次发布的重头戏共涉及 4 个 PR覆盖布局切换、networkx 互操作、树形布局与多列 partite 布局。2.1 新增change_layout方法PR #945此前Graph只能在构造时指定一次布局v0.3.0 引入了change_layout方法允许在场景运行时动态切换图布局并可配合animate实现布局变换动画。当前源码位于 manim/mobject/graph.py其签名如下def change_layout( self, layout: LayoutName | dict[Hashable, Point3DLike] | LayoutFunction spring, layout_scale: float | tuple[float, float, float] 2, layout_config: dict[str, Any] | None None, partitions: list[list[Hashable]] | None None, root_vertex: Hashable | None None, ) - Graph:其中layout可以是spring默认、circular、kamada_kawai、planar、random、shell、spectral、spiral、tree、partite等由 networkx 支持的布局名称也可以是一个为每个顶点显式指定坐标的字典layout_config中的键值对会被透传给对应的 networkx 布局算法partitions与root_vertex则分别服务于 partite 与 tree 布局。方法实现上change_layout会调用_determine_graph_layout重新计算布局字典随后将每个顶点 mobjectmove_to到新坐标并返回self因此天然支持链式调用与动画插值。官方文档示例展示了从手动线性布局动画切换到圆形布局class ChangeGraphLayout(Scene): def construct(self): G Graph([1, 2, 3, 4, 5], [(1, 2), (2, 3), (3, 4), (4, 5)], layout{1: [-2, 0, 0], 2: [-1, 0, 0], 3: [0, 0, 0], 4: [1, 0, 0], 5: [2, 0, 0]} ) self.play(Create(G)) self.play(G.animate.change_layout(circular)) self.wait()2.2from_networkx直接消费 networkx 图PR #893PR #893 新增类方法Graph.from_networkxmanim/mobject/graph.py它接受一个networkx.Graph或networkx.DiGraph将其节点与边列表透传给Graph构造函数其余关键字参数如layout、layout_scale照常生效import networkx as nx nxgraph nx.erdos_renyi_graph(14, 0.5) class ImportNetworkxGraph(Scene): def construct(self): G Graph.from_networkx(nxgraph, layoutspring, layout_scale3.5) self.play(Create(G)) self.play(*[G[v].animate.move_to(5*RIGHT*np.cos(ind/7 * PI) 3*UP*np.sin(ind/7 * PI)) for ind, v in enumerate(G.vertices)]) self.play(Uncreate(G))这意味着你可以复用 networkx 生态中丰富的图生成与算法能力再将结果直接可视化。2.3 Tree 布局与多列 Partite 布局PR #922、PR #916Tree 布局PR #922新增tree布局并在layout_config中支持特殊参数vertex_spacing。传入(space_x, space_y)元组时会覆盖layout_scale确保同层兄弟节点中心横向间距至少为space_x、相邻层纵向间距为space_y同时可通过root_vertex指定根节点。多列 Partite 布局PR #916新增partite布局配合partitions参数顶点分组列表实现按集合分列排布适合二分图、三分图等多部图的可视化。2.4 相关修复边不再滞后于顶点PR #954PR #954 修复了图动画中边落后于顶点移动的视觉缺陷。配合change_layout等新能力这一修复保证了布局变换动画中边与顶点同步运动。三、IPython 集成%%manim魔法命令PR #943v0.3.0 将 Manim 渲染能力接入 IPython/Jupyter实现在笔记本单元格内直接定义并渲染场景。该功能由ManimMagic类实现位于 manim/utils/ipython_magic.py同时支持行魔法%manim与单元格魔法%%manim。3.1 基本用法%%manim -v WARNING --disable_caching -qm BannerExample config.media_width 75% config.media_embed True class BannerExample(Scene): def construct(self): self.camera.background_color #ece6e2 banner_large ManimBanner(dark_themeFalse).scale(0.7) self.play(banner_large.create()) self.play(banner_large.expand())单元格第一行%%manim之后直接跟 CLI 选项与场景类名单元格主体定义场景代码执行后 Manim 渲染该场景并在笔记本中直接展示视频。也可以使用行模式%manim [CLI options] MyAwesomeScene渲染已定义好的场景。3.2 实现要点与配置项从源码可见manim魔法最终会惰性导入manim.__main__.main来复用完整的 CLI 解析逻辑并通过tempconfig将单元格内定义的config字典临时注入保证不污染全局配置。围绕该功能还有以下关键配置media_width控制笔记本内视频显示宽度默认25vw视口宽度的 25%可设置config.media_width 100%放大输出。media_embed将图片/视频输出直接嵌入笔记本便于迁移 notebook 或 HTML 文件如 Sphinx/JupyterBook 构建文档Google Colab 上会自动启用可用config.embed False抑制。progress_bar若想隐藏输出中的进度条红框可设为None或通过 CLI flag--progress_bar None传入。3.3 JupyterLab Docker 镜像与文档PR #977配套 PR #977 提供了 JupyterLab Docker 镜像并补充了 manim IPython 的使用文档见 docs/source/installation/jupyter.rst 与 docs/source/installation/docker.rst使笔记本环境开箱即用。四、命令行与配置增强4.1--version命令行标志PR #970v0.3.0 为 CLI 新增--version标志。当前实现位于 manim/main.py通过 Click 的callbackprint_version_and_exit打印Manim Community v{__version__}后退出同时保留了--splash等标志用于控制启动画面。这一改动让脚本与 CI 环境可以快速校验安装的 Manim 版本。4.2 配置文件支持frame_height/frame_widthPR #756此前画幅尺寸只能通过 CLI 参数控制PR #756 允许在配置文件中直接设置frame_height与frame_width。在 manim/_config/utils.py 中配置解析逻辑为self[frame_height] parser[CLI].getfloat(frame_height, 8.0) width parser[CLI].getfloat(frame_width, None) if width is None: self[frame_width] self[frame_height] * self[aspect_ratio] else: self[frame_width] width即frame_height默认 8.0 个单位当frame_width未显式给出时由frame_height × aspect_ratio自动推导aspect_ratio 默认 16:9这保证了不破坏原有的默认纵横比。对应地manim/_config/default.cfg 中提供了这些键的默认值模板。同时 PR #932 修复了log_dir选项的解析问题使日志目录配置更加可靠。4.3 移除废弃参数与进度条细节恢复PR #908、PR #886PR #886 让渲染进度条重新展示渲染动画的细节信息渲染帧数、速率等PR #908 则从文档中移除了已废弃的命令行参数避免误导。五、Code 对象支持代码字符串与自定义样式5.1 向Code传入代码字符串PR #948此前Codemobject 只能从文件路径读取代码PR #948 新增code_string参数允许直接传入源代码字符串。当前实现见 manim/mobject/text/code_mobject.pydef __init__( self, code_file: StrPath | None None, code_string: str | None None, ... ): if code_file is not None: code_file Path(code_file) code_string code_file.read_text(encodingutf-8) lexer guess_lexer_for_filename(code_file.name, code_string) elif code_string is not None: lexer guess_lexer(code_string)code_file与code_string二选一传入文件时按文件名猜测 Pygments lexer传入字符串时按内容猜测读取后还会按tab_width展开制表符再用pygments.highlight生成语法高亮 HTML 渲染为文本 mobject。5.2 自定义 Pygments 样式PR #980PR #980 允许为Code指定自定义 Pygments 样式进一步控制了代码块的配色表现。PR #978 则修复了possible_paths提示信息无法打印的问题改善了找不到代码文件时的诊断体验。六、单位系统Pixels、Munits 与 PercentPR #742PR #742 在manim.utils.unit模块中引入了单位换算能力当前实现见 manim/utils/unit.pyPixels将像素值换算为 Manim 坐标单位实现为val * config.frame_width / config.pixel_width即把像素按帧宽等比映射到坐标空间。MunitsManim 原生单位定义为1即1 * Munits 1坐标单位保证与其他单位书写风格一致。Percent相对某个坐标轴的比例单位Percent(X_AXIS) * 50表示帧宽的 50%。实现中对X_AXIS取frame_width、对Y_AXIS取frame_height对Z_AXIS直接抛出NotImplementedError因为 Z 轴长度未定义。典型用法如下可用于精确控制对象尺寸与定位from manim.utils.unit import Pixels, Percent, Munits # 宽度为 100 像素的对象 rect Rectangle(width100 * Pixels, height50 * Pixels) # 位于帧宽 25% 处 dot Dot().shift(25 * Percent(X_AXIS) * RIGHT)七、其他值得关注的新特性ManimCommunity 配色PR #892新增官方社区配色集合位于 manim/utils/color/manim_colors.py并与 PR #971 的视觉一致性调整logo、配色统一配合使社区品牌形象更加一致。自定义字体文件支持PR #939允许在Text等场景中加载自定义字体文件扩展了非系统字体的使用范围。新式方法动画的覆盖与限制PR #917、PR #957PR #917 允许通过.animate覆盖新式方法动画PR #957 则规定试图链式调用被覆盖的方法动画如obj.animate.method1().method2()时抛出NotImplementedError以明确该能力边界。PR #906 同时让新式方法动画可以放入AnimationGroup等动画组合中使用。行为准则PR #935仓库新增 CODE_OF_CONDUCT.md为社区协作奠定规范基础。八、Bug 修复与增强要点8.1 FadeIn 描边透明度插值与 set_stroke/set_fill 更新PR #944PR #944 让FadeIn在淡入过程中对stroke_opacity进行插值此前描边透明度不参与淡入并让VMobject.set_stroke与set_fill正确同步更新stroke_opacity与fill_opacity属性消除了淡入时描边硬切的视觉瑕疵。8.2 ThreeDAxes 的边界关键字参数PR #941PR #941 为ThreeDAxes新增x_min、x_max、y_min、y_max关键字参数使其与Axes/NumberPlane的区间配置方式对齐。8.3 NumberLine 单位向量修正PR #960、PR #964修复了NumberLine单位向量的模长问题此前单位向量的模长为 1现修正为unit_size并配套新增了相应单元测试见 tests/module/mobject/graphing。8.4 Matrix 与 MarkupText 的输入校验PR #933、PR #929、PR #920PR #933 恢复Matrix对列表list输入的支持PR #929 规定创建维度低于 2 的Matrix时抛出错误PR #920 对MarkupText中的非法 markup 内容直接报错避免静默渲染出错误文本。8.5 其他修复add_sound回归修复PR #907在--disable_caching下恢复Scene.add_sound功能。index_labels重命名PR #865get_submobject_index_labels更名为index_labels语义更简洁。PointCloudDot多项改进PR #947修复若干渲染与属性问题。插件自动导入PR #967Manim 启动时自动导入已安装插件简化插件使用流程。webgl 渲染器变量名修复PR #985与 tween 信息透传PR #952为 WebGL 前端相关能力扫清障碍。BulletedListTeX 环境修复PR #936解决BulletedList的 TeX 环境兼容问题。CI 与构建侧修复PR #988、PR #937、PR #898包括 Windows CI 补充缺失 LaTeX 包、brew cask install改为brew install --cask、publish workflow 修复。移除 progressbar 依赖PR #938用更轻量的实现替代progressbar第三方库。九、总结Manim Community v0.3.0 通过Graph.change_layout、from_networkx、tree/partite 布局构建了完整的图可视化体系通过%%manim魔法命令打通了 Jupyter 交互式创作链路通过Pixels/Munits/Percent单位系统与配置文件画幅控制显著提升了数值表达与配置的灵活性。这些特性在 manim/mobject/graph.py、manim/utils/ipython_magic.py、manim/utils/unit.py 等当前源码中均有完整实现读者可直接结合源码与 docs/source/changelog/0.3.0-changelog.rst 对照研读或通过manim --version确认所使用版本的演进位置。【免费下载链接】manimA community-maintained Python framework for creating mathematical animations.项目地址: https://gitcode.com/GitHub_Trending/man/manim创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考