如何将PIL中的图片添加至MoviePY视频中？

核心思路 #

MoviePy 处理的视觉元素本质是 numpy数组，而PIL的Image对象可以直接转换为numpy数组，这是两者互通的关键。不管是静态PIL图片还是动态生成的PIL图像，都可以通过这个方式导入MoviePy。

静态PIL图片添加示例 #

如果是已有的静态PIL图片（比如从文件加载或已在内存中），可以按以下步骤操作：

from PIL import Image
import numpy as np
from moviepy.editor import VideoFileClip, ImageClip, CompositeVideoClip

# 1. 加载或获取PIL Image对象
# 方式1：从文件加载
pil_img = Image.open("your_image.png")
# 方式2：使用已存在的PIL对象（比如你通过PIL生成的图）
# pil_img = Image.new("RGB", (200, 200), color="red")

# 2. 将PIL图片转为numpy数组（MoviePy原生支持的格式）
img_array = np.array(pil_img)

# 3. 创建MoviePy的ImageClip，设置显示时长
img_clip = ImageClip(img_array).set_duration(5)  # 显示5秒
# 可选：设置图片在视频中的位置，比如居中/左上角/自定义坐标
img_clip = img_clip.set_position(("center", "center"))  # 居中显示
# 也可以用像素坐标：set_position((100, 200))

# 4. 加载主视频（如果需要将图片叠加到视频上）
main_video = VideoFileClip("your_video.mp4")

# 5. 合成视频：将图片层叠加到主视频上
final_video = CompositeVideoClip([main_video, img_clip])

# 6. 导出最终视频
final_video.write_videofile("output.mp4", codec="libx264")

动态生成PIL图片添加示例 #

如果你的PIL图片是实时生成的（比如随时间变化的图像），可以用VideoClip自定义帧生成函数：

from PIL import Image
import numpy as np
from moviepy.editor import VideoClip, CompositeVideoClip, VideoFileClip

def generate_pil_frame(t):
    """根据时间t生成对应的PIL图片"""
    # 示例：随时间改变图片颜色
    red_value = int(t * 50) % 255
    pil_img = Image.new("RGB", (300, 300), color=(red_value, 0, 0))
    # 将PIL图片转为numpy数组返回
    return np.array(pil_img)

# 创建动态视频片段，设置总时长10秒
dynamic_img_clip = VideoClip(make_frame=generate_pil_frame, duration=10)
dynamic_img_clip = dynamic_img_clip.set_position("center")

# 叠加到主视频
main_video = VideoFileClip("your_video.mp4")
final_video = CompositeVideoClip([main_video, dynamic_img_clip])

final_video.write_videofile("dynamic_output.mp4", codec="libx264")

注意事项 #

• RGBA透明图片处理：如果你的PIL图片是RGBA格式（带透明度），转成numpy数组后会自动保留4通道信息，MoviePy的ImageClip会正确识别透明度，无需额外处理。
• 尺寸匹配：如果图片尺寸和视频不一致，你可以用PIL的resize方法先调整图片大小，再转成numpy数组。
• 性能优化：如果是高频生成PIL图片的场景，尽量减少PIL和numpy之间的转换次数，或者预先生成所有帧数组再导入。

内容的提问来源于stack exchange，提问作者MG95