IBM Books

Image Extender、Audio Extender 和 Video Extender 管理和程序设计

DBvBuildStoryboardTable


图象 音频 视频
    X

在镜头目录中构建视频中所有镜头的项目。源视频可以在数据库或文件中。镜头目录位于数据库中。对于每一镜头,此 API 存储源视频的句柄或文件信息。它还存储镜头号、起始帧号、结束帧号和最少一个有代表性的帧的信息。DBvStoryboardCtrl 数据结构中的值确定对一个镜头标识多少有代表性的帧。对于长度在 DBvStoryboardCtrl 中的阈值之下的镜头, 此 API 标识一个有代表性的帧。对于长度在 DBvStoryboardCtrl 中的低阈值和高阈值之间的镜头, 此 API 标识两个有代表性的帧。对于长度在 DBvStoryboardCtrl 中的阈值之上的镜头, 此 API 标识三个有代表性的帧。有代表性的帧信息包括其帧号和帧数据。存储在镜头目录中的有代表性的帧信息可用来显示故事板,即,视频的视象摘要。

在调用此 API 之前,应用程序必须与数据库相连。

授权

插入、控制

库文件
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(输入)
指向镜头目录的名称的指针。

video(输入)
指向视频结构的指针。

shotCtrl(输入)
指向镜头控制结构的指针

sbCtrl(输入)
指向故事板控制结构的指针。

hdbc(输入)
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);


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]