Moviepy合成视频报错ValueError：无法重塑数组，如何解决？

问题场景 #

运行以下代码：

currentImageClip = ImageClip(r'path/to/image')
imageClipWithCaption = CompositeVideoClip([ColorClip(size=(1080, 720), color='black'), currentImageClip])

出现报错：

Traceback (most recent call last):
  File "C:\Users\samlb\Documents\folder\pythonFile.py", line 140, in makeVideo
    imageClipWithCaption = CompositeVideoClip([ColorClip(size=(1080, 720), color='black'), currentImageClip])
  File "C:\Users\samlb\AppData\Roaming\Python\Python39\site-packages\moviepy\video\VideoClip.py", line 1157, in __init__
    np.tile(color, w * h).reshape(shape), is_mask=is_mask, duration=duration
ValueError: cannot reshape array of size 777600 into shape (720,1080,5)

环境信息：

• Python 3.9.13
• moviepy 2.0.0.dev2-
• Windows 10

疑问：

1. 如何避免该错误？
2. 问题是否与合成的.png格式图片有关？

错误原因及解决方法 #

报错核心是合成片段的通道数或尺寸不匹配，可通过以下方式修复：

1. 统一通道数 #

如果你的PNG带透明通道（RGBA，4通道），默认的ColorClip是RGB（3通道），两者不兼容：

• 方法一：将ColorClip改为RGBA格式，指定带alpha的黑色：

  color_clip = ColorClip(size=(1080, 720), color=(0, 0, 0, 255))
  

• 方法二：移除ImageClip的透明通道，转为RGB格式：

  currentImageClip = ImageClip(r'path/to/image').without_alpha()
  

2. 匹配片段尺寸 #

确保ImageClip的尺寸和ColorClip一致（1080×720），不一致则调整：

currentImageClip = ImageClip(r'path/to/image').resize(size=(1080, 720))

3. 明确设置片段时长 #

部分场景下，未指定时长会导致内部处理异常，给两个片段设置相同时长：

clip_duration = 5  # 按需设置时长
color_clip = ColorClip(size=(1080, 720), color='black', duration=clip_duration)
currentImageClip = ImageClip(r'path/to/image', duration=clip_duration)
imageClipWithCaption = CompositeVideoClip([color_clip, currentImageClip])

与PNG格式的关系 #

这个问题确实和PNG格式直接相关：
PNG支持透明通道（RGBA，4通道），若你使用的是带透明通道的PNG，MoviePy会将其识别为4通道视频片段；而默认创建的ColorClip是3通道的RGB片段，两者通道数不匹配就会触发数组重塑错误。如果使用不带透明通道的PNG（RGB格式），则不会出现此问题。

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