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

获得 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、VOB 和 M2TS。

File
out_folder

将用于保存输出图像和元数据的文件目录。

Folder
image_type

输出图像格式。

  • JPEGJPEG 图像格式。
  • TIFFTIFF 图像格式。这是默认设置。
  • NITFNITF 图像格式。
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)

环境

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

许可信息

  • Basic: 需要 Image Analyst
  • Standard: 需要 Image Analyst
  • Advanced: 需要 Image Analyst

相关主题