剪片到收尾阶段，最常被临时加码的就是转场。原本硬切过去的镜头，回头一看觉得太生硬，加淡入淡出又太重，加缩放又太跳，最省事又好看的办法往往是把画面从某一侧推出去。MoviePy 里专门负责这件事的组件叫SlideOut，中文习惯叫「滑出特效」，它做的事情非常朴素：让一个视频片段沿着画面的四条边之一，按时间线性地移出可视区域。这篇内容把 SlideOut 从源码层面拆开讲，包括side和duration两个参数到底怎么影响每一帧的坐标、为什么单独用它会看到一片黑、以及怎样让它在片段「最后 1 秒」才滑出去，而不是一开头就滑没。文中的代码分 1.x 和 2.x 两套写法，跟着复制就能跑；后面还整理了渲染耗时、边缘抖动、批量处理这几类实际动手才会遇到的问题。不管是刚接触视频合成的新手，还是已经在用 MoviePy 拼时间轴的熟手，都能从里面拿到能直接抄的东西。

1. 先把 SlideOut 的使用场景说透

1.1 它到底在解决什么画面问题

视频里的「转场」本质上是在处理两段画面之间的空间关系和时间关系。淡入淡出处理的是亮度上的过渡，缩放处理的是景深上的过渡，而滑出处理的是位置上的过渡。这三者的语感完全不同：淡入淡出像是记忆在消退，缩放像是注意力在聚焦，而滑动更像是「翻页」或者「挪开挡在前面的东西」。

SlideOut 的定位就在最后这一类。它把当前画面从左侧、右侧、顶部或底部整块推出去，露出后面的画布或者下一层片段。这种动作语言带有明确的方向暗示：从左边滑出去，观众下意识觉得「往前面走了一步」；从右边滑出去，感觉是「退回去」；从下往上滑出去，像翻卡片；从上往下滑出去，像卷帘门。方向本身就在讲故事，这一点比参数调多细都重要。

它最适合的场景大致有三类。第一类是片头片尾的模块化拼接：一个片子由若干个视觉单元组成，每个单元用不同的方向进场出场，节奏感立刻就有了。第二类是信息图或者图文卡片的切换：文字卡、数据卡、结论卡之间用滑动过渡，比硬切自然，比淡入有力量。第三类是短视频里的「甩镜头」：不需要真的拍到甩镜头的素材，用滑出加一点点缩放就能做出类似的速度感。反过来，如果这段内容是访谈、口播、连续叙事的纪录片，滑动转场就会显得太「包装」，这时候老老实实硬切或者用极短的交叉淡化更合适。

1.2 SlideOut、SlideIn、CrossFade 该怎么选

很多人第一次翻 MoviePy 的特效列表，会在 SlideOut 和 SlideIn 之间犹豫。这两个东西是镜像关系：SlideIn 让画面从画面外滑进正常位置，SlideOut 让画面从正常位置滑到画面外。从观众感受上说，进场用 SlideIn、出场用 SlideOut是最符合直觉的用法，它们天然可以组成一对「推拉门」式的转场。

真正需要权衡的是「滑动」和「交叉淡化」的选择。CrossFadeIn 做的是两个片段叠加，前一个逐渐透明、后一个逐渐显现，观众看到的是同一块画面在「变」。滑动做的是两个片段在空间上互相让位，观众看到的是画面在「动」。前者温和、后者有力，前者适合情绪延续，后者适合节奏切换。我自己的经验是：内容时间跨度大（比如从白天跳到夜晚）用淡化，内容时间跨度小（同一个场景里的连续动作）用滑动，因为滑动暗含了「紧接着发生」的意味。

还有一个不那么显眼但很实用的选择点：滑动可以和淡化叠加使用。滑出的同时让片段透明度下降，画面会显得更「轻」，尤其是在滑出速度比较快的时候，这种叠加能掩盖住边缘生硬的感觉。后面第 4 章会给具体写法。

1.3 谁适合拿这篇当手册

这篇内容写成三层，对应三种需要。

