标注 | 说明 | 数据类型 |
输入视频文件 | 采用任意受支持视频文件格式的输入视频文件,包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、H265、VOB 和 M2TS。 | File |
输出文件夹 | 将保存输出影像和元数据的文件目录。 | Folder |
图像类型 (可选) | 指定输出图像格式。
| String |
最大重叠百分比 (可选) | 两张图像之间的最大重叠百分比。 如果候选图像和写入磁盘的最后一张图像之间的重叠大于此值,则将忽略候选图像。 默认百分比为 100%,表示会将所有图像写入磁盘。 | Double |
需要新元数据 (可选) | 指定是否将提取和保存具有相关元数据的视频帧。
| Boolean |
要素之间的最短时间 (可选) | 要保存的视频帧之间的最小时间间隔。 如果未指定值,则所有视频帧将另存为图像。 | Time Unit |
获得 Image Analyst 许可后可用。
摘要
从兼容 FMV 的视频流中提取并保存视频帧影像和相关元数据。 可将所提取的图像添加到镶嵌数据集或其他工具和函数中,以供进一步分析。
使用情况
此工具仅适用于已存档视频数据。 不支持实时流视频。
兼容 FMV 的视频流中的影像将以 TIFF、NITF 或 JPEG 格式提取并存储在目录中。
与视频影像相关的元数据将写入相同目录中的逗号分隔值文件 (.csv)。
参数
ExtractVideoFramesToImages(in_video, out_folder, {image_type}, {image_overlap}, {require_fresh_metadata}, {min_time})
名称 | 说明 | 数据类型 |
in_video | 采用任意受支持视频文件格式的输入视频文件,包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、H265、VOB 和 M2TS。 | File |
out_folder | 将保存输出影像和元数据的文件目录。 | Folder |
image_type (可选) | 指定输出图像格式。
| String |
image_overlap (可选) | 两张图像之间的最大重叠百分比。 如果候选图像和写入磁盘的最后一张图像之间的重叠大于此值,则将忽略候选图像。 默认百分比为 100%,表示会将所有图像写入磁盘。 | Double |
require_fresh_metadata (可选) | 指定是否将提取和保存具有相关元数据的视频帧。
| Boolean |
min_time (可选) | 要保存的视频帧之间的最小时间间隔。 如果未指定值,则所有视频帧将另存为图像。 | Time Unit |
代码示例
此示例从视频流中提取视频帧图像和关联的元数据,并将数据保存到目录中。
arcpy.ia.ExtractVideoFramesToImages(r"c:\test\video.ts", r"C:\temp2\outimages",
"TIFF", 100, "", "20 Seconds")
此示例从视频流中提取视频帧图像和关联的元数据,并将数据保存到目录中。
import arcpy
from arcpy.ia import *
arcpy.CheckOutExtension("ImageAnalyst")
in_video = "c:\\test\\drone_vid.ts"
out_folder = "c:\\output"
outformat = "NITF"
maxoverlap = 100
requirefreshmeta = “REQUIRE_FRESH_METADATA”
mintimebetween = "1 minute"
arcpy.ia.ExtractVideoFramesToImages(in_video, out_folder, outformat, maxoverlap,
requirefreshmeta, mintimebetween)
环境
此工具不使用任何地理处理环境。