Verwaltung und Programmierung

DBvBuildStoryboardFile


Image Audio Video
    X

Erstellt eine Aufnahmekatalogdatei mit Einträgen für alle Aufnahmen in einem Video. Das Quellenvideo kann in einer Datenbank oder einer Datei sein. Für jede Aufnahme speichert die API die Aufnahmennummer, die Anfangs- und Endvollbildnummer und die Informationen für mindestens ein repräsentatives Vollbild. Durch die Werte in der Datenstruktur von DBvStoryboardCtrl ist festgelegt, wie viele repräsentative Vollbilder für eine Aufnahme identifiziert werden. Bei Aufnahmen, deren Länge unterhalb eines Schwellenwerts in DBvStoryboardCtrl liegt, identifiziert die API ein repräsentatives Vollbild. Bei Aufnahmen, deren Länge zwischen dem unteren und oberen Schwellenwert in DBvStoryboardCtrl liegt, identifiziert die API zwei repräsentative Vollbilder. Bei Aufnahmen, deren Länge oberhalb des oberen Schwellenwerts in DBvStoryboardCtrl liegt, identifiziert die API drei repräsentative Vollbilder. Zu den Informationen zum repräsentativen Vollbild gehört die Vollbildnummer und der Name der Datei, die den Vollbildinhalt enthält. Diese Informationen können zum Anzeigen eines Storyboards, d. h. einer visuellen Zusammenfassung eines Videos, verwendet werden.

Berechtigung

INSERT, CONTROL

Bibliotheksdatei
OS/2 und Windows AIX, HP-UX und Solaris
dmbshot.lib libdmbshot.a (AIX)

libdmbshot.sl (HP-UX)

libdmbshot.so (Solaris)

Syntax

long DBvBuildStoryboardFile(
      char *fileName,
      DBvIOType *video,
      DBvShotControl *shotCtrl,
      DBvStoryBoardCtrl *sbCtrl
            );

Parameter

catalogName (Eingabe)
Der Zeiger auf den Namen der Aufnahmekatalogdatei.

video (Eingabe)
Der Zeiger auf die Videostruktur.

shotCtrl (Eingabe)
Der Zeiger auf die Aufnahmesteuerstruktur.

sbCtrl (Eingabe)
Der Zeiger auf die Storyboard-Steuerstruktur.

Fehlercodes

MMDB_SUCCESS
API-Aufruf erfolgreich verarbeitet.

MMDB_RC_NO_AUTH
Aufrufender verfügt nicht über die korrekte Zugriffsberechtigung.

MMDB_RC_INVALID_CATALOG
Katalog ist ungültig oder existiert nicht.

Beispiele

Erstellen einer Aufnahmekatalogdatei 'hotshots' und Füllen dieser Datei mit Daten für alle Aufnahmen in einem Video:

#include <dmbshot.h>

rc = DBvBuildStoryboardFile("hotshots",
       video, &shotCtrl, &sbCtrl);


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]

Search the DB2 Extender Books