命令行参数和配置 =========================== 命令行界面 ---------------------- 使用 manim 运行一个动画,需要进入到与 ``manimlib/`` 文件夹同级的目录中,并向命令行中输入如下格式的命令: .. code-block:: sh manimgl .py # 或 manim-render .py - ``.py`` : 你写的 python 文件,可以使用绝对路径或相对于当前命令行所在路径的相对路径 - ```` : 你想要渲染的场景,或者一些场景。如果没有写或者写错,若文件中只有一个 Scene,会直接渲染这个类,否则会列出所有让你选择 - ```` : 传入的选项 一些常用的选项 ^^^^^^^^^^^^^^^^^ - ``-w`` 把场景写入文件 - ``-o`` 把场景写入文件并打开 - ``-s`` 跳到最后只展示最后一帧 - ``-so`` 保存最后一帧并打开 - ``-n `` 跳到场景中第 ``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`` ,其中各选项含义见: :doc:`../documentation/custom_config` 。 你也可以对于不同目录使用不同的 ``custom_config.yml``,如按照以下目录结构: .. code-block:: text manim/ ├── manimlib/ │ ├── animation/ │ ├── ... │ ├── default_config.yml │ └── window.py ├── project/ │ ├── code.py │ └── custom_config.yml └── custom_config.yml 进入 ``project/`` 文件夹中,运行 ``manimgl code.py `` 的时候, 会用 ``project/`` 文件夹下的 ``custom_config.yml`` 覆盖 ``manim/default_config.yml``。 或者,您可以在传入选项中使用 ``--config_file`` 标志来手动指定配置文件。 ``manimgl project/code.py --config_file /path/to/custom_config.yml``