Extensions Image, Audio et Vidéo Administration et programmation

DBvBuildStoryboardTable


Image Audio Vidéo
    X

Crée des entrées dans un catalogue pour toutes les prises de vue d'une séquence vidéo. La vidéo source peut se trouver dans une base de données ou dans un fichier. Ce dernier se trouve dans une base de données. Pour chaque prise de vue, l'API stocke les informations relatives au descripteur ou au fichier pour la vidéo source. L'API stocke également le numéro de la prise de vue, le numéro de la première image, celui de la dernière image ainsi que les informations relatives à une image représentative au moins. Les valeurs contenues dans la structure de données DBvStoryboardCtrl déterminent le mode d'identification de plusieurs images représentatives pour une prise de vue. Pour les prises de vue dont la longueur est inférieure à une valeur de seuil dans DBvStoryboardCtrl, l'API identifie une image représentative. Pour les prises de vue dont la longueur est comprise entre une valeur de seuil minimale et une valeur de seuil maximale dans DBvStoryboardCtrl, l'API identifie deux images représentatives. Pour les prises de vue dont la longueur est supérieure à la valeur de seuil maximale dans DBvStoryboardCtrl, l'API identifie trois images représentatives. Les informations relatives à l'image représentative comprennent le numéro et les données se rapportant à l'image. Les informations relatives à l'image représentative stockées dans le catalogue des prises de vue peuvent être utilisées pour l'affichage d'un storyboard, à savoir un résumé visuel d'une séquence vidéo.

Pour que cette API puisse être appelée, l'application doit être connectée à une base de données.

Autorisation

Insert, Control

Fichier bibliothèque
OS/2 et Windows AIX, HP-UX et Solaris
dmbshot.lib libdmbshot.a (AIX)

libdmbshot.sl (HP-UX)

libdmbshot.so (Solaris)

Fichier d'inclusion

dmbshot.h

Syntaxe

long DBvBuildStoryboardTable(
      char *catalogName,
      DBvIOType *video,
      DBvShotControl *shotCtrl,
      DBvStoryBoardCtrl *sbCtrl,
      SQLHDBC hdbc
      );

Paramètres

catalogName (entrée)
Pointeur sur le nom du catalogue des prises de vue.

video (entrée)
Pointeur sur la structure vidéo.

shotCtrl (entrée)
Pointeur sur la structure de contrôle des prises de vue.

sbCtrl (entrée)
Pointeur sur la structure de contrôle du storyboard.

hdbc (entrée)
Descripteur de base de données obtenu par SQLConnect.

Codes d'erreur

MMDB_SUCCESS
Le traitement de l'appel d'API a abouti.

MMDB_RC_NO_AUTH
Le demandeur ne dispose pas des droits d'accès corrects.

MMDB_RC_INVALID_CATALOG
Le catalogue est incorrect ou n'existe pas.

MMDB_RC_NOT_CONNECTED
L'application n'a pas établi une connexion correcte à une base de données.

Exemples

Création d'entrées dans un catalogue des prises de vue appelé hotshots pour une séquence video :

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


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]