COMコンポーネント

Scene Detector

開発者向けのビデオシーン検出ツールです。COM経由でアプリケーションに統合してご利用いただけます。

Scene Detectorは、HandySaw DSのシーン認識技術をベースに構築されたCOMコンポーネントです。ビデオファイルを処理し、検出されたシーンのリストをフレーム単位で正確な境界と共に返します。また、各シーンのサムネイルを生成したり、コールバックインターフェースを通じて新しく検出されたシーンをリアルタイムで報告したりすることも可能です。検出処理の完了を待つ必要はありません。

COMコンポーネントは標準的なアーキテクチャに従っているため、事実上あらゆるWindows開発環境から利用可能です。開発者向けコンポーネントではなく、スタンドアロンのデスクトップツールをお探しの場合は、HandySaw DSが最適です。

幅広い形式に対応

DirectShow APIを通じて、Windows Media Playerで再生可能なあらゆるビデオファイルを処理できます。

リアルタイムコールバック

新しいシーンが検出されるたびに、即座に報告します。処理の実行中にアプリケーションで結果を受け取ることができます。

サムネイル生成

各シーンの最初と最後のフレームを、任意のサイズでBMPまたはJPEGファイルとして保存できます(オプション)。

RGBおよびYUV色空間

検出はRGB24またはYUY2色空間で実行でき、それぞれに推奨されるデフォルトのしきい値が設定されています。

ホワイトおよびブラックシーンの検出

輝度しきい値を設定することで、ホワイトフェードやブラックフェードの遷移を個別のシーンとして識別できます。

ファイルの一部処理

開始位置と終了位置を指定することで、メディアファイルの特定のセグメント内のみでシーン検出を行うことができます。

カスタムフィルターパイプライン

互換性を最大限に高めるため、内部で使用されるソース、スプリッター、デコーダーのDirectShowフィルターを上書きできます。

短いシーンの統合

設定した最小値より短いシーンは、隣接するシーンに自動的に統合されるか、削除されます。

体験版および価格に関する情報は、お問い合わせください。

sdScenesMergeKind enum

検出後、短いシーンをどのように処理するかを指定します。

sdMergeDelete = 0 短いシーンを削除します。
sdMergeWithPrev = 1 短いシーンを前のシーンに統合します。
sdMergeWithNext = 2 短いシーンを次のシーンに統合します。
sdMergeWithBoth = 3 短いシーン、前のシーン、および次のシーンをすべて1つに統合します。

DetectorParameters structure

シーン検出エンジンのコアパラメータです。

BSTR VideoFileName 処理するビデオファイルのフルパスです。
int Threshold 検出感度です。範囲は0~255です。推奨デフォルト値:19 (RGB)、5 (YUV)。連続する2つのフレーム間の差がこの値を超えると、新しいシーンが始まります。値を小さくすると、より多くのシーンが検出されます。
int UpLumaTresh ホワイトフェードのしきい値です。範囲は-1~255です。-1を指定すると、この機能は無効になります。フレーム全体の輝度がこの値を超えると、明るいフレームをまとめて新しいシーンとして開始します。
int BottomLumaTresh ブラックフェードのしきい値です。範囲は-1~255です。-1を指定すると、この機能は無効になります。フレーム全体の輝度がこの値を下回ると、暗いフレームをまとめて新しいシーンとして開始します。
int MinSceneLength フレーム単位の最小シーン持続時間です。この値より短いシーンは、Mergeフィールドに従って処理されます。推奨デフォルト値:5。
int RegisterGraph 内部処理グラフのROT登録です。1: 登録する。0: 登録しない。
BSTR SourceFilterMoniker 指定するソースフィルターの表示名です。NULL: デフォルトを使用します。
BSTR SplitterFilterMoniker 指定するスプリッターフィルターの表示名です。NULL: デフォルトを使用します。
BSTR DecoderFilterMoniker 指定するデコーダーフィルターの表示名です。NULL: デフォルトを使用します。
sdScenesMergeKind Merge 検出されたシーンがMinSceneLengthより短い場合に適用される統合戦略です。

DetectorParameters2 structure

