IBM Books

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

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

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

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

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

错误码

MMDB_SUCCESS
对 API 调用的处理成功完成。

MMDB_RC_NO_AUTH
调用者没有正确的存取权限。

MMDB_RC_INVALID_CATALOG
目录无效或不存在。

创建一个名为 hotshots 的镜头目录文件, 并用视频中的所有镜头数据填充它:

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


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