イメージ、オーディオ、およびビデオ・エクステンダー 管理およびプログラミングの手引き

DBvBuildStoryboardTable


イメージ オーディオ ビデオ
O

ビデオ内のすべてのショットに関する項目をショット・カタログに作成します。 ソース・ビデオはデータベースまたはファイルに置くことができます。 ショット・カタログはデータベースにあります。 ショットごとに、API はソース・ビデオに関するハンドル情報またはファイル情報を保管します。 さらに、ショット番号、開始フレーム番号、終了フレーム番号、および少なくとも 1 つの代表フレームに関する情報も保管します。 DBvStoryboardCtrl データ構造内の値は、1 つのショットにいくつの代表フレーム数が指定されているかを示します。 長さが DBvStoryboardCtrl のしきい値より短いショットの場合、この API は 1 つの代表フレームを示します。 長さが DBvStoryboardCtrl の下位しきい値と上位しきい値の間であるショットの場合、この API は 2 つの代表フレームを示します。 長さが DBvStoryboardCtrl の上位しきい値より長いショットの場合、この API は 3 つの代表フレームを示します。 代表フレーム情報には、フレーム番号およびフレーム・データが含まれます。 ショット・カタログに保管される代表フレーム情報は、ストーリーボード、すなわち、ビデオの眼に見える要約を表示するために使用することができます。

この API を呼び出す前に、アプリケーションをデータベースに接続する必要があります。

許可

Insert、Control

ライブラリー・ファイル
OS/2 および Windows AIX、HP-UX、および Solaris
dmbshot.lib libdmbshot.a (AIX)

libdmbshot.sl (HP-UX)

libdmbshot.so (Solaris)

インクルード・ファイル

dmbshot.h

構文

long DBvBuildStoryboardTable(
      char *catalogName ,
      DBvIOType *video,
      DBvShotControl *shotCtrl,
      DBvStoryBoardCtrl *sbCtrl,
      SQLHDBC hdbc
      );

パラメーター

catalogName (in)
ショット・カタログの名前を指すポインター。

video (in)
ビデオ構造を指すポインター。

shotCtrl (in)
ショット制御構造を指すポインター。

sbCtrl (in)
ストーリーボード制御構造を指すポインター。

hdbc (in)
SQLConnect からのデータベース・ハンドル。

エラー・コード

MMDB_SUCCESS
正常に処理された API 呼び出し。

MMDB_RC_NO_AUTH
呼び出し側のアクセス権限が正しくありません。

MMDB_RC_INVALID_CATALOG
カタログは有効でないか、存在しません。

MMDB_RC_NOT_CONNECTED
アプリケーションのデータベース接続が有効ではありません。

ビデオに hotshots という名前を付けたショット・カタログの項目を作成します。

#include <dmbshot.h>
rc = DBvBuildStoryboardTable("hotshots",
       video, &shotCtrl, &sbCtrl, hdbc);


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]