如果你只想让一个现成的 mp4 有一段滑出动画，直接看第 3 章，两套版本的代码都在那里，复制改一下文件名和方向参数就能出片，不用理解原理。

如果你要在一条时间轴上拼十来段素材，还要控制每段滑出的时机，第 4 章是重点。那里讲了怎么让滑出发生在片段末尾而不是开头、怎么让两段素材同时向两边滑开露出底层、怎么把音频和字幕一起对齐。

如果你想在自己项目里做类似的位移特效，或者想改 MoviePy 的默认行为，第 2 章把位置函数、时间轴、遮罩同步这几件事拆开讲了，看明白了你自己就能写一个SlideOutEx出来，加缓动、加旋转、加透视都不在话下。

注意：MoviePy 的版本差异比较大，1.x 和 2.x 的导入路径、调用方式、乃至部分参数名都不一样。文中的代码都标了版本，混用会报错，不要凭记忆抄。

2. 源码级拆解：一帧是怎么被推出画布的

2.1 继承链与 apply_to_mask 装饰器

MoviePy 的特效体系不算复杂，一个特效本质上就是一个「接收 clip、返回新 clip」的对象。1.x 里它长得像一个被@apply_to_mask装饰过的函数，2.x 里被重构成了带apply方法的类，但底层的操作逻辑没变。

这里最关键的是apply_to_mask这个装饰器。视频片段对象可能带一个mask（遮罩），用来处理透明度、圆角、抠像之类的效果。如果只移动画面不移动遮罩，带透明区域的片段就会出现「画面飘走了、透明区域还留在原地」的诡异现象——表现为边缘出现不该有的黑块或者镂空。装饰器干的事情就是：把同一个特效自动应用一遍到 mask 上，保证两者完全同步。

这个细节看起来是内部实现，但它直接影响你的实操判断。当你看到「滑出之后边缘有一圈脏东西」或者「圆角矩形滑出去的时候角没跟着走」，八成就是遮罩没跟上。用官方特效的时候这个坑基本被堵死了；一旦你自己写位置函数、或者手工用fl_image改像素，这个同步就得自己负责。

顺带提一句，CompositeVideoClip在合成时会读取子 clip 的pos属性（可以是一个元组，也可以是一个接收时间、返回坐标的函数），然后按这个坐标把子片段的帧贴到大画布上。这就是 SlideOut 全部魔法的落点——它没有真的「移动像素」，而是每帧改变贴图的位置。理解这一点，后面很多现象就都能解释了。

2.2 side 参数到位移向量的映射

side只有四个合法取值："left"、"right"、"top"、"bottom"。它对应的是画面「往哪个方向跑掉」。

映射关系很直白，但有个容易搞混的点：side="left"意思是「从左边滑出去」，也就是片段最终停在画面左侧之外，位移向量是负的 x 方向；而side="right"是往右滑出去，位移是正的 x 方向。上下同理，"top"是向上滑走（y 为负），"bottom"是向下滑走（y 为正）。这一点和它在屏幕上「从哪边出现」的直觉正好相反，我见过不少人第一次用的时候方向写反，还以为是库的 bug。

位移的幅度是画面自身的尺寸，不是固定像素值。左右方向滑出，位移量等于片段的宽w；上下方向滑出，位移量等于片段的高h。这个设计很聪明：同一份代码，用在 1920×1080 的横屏素材和 1080×1920 的竖屏素材上，都能保证「刚好滑干净」，不会出现滑到一半停住或者滑过头留下大片空白。

但这里埋了一个和分辨率相关的隐患：位移距离变了，视觉速度就变了。同样是duration=1，横屏素材滑出去的瞬时速度是 1920 px/s，竖屏素材是 1080 px/s，后者的观感会「慢半拍」。这个换算后面 4.4 节会详细算。

2.3 duration 与时间轴：进度函数才是核心

