ビデオ フレームから画像を抽出 (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

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)

環境

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

関連トピック