ManimCommunity/manim中自定义视频宽高比的正确实现方式

在使用Manim制作数学动画时，我们经常需要自定义视频的宽高比来满足不同平台或场景的需求。本文将详细介绍在ManimCommunity/manim项目中正确设置视频宽高比的方法。

常见误区

许多开发者会尝试使用self.camera.reset_pixel_shape(1600, 900)方法来修改视频分辨率，或者在配置文件中设置pixel_height和pixel_width参数。然而，这些方法往往无法得到预期的效果，导致视频显示异常或宽高比不正确。

正确实现方式

要在Manim中正确设置自定义宽高比，需要同时配置两个方面的参数：

1. 像素分辨率：通过config.pixel_width和config.pixel_height设置
2. 场景坐标系：通过config.frame_width和config.frame_height设置

这两个参数组必须保持相同的宽高比，才能确保渲染结果符合预期。

完整示例代码

from manim import *

# 设置宽高比为16:9
config.frame_width = 16  # 场景坐标系宽度
config.frame_height = 9  # 场景坐标系高度
config.pixel_width = 1600  # 像素宽度
config.pixel_height = 900  # 像素高度

class CustomAspectRatioScene(Scene):
    def construct(self):
        # 示例动画内容
        banner = ManimBanner(dark_theme=False)
        self.play(banner.create())
        self.play(banner.expand())
        self.wait()

原理说明

Manim的渲染系统包含两个层面的尺寸概念：

1. 逻辑尺寸：由frame_width和frame_height决定，影响场景中物体的相对大小和位置
2. 物理尺寸：由pixel_width和pixel_height决定，影响最终输出视频的实际分辨率

只有当这两个层面的宽高比一致时，渲染结果才会保持正确的比例。如果只修改其中一个层面，会导致内容被拉伸或压缩。

最佳实践

1. 始终同时设置逻辑尺寸和物理尺寸
2. 保持两者的宽高比一致
3. 在场景类外部进行配置，确保在所有动画中生效
4. 对于常见宽高比(如16:9、4:3、1:1等)，可以使用标准值组合

通过遵循这些原则，开发者可以轻松创建各种宽高比的Manim动画，满足不同平台的发布需求。