duration这个参数名很容易被误解成「片段的时长」，实际上它指的是滑动过程持续的时间。这两者没有必然关系：一个 5 秒的片段，duration=1意味着它用 1 秒滑完，剩下 4 秒是不在画面里或者停在画面外的状态。

真正的核心是内部控制的那条进度曲线。用伪代码表达，位置函数大致长这样：

p = t / duration # 归一化进度 p = clamp(p, 0, 1) # 钳制到 [0, 1] position = (方向向量) * 位移量 * p

t是当前时间，p是线性插值系数。clamp那一步很关键——如果没有它，t超过duration之后p会大于 1，片段会被推到更远的地方，虽然视觉上看不见，但如果画布比片段大、或者你做了缩放叠加，就会露馅。有了钳制，滑完之后片段就「停」在画面外，不再继续跑。

这套线性推进的语义带来一个必须接受的现实：SlideOut 默认是从片段起点开始滑的。你把官方特效直接套到一个 10 秒的素材上、duration=2，那么它从第 0 秒就开始往外跑，2 秒后彻底消失，剩下 8 秒是空的。很多人第一次用会觉得「怎么一开头就滑没了」，原因就在这里。想要「最后两秒才滑出去」，官方特效的语义满足不了，得自己写位置函数，这就是 4.1 节的内容。

不同版本的实现细节会有出入，有的版本为了兼容可能对时长的处理略有不同。稳妥的做法是先拿一个 2 秒的测试片段跑一遍，肉眼看清楚它在哪个时间点开始动、什么时候停。

2.4 手写一个等价实现

看懂原理之后，自己实现一遍是最快的掌握方式，也方便后续加缓动。下面这段是 1.x 风格的最小实现，可以直接当自定义特效的函数用：

# 兼容 moviepy 1.x 的等价实现 from moviepy.editor import VideoFileClip, ColorClip, CompositeVideoClip def slide_out(clip, side="left", duration=1.0): w, h = clip.size d = max(float(duration), 1e-6) # 防止除零 vec = { "left": (-w, 0), "right": (w, 0), "top": (0, -h), "bottom": (0, h), }[side] def pos(t): p = t / d p = 0.0 if p < 0 else (1.0 if p > 1 else p) return (vec[0] * p, vec[1] * p) return clip.set_position(pos)

几个细节值得说。

第一，d = max(float(duration), 1e-6)这句不是多余的。duration=0会导致除零，而duration传成一个很小的正数时，进度会在第一帧就冲到 1，画面瞬间消失。这个保护在实际批量处理里救过我几次——有一批素材是从表格里读参数生成的，某一行的时长列是空的，读出来成了 0。

第二，set_position接收的函数返回的是相对于合成画布左上角的坐标。原始位置是(0, 0)，所以位移向量直接就是目标坐标，不用再做偏移。但如果你在片段上额外设过位置（比如为了让它在画面里居中），就得先算清楚基准点，别直接覆盖。

第三，这个函数返回的是新 clip，原 clip 不受影响（MoviePy 大多数方法都是这样，返回副本），所以同一个源素材可以复用多次、套不同方向的效果。

想要更自然的运动，把p换成缓动函数就行，最省事的是 smoothstep：

p = p * p * (3 - 2 * p) # 起止更柔和，中段更快

线性匀速的运动在视觉上其实是「两头急、中间平」，因为人眼对加减速很敏感。加上 smoothstep 之后，滑出会有一个轻微的加速和收尾减速，观感提升很明显，尤其在做片头的时候。

3. 环境准备与第一个能跑的示例

3.1 版本差异：fx() 与 with_effects()

这是最容易卡住新手的地方，先讲清楚。

1.x 的写法是函数式的，特效在moviepy.video.fx.all里，用小写名字调用：

from moviepy.editor import VideoFileClip from moviepy.video.fx.all import slide_out clip = VideoFileClip("input.mp4").fx(slide_out, side="left", duration=1)

2.x 改成了面向对象，特效是类，通过with_effects挂到片段上：

from moviepy import VideoFileClip, vfx clip = VideoFileClip("input.mp4").with_effects([vfx.SlideOut(side="left", duration=1)])

