Image | Audio | Video |
---|---|---|
X |
Builds entries in a shot catalog for all the shots in a video. The source video can be in a database or in a file. The shot catalog is in a database. For each shot, the API stores the handle or file information for the source video. It also stores the shot number, starting frame number, ending frame number, and information for at least one representative frame. Values in the DBvStoryboardCtrl data structure determine how many representative frames are identified for a shot. For shots whose length is below a threshold value in DBvStoryboardCtrl, the API identifies one representative frame. For shots whose length is between a lower and upper threshold value in DBvStoryboardCtrl, the API identifies two representative frames. For shots whose length is above the upper threshold value in DBvStoryboardCtrl, the API identifies three representative frames. The representative frame information includes its frame number and frame data. The representative frame information stored in the shot catalog can be used to display a storyboard, that is, a visual summary of a video.
The application must be connected to a database before calling this API.
Authorization
Insert, Control
Library file
OS/2 and Windows | AIX, HP-UX, and Solaris |
---|---|
dmbshot.lib | libdmbshot.a (AIX) |
| libdmbshot.sl (HP-UX) |
| libdmbshot.so (Solaris) |
Include file
dmbshot.h
Syntax
long DBvBuildStoryboardTable( char *catalogName, DBvIOType *video, DBvShotControl *shotCtrl, DBvStoryBoardCtrl *sbCtrl, SQLHDBC hdbc );
Parameters
Error codes
Examples
Create entries in a shot catalog named hotshots for a video:
#include <dmbshot.h> rc = DBvBuildStoryboardTable("hotshots", video, &shotCtrl, &sbCtrl, hdbc);