IBM Books

Image, Audio, and Video Extenders Administration and Programming

DBvBuildStoryboardTable


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

catalogName (in)
The pointer to the name of the shot catalog.

video (in)
The pointer to the video structure.

shotCtrl (in)
The pointer to the shot control structure

sbCtrl (in)
The pointer to the storyboard control structure.

hdbc (in)
The database handle from SQLConnect.

Error codes

MMDB_SUCCESS
API call processed successfully.

MMDB_RC_NO_AUTH
Caller does not have the proper access authority.

MMDB_RC_INVALID_CATALOG
The catalog is not valid or does not exist.

MMDB_RC_NOT_CONNECTED
Application does not have valid connection to a database.

Examples

Create entries in a shot catalog named hotshots for a video:

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


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]