将视频帧提取为图像 (影像分析)

获得 Image Analyst 许可后可用。

摘要

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

使用情况

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

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

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

参数

对话框

标注	说明	数据类型
输入视频文件	所有受支持的视频文件格式的输入视频文件，包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、VOB 和 M2TS。	File
输出文件夹	将用于保存输出图像和元数据的文件目录。	Folder
图像类型	指定输出图像格式。 JPEG—将以 JPEG 图像格式输出。 TIFF—将以 TIFF 图像格式输出。 这是默认设置。 NITF—将以 NITF 图像格式输出。	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、VOB 和 M2TS。	File
out_folder	将用于保存输出图像和元数据的文件目录。	Folder
image_type	指定输出图像格式。 JPEG—将以 JPEG 图像格式输出。 TIFF—将以 TIFF 图像格式输出。 这是默认设置。 NITF—将以 NITF 图像格式输出。	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)

环境

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