使用MoviePy 2实现背景图上图片片段淡入淡出的问题排查

问题现象 #

使用MoviePy 2基于图片渲染视频，需求是全程保留一张背景图，多张前景图依次淡入、显示数秒后淡出。但当前代码生成的视频中，foreground_clip的淡入淡出效果异常，期间仅显示黑框。

问题根源 #

• 背景片段时长与合成逻辑错误：原代码里每个合成片段的背景background_clip只设了IMAGE_DISPLAY_DURATION时长，拼接时背景会跟着每个前景片段截断，没法全程保留。
• 淡入淡出效果叠加方式不对：单独给前景片段先后加CrossFadeIn和CrossFadeOut，会导致片段首尾透明度逻辑冲突，加上合成时层级处理不当，就出现了黑框。
• 拼接逻辑冗余：把每个背景+前景的合成片段单独拼接，既没必要，还容易破坏背景的连续性。

修正后的代码 #

def create_video(background_image_path, foreground_images_folder, output_video_path):
    # 加载并调整背景图尺寸
    background_clip = ImageClip(background_image_path).resized(VIDEO_RESOLUTION)
    
    # 筛选出文件夹内的前景图片
    foreground_images = [os.path.join(foreground_images_folder, img) 
                        for img in os.listdir(foreground_images_folder) 
                        if img.endswith(('png', 'jpg', 'jpeg'))]
    
    # 计算单张前景的总时长：显示时长 + 1秒淡入 + 1秒淡出
    single_foreground_duration = IMAGE_DISPLAY_DURATION + 2
    # 视频总时长为所有前景片段时长之和
    total_duration = len(foreground_images) * single_foreground_duration
    
    # 设置背景为视频总时长，确保全程显示
    background_clip = background_clip.with_duration(total_duration)
    
    # 处理所有前景片段，按时间线排列
    foreground_clips = []
    current_start_time = 0
    for img_path in foreground_images:
        # 加载前景图，调整尺寸并居中
        foreground_clip = ImageClip(img_path).resized(0.8).with_position('center')
        # 设置前景片段总时长
        foreground_clip = foreground_clip.with_duration(single_foreground_duration)
        # 同时添加淡入淡出效果：前1秒淡入，最后1秒淡出
        foreground_clip = foreground_clip.with_effects([
            vfx.CrossFadeIn(1),
            vfx.CrossFadeOut(1)
        ])
        # 设置当前前景片段在时间线上的起始位置
        foreground_clip = foreground_clip.with_start(current_start_time)
        foreground_clips.append(foreground_clip)
        # 更新下一个前景的起始时间
        current_start_time += single_foreground_duration
    
    # 合成背景与所有前景片段（背景在最底层）
    final_clip = CompositeVideoClip([background_clip] + foreground_clips)
    
    # 输出最终视频
    final_clip.write_videofile(output_video_path, fps=24)

关键修正点 #

• 背景全程保留：把背景时长设为视频总时长，避免片段拼接时背景中断。
• 统一前景时间线：通过with_start()让每个前景片段依次排列在时间线上，无需重复合成背景。
• 正确叠加淡入淡出：将两个效果放在同一个with_effects调用中，确保淡入作用于片段开头1秒，淡出作用于结尾1秒。

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