| ラベル | 説明 | データ タイプ |
入力ビデオ ファイル | サポートされているビデオ ファイル形式の入力ビデオ ファイル (.av1、.avi、.csv、.gpx、.h264、.h265、.json、.mp2、.mp4、.m2ts、.mpeg、.mpeg2、.mpeg4、.mpg、.mpg2、.mpg4、.ps、.ts、.vob、.wmv)。 | File |
出力フォルダー | 出力画像とメタデータが保存されるファイル ディレクトリ。 | Folder |
画像タイプ (オプション) | 出力画像の形式を指定します。
| String |
最大オーバーラップの割合 (オプション) | 2 つの画像間の最大オーバーラップの割合。 候補画像とディスクに書き込まれた最後の画像間のオーバーラップがこの値より大きい場合、候補画像は無視されます。 デフォルトの割合は 100% で、すべての画像がディスクに書き込まれます。 | Double |
新規のメタデータが必要 (オプション) | 関連するメタデータがあるビデオ フレームのみを抽出および保存するかどうかを指定します。
| Boolean |
フィーチャ間の最小時間 (オプション) | 保存するビデオ フレーム間の最小時間間隔。 値を指定しない場合、すべてのビデオ フレームが画像として保存されます。 | Time Unit |
Image Analyst ライセンスで利用できます。
サマリー
ビデオ フレーム画像および関連するメタデータを FMV (Full Motion Video) 準拠のビデオ ストリームから抽出します。 抽出された画像は、モザイク データセットやその他のツールおよび関数に追加して、今後の解析に使用できます。
使用法
このツールは、アーカイブされたビデオのみを操作します。 ライブ ストリーム ビデオはサポートされていません。
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 (オプション) | 2 つの画像間の最大オーバーラップの割合。 候補画像とディスクに書き込まれた最後の画像間のオーバーラップがこの値より大きい場合、候補画像は無視されます。 デフォルトの割合は 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)環境
このツールは、ジオプロセシング環境を使用しません。