注意两处不同：一是导入位置从moviepy.editor变成了moviepy，二是类名首字母大写。如果你在网上抄到一段代码报ModuleNotFoundError: No module named 'moviepy.editor'，说明你装的是 2.x 却抄了 1.x 的代码；反过来报cannot import name 'vfx'就是装的老版本。

装的时候建议锁版本，别让它自己飘：

# 1.x 路线 pip install "moviepy<2" # 2.x 路线 pip install "moviepy>=2"

with_effects之所以比老的.fx()更好用，是因为它可以一次挂多个特效，按列表顺序执行。这个特性在组合动画的时候非常方便，比如同时滑出加淡出，一句话搞定，不用嵌套调用。后面 4.3 节会用到。

3.2 最小可运行 demo

下面是能直接出片的完整代码，1.x 版本：

from moviepy.editor import VideoFileClip, ColorClip, CompositeVideoClip from moviepy.video.fx.all import slide_out src = VideoFileClip("input.mp4") # 假设 1920x1080 w, h = src.size dur = src.duration # 底层画布，必须有，否则滑开之后是黑的 bg = ColorClip(size=(w, h), color=(18, 18, 18)).set_duration(dur) # 让素材从左侧滑出去 moving = src.fx(slide_out, side="left", duration=1.2) final = CompositeVideoClip([bg, moving], size=(w, h)) final.write_videofile("out.mp4", fps=src.fps, codec="libx264", audio_codec="aac")

2.x 版本，逻辑一样，只是 API 换了：

from moviepy import VideoFileClip, ColorClip, CompositeVideoClip, vfx src = VideoFileClip("input.mp4") w, h = src.size bg = ColorClip(size=(w, h), color=(18, 18, 18), duration=src.duration) moving = src.with_effects([vfx.SlideOut(side="left", duration=1.2)]) final = CompositeVideoClip([bg, moving], size=(w, h)) final.write_videofile("out.mp4", fps=src.fps, codec="libx264", audio_codec="aac")

这段代码里有三个必须理解的要点，缺一个就出不了效果。

必须包在 CompositeVideoClip 里。set_position改变的是片段在「合成画布」上的贴图坐标，如果你直接对单个 clip 调用write_videofile，它压根没有画布的概念，位置属性被忽略，输出跟原片一模一样。这是最常见的「我明明加了特效但没效果」的原因。

必须有底层。画布默认是透明的（bg_color=None），mp4 不支持 alpha 通道，透明区域在编码时会被压成黑色。所以你会看到画面滑走之后露出一片纯黑。有两个解决办法：一是给CompositeVideoClip传bg_color，二是像上面那样垫一层ColorClip。我更推荐后者，因为bg_color在不同版本里的行为不完全一致，垫一层实体颜色图层最稳，而且你随时可以把这层换成另一段视频、一张图片或者一个渐变色块，做出「拉开后露出下一幕」的效果。

滑完之后的画面要提前想好。上面这个 demo 里，片段 1.2 秒后滑没了，后面全是纯色背景，其实相当于一种「淡出到背景色」的转场。如果你要的是「滑开露出下一段视频」，底层就放下一段视频，配合set_start对齐时间点。

3.3 参数实测对照

我把几个常用参数组合跑了一遍，横屏 1920×1080、30fps、时长 5 秒的素材，结果大致如下，可以直接当参考表用：

几点实测感受。duration低于 0.25 秒的时候，30fps 下位移跨度太大，一帧就要移 300 多像素，人眼能看出明显的「台阶」；如果一定要这么快，建议把素材先降到较低分辨率再放大，或者干脆改用硬切加轻微缩放。duration超过 2 秒时，观众会开始觉得「它在慢慢挪」，这时的动作已经不像转场，更像运镜了，用在片头可以，用在段落之间会打断节奏。

方向的选择上，横向滑出（left/right）在横屏素材里更自然，因为人眼习惯了左右扫视；纵向滑出（top/bottom）在竖屏素材里更自然，同理。反过来用不是不行，但会有一点别扭感，这个属于经验范畴，多试两遍就有感觉了。

