命令行参数和配置

命令行界面

使用 manim 运行一个动画，需要进入到与 manimlib/ 文件夹同级的目录中，并向命令行中输入如下格式的命令：

manimgl <code>.py <Scene> <flags>
# 或
manim-render <code>.py <Scene> <flags>

• <code>.py : 你写的 python 文件，可以使用绝对路径或相对于当前命令行所在路径的相对路径

• <Scene> : 你想要渲染的场景，或者一些场景。如果没有写或者写错，若文件中只有一个 Scene，会直接渲染这个类，否则会列出所有让你选择

• <flags> : 传入的选项

一些常用的选项

• -w 把场景写入文件

• -o 把场景写入文件并打开

• -s 跳到最后只展示最后一帧

  • -so 保存最后一帧并打开

• -n <number> 跳到场景中第 n 个动画

• -f 打开窗口全屏

所有支持的选项

选项	简写	含义
--help	-h	显示提示信息并退出
--version	-v	显示manimgl的版本
--write_file	-w	把场景渲染成视频文件
--skip_animations	-s	跳到最后一帧
--low_quality	-l	使用低质量渲染(默认 480p15)
--medium_quality	-m	使用中等质量渲染(默认 720p30)
--hd		使用高质量渲染(默认 1080p30)
--uhd		使用 4K 质量渲染
--full_screen	-f	全屏呈现窗口
--presenter_mode	-p	场景将会在 wait 时暂停，等待用户按下空格或右方向键时继续播放（即幻灯片效果）
--save_pngs	-g	把所有帧都保存为 png 文件
--gif	-i	把场景输出为 gif 文件
--transparent	-t	渲染 alpha 通道，视频为 mov 格式
--quiet	-q
--write_all	-a	渲染文件中的所有场景
--open	-o	保存文件后自动打开
--finder		打开保存文件的文件夹
--config		进入自动配置指南
--file_name FILE_NAME		给输出文件重命名
--start_at_animation_number START_AT_ANIMATION_NUMBER	-n	后面接两个数(逗号隔开)仅渲染一部分动画，如”3,6”
--embed [EMBED]	-e	创建一个新文件，其中 self.embed 行插入到 Scenes 构造方法中。如果传入字符串，则该行将插入包含该字符串的最后一行代码下方。
--resolution RESOLUTION	-r	分辨率，传入格式为”WxH”, 如”1920x1080”
--fps FPS		视频帧率（整数）
--color COLOR	-c	背景颜色
--leave_progress_bars		保持进度条留在终端中
--video_dir VIDEO_DIR		存放视频的目录
--config_file CONFIG_FILE		使用指定的配置文件
--log-level LOG_LEVEL		要显示的消息级别，可以是DEBUG / INFO / WARNING / ERROR / CRITICAL（调试/信息/警告/错误/严重）

个性化默认值

为了进行更多配置（关于目录等）并且永久更改默认值（不必每次都在命令中添加 flags）， 可以修改/新建 custom_config.yml ，其中各选项含义见： 自定义配置 custom_config 。

你也可以对于不同目录使用不同的 custom_config.yml，如按照以下目录结构：

manim/
├── manimlib/
│   ├── animation/
│   ├── ...
│   ├── default_config.yml
│   └── window.py
├── project/
│   ├── code.py
│   └── custom_config.yml
└── custom_config.yml

进入 project/ 文件夹中，运行 manimgl code.py <Scene> 的时候， 会用 project/ 文件夹下的 custom_config.yml 覆盖 manim/default_config.yml。

或者，您可以在传入选项中使用 --config_file 标志来手动指定配置文件。 manimgl project/code.py --config_file /path/to/custom_config.yml