ビデオ フレームから画像を抽出 (Extract Video Frames To Images) (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
最大オーバーラップ割合 (オプション)	2 つの画像間の最大オーバーラップ割合。 候補画像とディスクに書き込まれた最後の画像のオーバーラップがこの値より大きい場合、候補画像は無視されます。 デフォルトの割合は 100 パーセントで、すべての画像がディスクに書き込まれます。	Double
新しいメタデータが必要 (オプション)	関連するメタデータがあるビデオ フレームを抽出および保存するかどうかを指定します。 オン - 関連するメタデータがあるビデオ フレームのみを保存します。 オフ - すべてのビデオ フレームを保存します。 これがデフォルトです。	Boolean
フィーチャ間の最小時間 (オプション)	保存するビデオ フレーム間の最小時間間隔。 値を指定しない場合、すべてのビデオ フレームが画像として保存されます。	Time Unit

Python

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 (オプション)	2 つの画像間の最大オーバーラップ割合。 候補画像とディスクに書き込まれた最後の画像のオーバーラップがこの値より大きい場合、候補画像は無視されます。 デフォルトの割合は 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)

環境

このツールは、ジオプロセシング環境を使用しません。