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

获得 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

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)

环境

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