Image、Audio 及 Video Extenders 管理與程式設計

DBvBuildStoryboardFile


影像 音效 視訊
    X

建立一個快照型錄檔,並在檔案內建置視訊中之所有快照的相關項目。 來源視訊可放在資料庫或檔案中。就每一個快照而言,API 儲存至少一個代表框的快照號碼、 起始框號碼、結束框號碼和資訊。 DBvStoryboardCtrl 資料結構中的值, 用以決定要用多少個呈現畫面來認定一個快照。對於其長度低於 DBvStoryboardCtrl 中之臨界值的快照而言, API 會視同一個呈現畫面;對於其長度界於 DBvStoryboardCtrl 中之高低臨界值間的快照而言, API 會視同兩個呈現畫面;就長度大於 DBvStoryboardCtrl 中的上限值的快照而言,API 可識別三個代表框。 呈現畫面資訊中會包括其畫面編號、 以及內含畫面內容的檔案名稱。此資訊可用來顯示故事板, 也就是顯示一則看得見的視訊摘要。

授權

插入、控制

檔案庫
OS/2 與 Windows AIX、HP-UX 及 Solaris
dmbshot.lib libdmbshot.a (AIX)

libdmbshot.sl (HP-UX)

libdmbshot.so (Solaris)

併入檔

dmbshot.h

語法

long DBvBuildStoryboardFile(
      char *fileName,
      DBvIOType *video,
      DBvShotControl *shotCtrl,
      DBvStoryBoardCtrl *sbCtrl
            );

參數

catalogName (in)
指向快照型錄檔名稱的指標。

video (in)
指向視訊結構的指標。

shotCtrl (in)
指向快照控制結構的指標。

sbCtrl (in)
指向故事板控制結構的指標。

錯誤碼

MMDB_SUCCESS
API 呼叫程序執行成功。

MMDB_RC_NO_AUTH
呼叫程式不具備適當的存取權限。

MMDB_RC_INVALID_CATALOG
型錄無效或不存在。

範例

建立一個名為 hotshots 的快照型錄檔,然後以視訊中的所有快照的資料填入該檔案:

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


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]