在上一篇文章(按场景进行分割视频的工具——PySceneDetect。
下面开始介绍下PySceneDetect及其安装使用方法。
1. 什么是PySceneDetect
PySceneDetect是一个命令行工具和Python库,用于分析视频,查找场景更改或剪辑。
PySceneDetect集成了外部工具(例如mkvmerge , ffmpeg ),可在使用split-video命令时自动将视频分割为单个片段。还可以为视频生成逐帧分析,称为统计文件,以帮助确定最佳阈值或检测特定视频的模式/其他分析方法。
PySceneDetect使用两种主要的检测方法: detect-threshold (将每个帧与设置的黑电平进行比较,对于检测从黑色到黑色的淡入和淡出有用)和detect-content (比较每个帧,依次查找内容的变化,有用)用于检测视频场景之间的快速切换,尽管处理速度较慢)。每种模式的参数略有不同,并在文档中进行了详细说明.。
通常,如果要使用淡入/淡出/切成黑色来检测场景边界,请使用检测阈值模式。如果视频在内容之间使用大量快速剪切,并且没有明确定义的场景边界,则应使用" 检测内容"模式。一旦知道要使用哪种检测模式,就可以尝试以下建议的参数,或生成统计文件(使用-s / –stats参数),以确定正确的参数-具体来说,是正确的阈值.
2. PySceneDetect的安装
PySceneDetect依赖于Python模块numpy,OpenCV(cv2模块)和tqdm(进度条模块,用来显示处理进度),安装命令如下:
$ pip install scenedetect
PySceneDetect基于ffmpeg和mkvmerge对视频进行裁剪。ffmpeg 是一个开源软件,可以运行音频和视频多种格式的录影、转换、流功能,它功能强大,用途广泛,是视频处理最常用的开源软件。
mkvmerge是MKV工具集MKVToolNix中的一个软件,可以将多媒体文件封装、合并、混流为 MKV 文件。
安装完成后可以通过命令行或代码两种方式进行使用。
3. 命令行使用
PySceneDetect在命令行中使用scenedetect命令进行操作,命令格式如下:
$ scenedetect --input my_video.mp4 --output my_video_scenes --stats my_video.stats.csv detect-content list-scenes save-images
参数说明:
常用的参数说明如下:–input :输入视频文件的路径
–output :指定输出目录(可选)
–stats:生成统计文件(可选)
time:用于设置输入视频持续时间/长度或开始/结束时间。
detect-content:切分视频基于内容检测算法。
detect-threshold:切分视频基于阈值检测算法。
list-scenes:打印场景列表并输出到CSV文件。
save-images:为每个场景保存视频中的图像。
split-video:使用ffmpeg或mkvMerge对视频进行分割。
完整的参数列表可使用scenedetect help all命令进行查看。
示例:
$ scenedetect --input demo.mp4 detect-content list-scenes save-images split-video
运行完成后会在当前文件夹生成视频片段,片段截图以及csv文件,如下:
demo-Scene-001-01.jpg demo-Scene-004-03.jpg ...
demo-Scene-001-02.jpg demo-Scene-004.mp4
...
demo-Scenes.csv
csv文件中包含片段的帧、时间、长度等信息,内容如下:
Timecode List: 00:07.9 00:14.6 00:38.7 00:45.3 00:48.9 01:00.0 01:12.3 01:21.5 01:36.3
Scene Number Start Frame Start Timecode Start Time (seconds) End Frame End Timecode End Time (seconds) Length (frames) Length (timecode) Length (seconds)
1 0 00:00.0 0 190 00:07.9 7.917 190 00:07.9 7.917
2 190 00:07.9 7.917 350 00:14.6 14.583 160 00:06.7 6.667
3 350 00:14.6 14.583 928 00:38.7 38.667 578 00:24.1 24.083
...
4. 在Python中使用
在Python中使用PySceneDetect主要用到下面几个类:VideoManager:用于加载视频并提供搜索;
SceneManager:用于协调SceneDetector,VideoManager和可选的StatsManager对象的高级管理器;
FrameTimecode:用于存储时间码以及对时间码值进行算术运算(加/减/比较),并具有帧级的精确度;
StatsManager:用于存储/缓存帧指标,以加快在同一视频上后续场景检测的运行速度,并可以保存到CSV文件或从CSV中加载缓存;
SceneDetector:用于实现检测算法的基类,如ContentDetector,ThresholdDetector等。
官方的示例代码如下:
from __future__ import print_function
import os
import scenedetect
from scenedetect.video_manager import VideoManager
from scenedetect.scene_manager import SceneManager
from scenedetect.frame_timecode import FrameTimecode
from scenedetect.stats_manager import StatsManager
from scenedetect.detectors import ContentDetector
STATS_FILE_PATH = 'testvideo.stats.csv'
def main():
# Create a video_manager point to video file testvideo.mp4. Note that multiple
# videos can be appended by simply specifying more file paths in the list
# passed to the VideoManager constructor. Note that appending multiple videos
# requires that they all have the same frame size, and optionally, framerate.
video_manager = VideoManager(['testvideo.mp4'])
stats_manager = StatsManager()
scene_manager = SceneManager(stats_manager)
# Add ContentDetector algorithm (constructor takes detector options like threshold).
scene_manager.add_detector(ContentDetector())
base_timecode = video_manager.get_base_timecode()
try:
# If stats file exists, load it.
if os.path.exists(STATS_FILE_PATH):
# Read stats from CSV file opened in read mode:
with open(STATS_FILE_PATH, 'r') as stats_file:
stats_manager.load_from_csv(stats_file, base_timecode)
start_time = base_timecode + 20 # 00:00:00.667
end_time = base_timecode + 20.0 # 00:00:20.000
# Set video_manager duration to read frames from 00:00:00 to 00:00:20.
video_manager.set_duration(start_time=start_time, end_time=end_time)
# Set downscale factor to improve processing speed.
video_manager.set_downscale_factor()
# Start video_manager.
video_manager.start()
# Perform scene detection on video_manager.
scene_manager.detect_scenes(frame_source=video_manager)
# Obtain list of detected scenes.
scene_list = scene_manager.get_scene_list(base_timecode)
# Like FrameTimecodes, each scene in the scene_list can be sorted if the
# list of scenes becomes unsorted.
print('List of scenes obtained:')
for i, scene in enumerate(scene_list):
print(' Scene %2d: Start %s / Frame %d, End %s / Frame %d' % (
i+1,
scene[0].get_timecode(), scene[0].get_frames(),
scene[1].get_timecode(), scene[1].get_frames(),))
# We only write to the stats file if a save is required:
if stats_manager.is_save_required():
with open(STATS_FILE_PATH, 'w') as stats_file:
stats_manager.save_to_csv(stats_file, base_timecode)
finally:
video_manager.release()
if __name__ == "__main__":
main()Python Interface & Integration With Other Applicationspyscenedetect.readthedocs.io