4. 四个真实需求场景的落地写法

4.1 需求一：只让最后 1 秒滑出

这是被问得最多的问题。官方 SlideOut 从片段起点开始滑，而实际剪辑里九成的情况是「让画面在结束前滑走」。解决办法是自己定义位置函数，把进度映射到片段的最后一个区间。

def tail_slide(clip, side="left", d=1.0, ease=True, offset=0.0, debug=False): """ clip : 待处理片段 side : left / right / top / bottom d : 滑出过程时长（秒），从片段末尾往前算 offset : 位置函数的时间基准偏移，见下方说明 """ w, h = clip.size total = float(clip.duration) start = max(0.0, total - d) span = max(total - start, 1e-6) dx = {"left": -w, "right": w}.get(side, 0) dy = {"top": -h, "bottom": h}.get(side, 0) def pos(t): t_local = float(t) - offset if debug: print("pos t_local =", round(t_local, 3)) p = 0.0 if t_local <= start else min(1.0, (t_local - start) / span) if ease: p = p * p * (3 - 2 * p) return (dx * p, dy * p) return clip.set_position(pos)

用法：

moving = tail_slide(src, side="left", d=1.0) final = CompositeVideoClip([bg, moving], size=(w, h))

关键在那个offset参数，它牵扯到 MoviePy 里一个很隐蔽的行为差异：位置函数收到的t到底是合成时间轴上的全局时间，还是片段自己的内部时间。这两种情况我都遇到过，跟版本、跟有没有用set_start都有关系。

最稳的判断方式是打开debug=True，跑一个两秒的测试片段，看打印出来的t范围。如果片段是set_start(1)加上去的、时长 2 秒，打印出来是 1.0 到 3.0，那t就是全局时间，offset要设成 1.0；如果打印出来是 0 到 2 秒附近，那t是局部时间，offset保持 0。这个探针写法我建议写在你的模板文件里，省得每次重新试。

还有一个坑：d大于片段总时长的时候，start会被max限到 0，效果就退化成「全程滑动」，跟直接用官方特效一样。所以设d之前先看一眼片段时长，别盲目填。

4.2 需求二：左右双开门加底层画面

「双开门」是滑动特效用得最漂亮的一种组合：上下两段素材同时向两侧滑开，露出中间的主画面或者一张标题卡。实现上就是用两个 CompositeVideoClip 子片段，各自套不同的 side。

from moviepy.editor import VideoFileClip, ColorClip, CompositeVideoClip from moviepy.video.fx.all import slide_out top_clip = VideoFileClip("a.mp4") # 上半部分素材 bot_clip = VideoFileClip("b.mp4") # 下半部分素材 w, h = top_clip.size # 各自裁成一半高度，拼成完整画面 half_top = top_clip.crop(y1=0, y2=h // 2).set_position(("center", 0)) half_bot = bot_clip.resize((w, h // 2)).set_position(("center", h // 2)) # 两半分别往左上、左下? 不, 上下开门: 上半往上, 下半往下 half_top = half_top.fx(slide_out, side="top", duration=1.0) half_bot = half_bot.fx(slide_out, side="bottom", duration=1.0) # 底层：一张标题卡 back = ColorClip(size=(w, h), color=(10, 10, 10)).set_duration(3) final = CompositeVideoClip([back, half_top, half_bot], size=(w, h))

实际用的时候有几个地方要注意。裁剪之后位置必须显式设置，crop只会改变画面内容，不会改变贴图位置，不设的话两半会叠在左上角。set_position支持"center"这样的字符串，也支持(x, y)元组，但对裁剪后的片段用字符串居中要小心，居中的基准是这块裁剪后的尺寸，不是原画面尺寸。

另外，上下两半如果来自不同的素材，滑开之后的露底时间点要一致，否则会出现「一半还在、一半已经开了」的错位感。做法是把两个半段的set_duration都设成同一个值，滑出的duration也保持一致，视觉上才像一扇门。

