Extensions Image, Audio et Vidéo Administration et programmation

DBvBuildStoryboardFile


Image Audio Vidéo
    X

Crée des entrées dans un catalogue des prises de vue 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. Pour chaque prise de vue, l'API stocke son numéro, 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 contiennent le numéro de l'image et le nom du fichier où se trouve le contenu de l'image. Ces informations peuvent être utilisées pour afficher un storyboard, à savoir un résumé visuel d'une séquence vidéo.

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 DBvBuildStoryboardFile(
      char *fileName,
      DBvIOType *video,
      DBvShotControl *shotCtrl,
      DBvStoryBoardCtrl *sbCtrl
            );

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.

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.

Exemples

Création d'un catalogue des prises de vue appelé hotshots et stockage des données relatives à toutes les prises de vue d'une séquence vidéo :

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


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