将视频帧提取为图像 (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

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)

环境

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

相关主题