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フィルターを上書きできます。
短いシーンの統合
設定した最小値より短いシーンは、隣接するシーンに自動的に統合されるか、削除されます。
体験版と価格
体験版および価格に関する情報は、お問い合わせください。
APIリファレンス
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 | 不明なエラー |
| 0x80040602 | DirectShowがインストールされていないか、バージョンが古すぎます |
| 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を設定してください。