将视频帧提取为图像 (Image Analyst)

获得 Image Analyst 许可后可用。

摘要

从兼容 FMV 的视频流中提取并保存视频帧影像和相关元数据。 可将所提取的图像添加到镶嵌数据集或其他工具和函数中，以供进一步分析。

使用情况

• 此工具仅适用于已存档视频数据。 不支持实时流视频。

• 兼容 FMV 的视频流中的影像将以 TIFF、NITF 或 JPEG 格式提取并存储在目录中。

• 与视频影像相关的元数据将写入相同目录中的逗号分隔值文件 (.csv)。

参数

对话框

标注	说明	数据类型
输入视频文件	采用任意受支持视频文件格式的输入视频文件，包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、H265、VOB 和 M2TS。	File
输出文件夹	将保存输出影像和元数据的文件目录。	Folder
图像类型 (可选)	指定输出图像格式。 JPEG—输出将采用 JPEG 图像格式。 TIFF—输出将采用 TIFF 图像格式。 这是默认设置。 NITF—输出将采用 NITF 图像格式。 PNG—输出将采用 PNG 图像格式。	String
最大重叠百分比 (可选)	两张图像之间的最大重叠百分比。 如果候选图像和写入磁盘的最后一张图像之间的重叠大于此值，则将忽略候选图像。 默认百分比为 100%，表示会将所有图像写入磁盘。	Double
需要新元数据 (可选)	指定是否将提取和保存具有相关元数据的视频帧。 选中 - 将仅保存具有相关元数据的视频帧。 未选中 - 将保存所有视频帧。 这是默认设置。	Boolean
要素之间的最短时间 (可选)	要保存的视频帧之间的最小时间间隔。 如果未指定值，则所有视频帧将另存为图像。	Time Unit

Python

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 (可选)	指定输出图像格式。 JPEG—输出将采用 JPEG 图像格式。 TIFF—输出将采用 TIFF 图像格式。 这是默认设置。 NITF—输出将采用 NITF 图像格式。 PNG—输出将采用 PNG 图像格式。	String
image_overlap (可选)	两张图像之间的最大重叠百分比。 如果候选图像和写入磁盘的最后一张图像之间的重叠大于此值，则将忽略候选图像。 默认百分比为 100%，表示会将所有图像写入磁盘。	Double
require_fresh_metadata (可选)	指定是否将提取和保存具有相关元数据的视频帧。 REQUIRE_FRESH_METADATA—将仅保存具有相关元数据的视频帧。 NO_REQUIRE_FRESH_METADATA—将保存所有视频帧。 这是默认设置。	Boolean
min_time (可选)	要保存的视频帧之间的最小时间间隔。 如果未指定值，则所有视频帧将另存为图像。	Time Unit

代码示例

ExtractVideoFramesToImages 视频 1（Python 窗口）

此示例从视频流中提取视频帧图像和关联的元数据，并将数据保存到目录中。

arcpy.ia.ExtractVideoFramesToImages(r"c:\test\video.ts", r"C:\temp2\outimages",
"TIFF", 100, "", "20 Seconds")

ExtractVideoFramesToImages 示例 2（独立脚本）

此示例从视频流中提取视频帧图像和关联的元数据，并将数据保存到目录中。

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)

环境

此工具不使用任何地理处理环境。