Manim的输出设置¶
本文档将重点介绍理解manim的输出文件以及一些可用的主要命令行标志。
注意
本教程从快速入门结束的地方开始，因此在开始本教程之前，请先阅读该文档。
Manim 输出文件夹¶
此时，您刚刚执行了以下命令。
manim -pql scene.py SquareToCircle
让我们一步步剖析刚刚发生的事情。首先，这个命令在包含我们动画代码的文件scene.py上执行manim。此外，这个命令明确告诉manim要渲染哪个Scene，在这个例子中，它是SquareToCircle。这是必要的，因为一个场景文件可能包含多个场景。接下来，标志-p告诉manim在渲染后播放场景，而-ql标志告诉manim以低质量渲染场景。
视频渲染完成后，您将看到manim生成了一些新文件，项目文件夹将如下所示。
project/
├─scene.py
└─media
├─videos
| └─scene
| └─480p15
| ├─SquareToCircle.mp4
| └─partial_movie_files
├─text
└─Tex
有很多新文件。主要输出在
media/videos/scene/480p15/SquareToCircle.mp4。默认情况下，media
文件夹将包含所有manim的输出文件。media/videos
子文件夹包含渲染的视频。在其中，您会找到每个不同视频质量的一个文件夹。
在我们的例子中，由于我们使用了-l标志，
视频是从scene.py文件生成的，分辨率为480，每秒15帧。
因此，输出可以在media/videos/scene/480p15中找到。额外的文件夹
media/videos/scene/480p15/partial_movie_files以及media/text和
media/Tex包含manim内部使用的文件。
你可以通过执行以下命令来查看manim如何利用生成的文件夹结构，
manim -pqh scene.py SquareToCircle
-ql 标志（表示低质量）已被 -qh 标志取代，表示高质量。Manim 渲染此文件将花费相当长的时间，并且由于我们使用了 -p 标志，它将在完成后播放。输出应如下所示：
文件夹结构应如下所示。
project/
├─scene.py
└─media
├─videos
| └─scene
| ├─480p15
| | ├─SquareToCircle.mp4
| | └─partial_movie_files
| └─1080p60
| ├─SquareToCircle.mp4
| └─partial_movie_files
├─text
└─Tex
Manim 创建了一个新文件夹 media/videos/1080p60，它对应高分辨率和每秒60帧。在其中，你可以找到新的 SquareToCircle.mp4，以及相应的 partial_movie_files。
在处理具有多个场景的项目并尝试多种分辨率时，输出目录的结构将使您的所有视频保持有序。
此外，manim 可以选择在添加标志 -s 时输出场景的最后一帧。这是快速预览场景的最快选项。相应的文件夹结构如下所示：
project/
├─scene.py
└─media
├─images
| └─scene
| ├─SquareToCircle.png
├─videos
| └─scene
| ├─480p15
| | ├─SquareToCircle.mp4
| | └─partial_movie_files
| └─1080p60
| ├─SquareToCircle.mp4
| └─partial_movie_files
├─text
└─Tex
使用-s保存最后一帧可以与不同分辨率的标志结合使用，例如-s -ql，-s -qh
章节¶
除了电影输出文件，还可以使用章节。每个章节都会生成自己的输出视频。两个章节之间的剪辑可以这样设置：
def construct(self):
# play the first animations...
# you don't need a section in the very beginning as it gets created automatically
self.next_section()
# play more animations...
self.next_section("this is an optional name that doesn't have to be unique")
# play even more animations...
self.next_section("this is a section without any animations, it will be removed")
所有这些剪辑之间的动画将被连接成一个单一的输出视频文件。请注意，每个部分至少需要一个动画。例如，这将不会创建输出视频：
def construct(self):
self.next_section()
# this section doesn't have any animations and will be removed
# but no error will be thrown
# feel free to tend your flock of empty sections if you so desire
self.add(Circle())
self.next_section()
解决这个问题的一种方法是稍等片刻：
def construct(self):
self.next_section()
self.add(Circle())
# now we wait 1sec and have an animation to satisfy the section
self.wait()
self.next_section()
要为每个部分创建视频，您必须将--save_sections标志添加到Manim调用中，如下所示：
manim --save_sections scene.py
如果你这样做，media 文件夹将会是这样的：
media
├── images
│ └── simple_scenes
└── videos
└── simple_scenes
└── 480p15
├── ElaborateSceneWithSections.mp4
├── partial_movie_files
│ └── ElaborateSceneWithSections
│ ├── 2201830969_104169243_1331664314.mp4
│ ├── 2201830969_398514950_125983425.mp4
│ ├── 2201830969_398514950_3447021159.mp4
│ ├── 2201830969_398514950_4144009089.mp4
│ ├── 2201830969_4218360830_1789939690.mp4
│ ├── 3163782288_524160878_1793580042.mp4
│ └── partial_movie_file_list.txt
└── sections
├── ElaborateSceneWithSections_0000.mp4
├── ElaborateSceneWithSections_0001.mp4
├── ElaborateSceneWithSections_0002.mp4
└── ElaborateSceneWithSections.json
正如你所看到的，每个部分都会在sections目录中接收到自己的输出视频。
这里的JSON文件包含了一些对每个部分有用的信息：
[
{
"name": "create square",
"type": "default.normal",
"video": "ElaborateSceneWithSections_0000.mp4",
"codec_name": "h264",
"width": 854,
"height": 480,
"avg_frame_rate": "15/1",
"duration": "2.000000",
"nb_frames": "30"
},
{
"name": "transform to circle",
"type": "default.normal",
"video": "ElaborateSceneWithSections_0001.mp4",
"codec_name": "h264",
"width": 854,
"height": 480,
"avg_frame_rate": "15/1",
"duration": "2.000000",
"nb_frames": "30"
},
{
"name": "fade out",
"type": "default.normal",
"video": "ElaborateSceneWithSections_0002.mp4",
"codec_name": "h264",
"width": 854,
"height": 480,
"avg_frame_rate": "15/1",
"duration": "2.000000",
"nb_frames": "30"
}
]
这些数据可以被第三方应用程序使用，比如演示系统或自动化视频编辑工具。
你也可以跳过渲染属于某个部分的所有动画，如下所示：
def construct(self):
self.next_section(skip_animations=True)
# play some animations that shall be skipped...
self.next_section()
# play some animations that won't get skipped...
一些命令行标志¶
当执行命令时
manim -pql scene.py SquareToCircle
它指定要渲染的场景。现在这不是必要的。当一个文件只包含一个Scene类时，它将只渲染Scene类。当一个文件包含多个Scene类时，manim会让你选择一个Scene类。如果你的文件包含多个Scene类，并且你想渲染它们全部，你可以使用-a标志。
如前所述，-ql 指定了低渲染质量（854x480 15FPS）。这看起来不是很好，但对于快速原型设计和测试非常有用。其他指定渲染质量的选项分别是 -qm、-qh、-qp 和 -qk，分别对应中等（1280x720 30FPS）、高（1920x1080 60FPS）、2k（2560x1440 60FPS）和4k质量（3840x2160 60FPS）。
-p 标志在动画渲染后播放它。如果你想在动画的位置打开文件浏览器而不是播放它，你可以使用 -f 标志。你也可以省略这两个标志。
最后，默认情况下，manim 会输出 .mp4 文件。如果你希望动画以 .gif 格式输出，可以使用 --format gif 标志。输出文件将与 .mp4 文件位于同一文件夹中，并且名称相同，但文件扩展名不同。
这是对一些最常用的命令行标志的快速回顾。 要全面了解所有可用的标志，请参阅关于Manim配置系统的主题指南。