Concatenates multiple video files into a single output file.
Supports optional xfade transition when concatenating exactly two videos.
Args:
video_paths: A list of paths to the video files to concatenate.
output_video_path: The path to save the concatenated video file.
transition_effect (str, optional): The xfade transition type. Options:
- 'dissolve': Gradual blend between clips
- 'fade': Simple fade through black
- 'fadeblack': Fade through black
- 'fadewhite': Fade through white
- 'fadegrays': Fade through grayscale
- 'distance': Distance transform transition
- 'wipeleft', 'wiperight': Horizontal wipe
- 'wipeup', 'wipedown': Vertical wipe
- 'slideleft', 'slideright': Horizontal slide
- 'slideup', 'slidedown': Vertical slide
- 'smoothleft', 'smoothright': Smooth horizontal slide
- 'smoothup', 'smoothdown': Smooth vertical slide
- 'circlecrop': Rectangle crop transition
- 'rectcrop': Rectangle crop transition
- 'circleopen', 'circleclose': Circle open/close
- 'vertopen', 'vertclose': Vertical open/close
- 'horzopen', 'horzclose': Horizontal open/close
- 'diagtl', 'diagtr', 'diagbl', 'diagbr': Diagonal transitions
- 'hlslice', 'hrslice': Horizontal slice
- 'vuslice', 'vdslice': Vertical slice
- 'pixelize': Pixelize effect
- 'radial': Radial transition
- 'hblur': Horizontal blur
Only applied if exactly two videos are provided. Defaults to None (no transition).
transition_duration (float, optional): The duration of the xfade transition in seconds.
Required if transition_effect is specified. Defaults to None.
Returns:
A status message indicating success or failure.