IBM Books

Image, Audio, and Video Extenders Administration and Programming

DBvDetectShot


Image Audio Video
    X

Searches for the next shot in a video file. If a shot is detected, records the frame number and frame data of the first frame in the detected shot. You must examine the shotDetected flag to determine if a shot has been detected.

Authorization

None

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 DBvDetectShot(
      DBvIOType *video,
      unsigned long *start_frame,
      char *shotDetected,
      DBvShotControl *shotCtrl,
      DBvShotType *shot,
            );

Parameters

video (update)
The pointer to the video structure.

start_frame (in/out)
The frame number used as the starting point for the search. On return, the parameter is updated with the position to start looking for the next shot.

shotDetected (out)
Shot detected flag: 1= frame detected, 0= no frame detected.

shotCtrl (in)
The pointer to the shot control data.

shot (out)
The pointer to the detected shot and shot data.

Error codes

MMDB_SUCCESS
API call processed successfully.

MMDB_RC_EOF
End of file reached.

MMDB_NO_INDEX
The video index does not exist.

Examples

Search for the next shot in a video file starting from frame 1:

#include <dmbshot.h>
 
long start_frame=1;
 
rc = DBvDetectShot(video, start_frame&Detected,
       &shotCtrl, &shot);


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