| 标注 | 说明 | 数据类型 |
输入视频文件 | 所有受支持的视频文件格式的输入视频文件，包括 .av1、.avi、.csv、.gpx、.h264、.h265、.json、.mp2、.mp4、.m2ts、.mpeg、.mpeg2、.mpeg4、.mpg、.mpg2、.mpg4、.ps、.ts、.vob 和 .wmv。 | File |
输出文件夹 | 将用于保存输出图像和元数据的文件目录。 | Folder |
图像类型 (可选) | 指定输出图像格式。
| String |
最大重叠百分比 (可选) | 两个图像之间的最大重叠百分比。 如果候选图像与写入到磁盘的最后一个图像之间的重叠大于该值，则将忽略此候选图像。 默认百分比为 100%，此时会将所有图像写入磁盘。 | Double |
需要新元数据 (可选) | 指定是否仅提取和保存具有关联元数据的视频帧。
| Boolean |
要素间最小时间 (可选) | 将保存的视频帧之间的最小时间间隔。 如果未提供任何值，则所有视频帧将另存为图像。 | Time Unit |
获得 Image Analyst 许可后可用。
摘要
从兼容全动态视频 (FMV) 的视频流中提取并保存视频帧影像和相关元数据。 可将所提取的图像添加到镶嵌数据集或其他工具和函数中，以供进一步分析。
使用情况
此工具仅适用于存档视频数据。 不支持实时流视频。
兼容 FMV 的视频流中的影像将以 TIFF、NITF 或 JPEG 格式提取并存储在目录中。
与视频影像关联的元数据将被写入同一目录下的逗号分隔值文件 (.csv) 中。
参数
ExtractVideoFramesToImages(in_video, out_folder, {image_type}, {image_overlap}, {require_fresh_metadata}, {min_time})| 名称 | 说明 | 数据类型 |
in_video | 所有受支持的视频文件格式的输入视频文件，包括 .av1、.avi、.csv、.gpx、.h264、.h265、.json、.mp2、.mp4、.m2ts、.mpeg、.mpeg2、.mpeg4、.mpg、.mpg2、.mpg4、.ps、.ts、.vob 和 .wmv。 | File |
out_folder | 将用于保存输出图像和元数据的文件目录。 | Folder |
image_type (可选) | 指定输出图像格式。
| String |
image_overlap (可选) | 两个图像之间的最大重叠百分比。 如果候选图像与写入到磁盘的最后一个图像之间的重叠大于该值，则将忽略此候选图像。 默认百分比为 100%，此时会将所有图像写入磁盘。 | Double |
require_fresh_metadata (可选) | 指定是否仅提取和保存具有关联元数据的视频帧。
| Boolean |
min_time (可选) | 将保存的视频帧之间的最小时间间隔。 如果未提供任何值，则所有视频帧将另存为图像。 | Time Unit |
代码示例
此示例将从视频流中提取视频帧图像和关联的元数据，并将数据保存到目录中。
arcpy.ia.ExtractVideoFramesToImages(r"c:\test\video.ts", r"C:\temp2\outimages",
"TIFF", 100, "", "20 Seconds")此示例将从视频流中提取视频帧图像和关联的元数据，并将数据保存到目录中。
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