Video Transition / 视频转场#

视频转场效果工具，使用 ffmpeg xfade 滤镜实现平滑转场。

支持的转场效果#

转场类型英文名效果描述淡入淡出fade画面逐渐过渡左滑slideleft新画面从右侧滑入右滑slideright新画面从左侧滑入上滑slideup新画面从下方滑入下滑slidedown新画面从上方滑入圆形展开circleopen圆形遮罩展开左擦除wipeleft从右向左擦除右擦除wiperight从左向右擦除距离distance距离渐变像素化pixelize像素化过渡对角线diagtl/ diagtr对角线擦除矩形rectcrop矩形裁剪

快速使用#

1. 合并视频带转场#

python

from video_transition import concat_with_transitions

# 合并视频片段，自动添加转场
concat_with_transitions(
    video_paths=["clip1.mp4", "clip2.mp4", "clip3.mp4"],
    output_path="output.mp4",
    transition_duration=0.5
)

2. 单个转场效果#

python

from video_transition import apply_transition

# 在两个视频之间应用特定转场
apply_transition(
    video1="intro.mp4",
    video2="main.mp4",
    output="merged.mp4",
    transition="fade",
    duration=0.5
)

3. 批量添加淡入淡出#

python

from video_transition import add_fade_to_clips

# 为所有片段添加淡入淡出
add_fade_to_clips(
    input_dir="clips/",
    output_dir="faded/",
    fade_in=0.3,
    fade_out=0.3
)

参数说明#

concat_with_transitions()#

参数类型默认值说明video_pathslist-视频路径列表output_pathstr-输出路径transition_durationfloat0.5转场时长（秒）transitionslist循环使用所有转场类型列表auto_fadeboolTrue是否自动添加淡入淡出

apply_transition()#

参数类型默认值说明video1str-第一个视频video2str-第二个视频outputstr-输出路径transitionstr"fade"转场类型durationfloat0.5转场时长offsetfloat自动计算转场起始时间

依赖#

text

ffmpeg >= 4.0

技术原理#

使用 ffmpeg 的 xfade 滤镜实现视频转场：

bash

ffmpeg -i clip1.mp4 -i clip2.mp4 \
  -filter_complex "[0:v][1:v]xfade=transition=fade:duration=0.5:offset=5[outv]" \
  -map "[outv]" output.mp4

触发词#

视频转场、 转场效果、 xfade、 视频合并、 淡入淡出

文件结构#

text

video-transition/
├── SKILL.md              # 技能说明
├── README.md             # 详细文档
├── video_transition.py   # 核心模块
├── example.py            # 使用示例
└── package.json          # 包信息

License#

MIT

Author#

systiger