横向双开门同理，把 side 换成 left/right，裁剪改成crop(x1=0, x2=w // 2)和crop(x1=w // 2)，位置分别设在左右两半。

4.3 需求三：滑出同时淡出，字幕和音频同步

单纯的滑动有时候会显得干，尤其是画面内容本身比较平的时候。叠一层透明度变化，画面会「轻」很多。2.x 里用with_effects一行搞定：

moving = src.with_effects([ vfx.SlideOut(side="right", duration=1.0), vfx.FadeOut(1.0), ])

1.x 里的等价写法是嵌套调用：

from moviepy.video.fx.all import slide_out, fadeout moving = src.fx(slide_out, side="right", duration=1.0).fx(fadeout, 1.0)

顺序其实有讲究。先滑出再淡出，意味着片段在滑动的过程中透明度基本不变，滑到一半时透明度才开始明显下降；先淡出再滑出，则是透明度先掉、位置后动。视觉上我更推荐同时开始，也就是两个效果的持续时间一样、起点一样，这样画面在「跑」的同时「化」，退场感最自然。如果一定要错开，让淡出比滑动晚 0.1 到 0.2 秒开始，会显得更柔和一点。

音频这块是个容易被忽略的问题。画面滑走了，声音不会自动跟着走，如果原素材有音轨，你会听到「画面已经空了几秒，声音还在响」。有两条路：一是给片段挂audio_fadeout，让音量在同样的时长内降到 0；二是直接把片段音轨裁掉，用背景音乐顶上。前者的写法是：

if src.audio is not None: moving = moving.set_audio(src.audio.audio_fadeout(1.0))

字幕和图层的同步逻辑一样：只要字幕也是 CompositeVideoClip 的一个子元素，它不会跟着视频片段滑动，需要单独处理。实际剪辑里通常的做法是让字幕在滑动开始前 0.2 秒先消失，别让它跟着画面一起被推走——文字被推着跑看起来很不专业。

4.4 需求四：竖屏与超宽画布的速度换算

前面提过，位移距离等于画面尺寸，所以不同分辨率下同样的duration会得到不同的视觉速度。这个差异在横竖屏混剪的项目里特别明显：横屏素材滑得飞快，竖屏素材慢悠悠，接在一起会非常出戏。

换算不复杂，核心是让视觉速度（单位时间移动的像素数）保持一致：

v = 距离 / duration

举例。假设你在 1920×1080 的横屏项目里用duration=0.8，得到的速度是1920 / 0.8 = 2400 px/s。现在换成 1080×1920 的竖屏素材，也想让观众感受到 2400 px/s 的速度，那duration应该是1080 / 2400 = 0.45秒。反过来，如果竖屏素材想让它「慢一点、更从容」，按 1500 px/s 的速度算，duration = 1080 / 1500 = 0.72秒。

这个公式看着简单，但真正用起来还有个隐性的约束：帧率。位移是逐帧离散的，30fps 下duration=0.45意味着每帧移动1080 / (0.45 × 30) = 80像素，还算流畅；如果duration压到 0.2，每帧要移动 180 像素，画面会明显「跳格」。我的经验阈值是：单帧位移控制在 100 像素以内观感最稳，超过 150 就会开始有台阶感。

所以实际做多分辨率混剪时，我会写一个小工具函数把这两个约束都算进去：

def calc_duration(size, side, target_speed=1800, fps=30, max_step=100): w, h = size dist = w if side in ("left", "right") else h d_by_speed = dist / target_speed d_by_step = dist / (max_step * fps) # 单帧位移不超过 max_step return max(d_by_speed, d_by_step) # 取较慢的那个, 保证观感

拿 1920×1080、target_speed=1800、30fps 算一下：d_by_speed = 1920/1800 ≈ 1.07，d_by_step = 1920/(100×30) = 0.64，取较大值 1.07。也就是说这个尺寸下 1 秒左右滑出去最稳。换到 1080×1920 的竖直方向：d_by_speed = 1920/1800 ≈ 1.07，d_by_step = 0.64，结果一样。但如果竖屏也做左右滑出，距离变成 1080，d_by_speed = 0.6，d_by_step = 0.36，取 0.6——明显比横屏快，这时候就得主动把target_speed调低，让它和横屏镜头的感觉对齐。

5. 性能、画质与批量处理的坑

5.1 渲染耗时到底花在哪

滑动效果本身的计算量很小，就是个坐标乘法，真正耗时的是每帧重新合成贴图。MoviePy 的合成流程是：取每个子片段的当前帧（PIL Image 对象）、按位置贴到大画布、处理遮罩、转回 numpy 数组给编码器。这个流程在加了 SlideOut 之后并不会变慢——因为不管你滑不滑，合成都得做一遍。

真正拖慢速度的是另外三件事。

一是画布尺寸。合成画布的像素量直接决定每帧的贴图开销，4K 画布比 1080p 慢四倍左右。如果你的滑出效果只占全片很短一段，没必要用 4K 画布，先按 1080p 做完再统一放大。

二是子片段数量。如果时间轴上有 20 个片段，哪怕大部分时刻只有一个在显示，CompositeVideoClip 也可能要在每帧遍历判断一遍。MoviePy 内部有start <= t < end的过滤，但判断本身仍有成本。把不在当前时间段出现的片段提前close()掉，或者分批合成再拼接，能省不少。

三是编码参数。preset从"medium"调到"ultrafast"，速度能快两三倍，代价是文件变大。做草稿阶段用 ultrafast，出终版再换回来。

我自己测过一组数据，仅供参考量级：1080p、30fps、10 秒的素材加滑出特效，preset="medium"大概 25 到 35 秒出片，preset="ultrafast"大概 10 秒出头。机器的 CPU 核心数影响很大，threads参数可以手动指定，默认通常够用。

5.2 边缘锯齿、抖动、黑边

锯齿主要出现在斜向滑出的时候——但 SlideOut 只有四个正方向，理论上不该有锯齿。如果你看到了，多半是叠加了旋转或者缩放，插值算法没跟上。解决办法是关掉叠加的缩放，或者先把素材放大一点再滑，让边缘落在画布之外。

抖动有两种来源。一种是位置计算用了不连续的分段函数，比如在某个时间点突然切换方向，导致跳帧；这种要检查位置函数里有没有if/else分支在中间跳变。另一种是t的浮点精度问题，在长时间轴上t累加到几万秒时，浮点误差会让位置出现微小跳动；这种几乎遇不到，真遇到了把时间基准归零即可。

黑边是最常见的现象，前面提过原因：滑开之后露出的是透明画布，mp4 把透明编码成黑色。除了垫底层，还有一种情况会产生黑边：片段本身尺寸比画布小。比如你把一个 1280×720 的素材放到 1920×1080 的画布里，即使不滑动，四周也是黑的。这时候要么先resize到铺满，要么接受留黑边做「画中画」风格。判断方法很简单：不加任何特效，先输出一帧看看有没有黑边，有的话就是尺寸问题，跟 SlideOut 无关。

还有一种隐蔽的黑边来自遮罩不同步。带 alpha 的素材（比如带透明背景的 PNG 序列、带圆角的卡片）滑出去时，如果遮罩没跟着动，画面走了但遮罩留在原地，会露出一块不该出现的形状。1.x 里官方特效靠@apply_to_mask处理了这个问题，自己写位置函数的时候则不用管——因为遮罩和画面共享同一个pos，会自动同步。真正会出问题的是手工改像素的方案。

5.3 批量任务的写法与内存控制

一条片子手动调没问题，十条二十条就得脚本化。批量处理 SlideOut 的核心是把「参数」和「执行」分开：参数写在一个列表里，循环读取，逐个渲染。

import os from moviepy.editor import VideoFileClip, ColorClip, CompositeVideoClip jobs = [ {"src": "a.mp4", "side": "left", "d":