DetectorParametersを拡張し、色空間の選択とファイルの一部処理機能を追加したものです。DetectorParametersのすべてのフィールドに加えて、以下を含みます。

int UseYUV 色空間です。1: YUY2。0: RGB24。
int Pad 予約済み。
double StartPosition 秒単位の処理開始位置です。0以外の場合、返されるすべてのシーン時間は、このオフセットからの相対時間になります。
double StopPosition 秒単位の処理終了位置です。0: ファイルの最後まで処理します。

ThumbnailsParameters structure

サムネイル生成を制御します。サムネイルを有効にするにはこの構造体へのポインタを渡し、無効にするにはNULLを渡してください。

int JpegFormat 出力形式です。0: BMP。1: JPEG。
int JpegQuality JPEGの圧縮品質(0~100)です。
int ImagesPerScene 1: 開始フレームのみ。2: シーンごとの開始および終了フレーム。
double Scale サムネイルのスケール係数です。1.0: フルサイズ。
BSTR FileName C言語のprintf構文を使用したファイル名テンプレートで、1つの整数フィールドを含みます(例:d:\dir\frame%05d.jpg)。%dプレースホルダーがフレーム番号に置き換わります。正しい拡張子を含むフルパスが必要です。

ISceneDetector interface

シーン検出のコアインターフェースです。

DetectScenesInFile

HRESULT _stdcall DetectScenesInFile( [in] DetectorParameters *Params, [in] ThumbnailsParameters *ThumbnailsParams, [out] SAFEARRAY(long) *Scenes );

メインの検出メソッドです。呼び出し側で事前にSafeArrayを作成する必要はなく、SAFEARRAY変数へのポインタを渡してください。呼び出し後に*Scenesがnon-NULLである場合、呼び出し側でそれを破棄する必要があります。結果は2次元配列で返されます。各シーンについて、2つのlong値が処理開始位置からの相対的な開始および終了フレーム番号を示します。サムネイル生成を有効にするには、non-NULLのThumbnailsParamsを渡してください。

HRESULT Meaning
0成功
0x80040601不明なエラー
0x80040602DirectShowがインストールされていないか、バージョンが古すぎます
0x80040603ビデオの長さを取得できません。静止画である可能性があります
0x80040604引数が不正です
0x80040605デバイスコンテキストを作成できません
0x80040606オブジェクトが別のタスクでビジー状態です
0x80040607フレームレートが0です。静止画である可能性があります
0x80040608グラフを構築できません

ISceneDetector2 interface

ISceneDetectorを拡張したものです。すべてのメソッドを継承し、以下を追加します。

DetectScenesInFile2

HRESULT _stdcall DetectScenesInFile2( [in] DetectorParameters2 *Params, [in] ThumbnailsParameters *ThumbnailsParams, [out] SAFEARRAY(long) *Scenes );

DetectScenesInFileと同様ですが、DetectorParameters2を使用するため、色空間の選択とファイルの一部処理が可能です。返されるシーンの開始および終了値は、Params.StartPositionからの相対値になります。

GetFrameRate

HRESULT _stdcall GetFrameRate( [out, retval] double *pFrameRate );

最後に処理したファイルのフレームレートを返します。フレーム番号をタイムスタンプに変換する際に便利です。S_OKを返すか、pFrameRateがNULLの場合はE_INVALIDARGを返します。

ISceneDetectorEvents interface

リアルタイム検出イベント用のコールバックインターフェースです。検出結果を随時受け取るには、アプリケーション側でこれを実装してください。

NewScene

HRESULT NewScene( [in] long SceneIndex, [in] long Start, [in] long Stop );

新しいシーンが確定したときに発生します。SceneIndexは0から始まります。StartおよびStopは0から始まるフレーム番号です。DetectScenesInFile2で処理を開始した場合、両方の値はParams.StartPositionからの相対値になります。

Status

HRESULT Status( [in] long ScenesFound, [in] long CurrentFrame, [in] long TotalFrames, [out] long *AbortProcess );

現在の処理状況を50ミリ秒ごとに報告します。実行中の検出をキャンセルするには、*AbortProcessに1を設定してください。