COM-Komponente

Scene Detector

Video-Szenenerkennung für Entwickler. Integrieren Sie sie über COM in Ihre Anwendung.

Scene Detector ist eine COM-Komponente, die auf der Szenenerkennungstechnologie von HandySaw DS basiert. Sie verarbeitet eine Videodatei und liefert eine Liste der erkannten Szenen mit Einzelbild-genauen Grenzen. Die Komponente kann zudem Vorschaubilder für jede Szene erstellen und neu gefundene Szenen über Callback-Schnittstellen in Echtzeit melden. Sie müssen nicht warten, bis der gesamte Erkennungsvorgang abgeschlossen ist.

Eine COM-Komponente folgt einer Standardarchitektur und ist dadurch in nahezu jeder Windows-Entwicklungsumgebung einsetzbar. Wenn Sie statt einer Entwicklerkomponente ein eigenständiges Desktop-Programm benötigen, ist HandySaw DS die richtige Wahl.

Breite Formatunterstützung

Verarbeitet jede Videodatei, die über die DirectShow-API im Windows Media Player abgespielt werden kann.

Echtzeit-Callbacks

Meldet jede neue Szene sofort beim Auffinden. Ihre Anwendung erhält die Ergebnisse noch während der Verarbeitung.

Erstellung von Vorschaubildern

Speichert auf Wunsch das erste und letzte Einzelbild jeder Szene als BMP- oder JPEG-Datei in beliebiger Skalierung.

RGB- und YUV-Farbräume

Die Erkennung kann im RGB24- oder YUY2-Farbraum erfolgen; für beide existieren empfohlene Standard-Schwellenwerte.

Erkennung von Weiß- und Schwarzblenden

Einstellbare Luma-Schwellenwerte identifizieren Auf- und Abblenden nach Weiß oder Schwarz als eigenständige Szenen.

Teilweise Dateiverarbeitung

Geben Sie Start- und Stopppositionen an, um Szenen nur innerhalb eines ausgewählten Segments der Mediendatei zu erkennen.

Benutzerdefinierte Filter-Pipeline

Überschreiben Sie die intern verwendeten DirectShow-Filter für Quelle, Splitter und Decoder für maximale Kompatibilität.

Zusammenführung kurzer Szenen

Szenen, die kürzer als ein konfigurierbares Minimum sind, werden automatisch mit benachbarten Szenen zusammengeführt oder entfernt.

Kontaktieren Sie mich für Informationen zu Demoversion und Preisen.

sdScenesMergeKind enum

Gibt an, wie kurze Szenen nach der Erkennung gehandhabt werden.

sdMergeDelete = 0 Short scene is removed.
sdMergeWithPrev = 1 Short scene is merged with the previous scene.
sdMergeWithNext = 2 Short scene is merged with the next scene.
sdMergeWithBoth = 3 Short scene, the previous scene, and the next scene are all merged into one.

DetectorParameters structure

Kernparameter der Szenenerkennungs-Engine.

BSTR VideoFileName Full path to the video file to process.
int Threshold Detection sensitivity. Range 0–255. Recommended defaults: 19 (RGB) and 5 (YUV). A new scene begins when the difference between two consecutive frames exceeds this value. Lower values produce more scenes.
int UpLumaTresh Fade-to-white threshold. Range -1–255. A value of -1 disables this feature. When overall frame brightness exceeds this value, a new scene begins, grouping bright frames together.
int BottomLumaTresh Fade-to-black threshold. Range -1–255. A value of -1 disables this feature. When overall frame brightness falls below this value, a new scene begins, grouping dark frames together.
int MinSceneLength Minimum scene duration in frames. Scenes shorter than this value are modified according to the Merge field. Recommended default: 5.
int RegisterGraph ROT registration of the internal processing graph. 1: register. 0: do not register.
BSTR SourceFilterMoniker Display name of the desired source filter. NULL: use default.
BSTR SplitterFilterMoniker Display name of the desired splitter filter. NULL: use default.
BSTR DecoderFilterMoniker Display name of the desired decoder filter. NULL: use default.
sdScenesMergeKind Merge Merge strategy applied when a detected scene is shorter than MinSceneLength.

DetectorParameters2 structure

Erweitert DetectorParameters um die Farbraumauswahl und die teilweise Dateiverarbeitung. Enthält alle Felder von DetectorParameters sowie die folgenden.

int UseYUV Color space. 1: YUY2. 0: RGB24.
int Pad Reserved.
double StartPosition Processing start position in seconds. When non-zero, all returned scene times are relative to this offset.
double StopPosition Processing stop position in seconds. 0: process to end of file.

ThumbnailsParameters structure

Steuert die Erstellung von Vorschaubildern. Übergeben Sie einen Zeiger auf diese Struktur, um Vorschaubilder zu aktivieren, oder NULL, um sie zu deaktivieren.

int JpegFormat Output format. 0: BMP. 1: JPEG.
int JpegQuality JPEG compression quality, 0–100.
int ImagesPerScene 1: start frame only. 2: start and end frames per scene.
double Scale Thumbnail scale factor. 1.0: full size.
BSTR FileName Filename template using C printf syntax with one integer field, e.g. d:\dir\frame%05d.jpg. The frame number replaces the %d placeholder. Requires full path with correct extension.

ISceneDetector interface

Hauptschnittstelle für die Szenenerkennung.

DetectScenesInFile

HRESULT _stdcall DetectScenesInFile( [in] DetectorParameters *Params, [in] ThumbnailsParameters *ThumbnailsParams, [out] SAFEARRAY(long) *Scenes );

Hauptmethode der Erkennung. Der Aufrufer muss das SafeArray nicht vorab erstellen – übergeben Sie einen Zeiger auf eine SAFEARRAY-Variable. Wenn *Scenes nach dem Aufruf ungleich NULL ist, muss der Aufrufer es freigeben. Das Ergebnis ist ein zweidimensionales Array. Für jede Szene geben zwei Long-Werte die Start- und Stopp-Einzelbildnummern relativ zur Startposition der Verarbeitung an. Übergeben Sie ThumbnailsParams ungleich NULL, um die Erstellung von Vorschaubildern zu aktivieren.

HRESULT Meaning
0Success
0x80040601Unspecified error
0x80040602DirectShow not installed or version too old
0x80040603Cannot obtain video duration - may be a still image
0x80040604Bad argument
0x80040605Cannot create device context
0x80040606Object is busy with another task
0x80040607Frame rate equals zero - may be a still image
0x80040608Cannot build graph

ISceneDetector2 interface

Erweitert ISceneDetector. Erbt alle deren Methoden und fügt die folgenden hinzu.

DetectScenesInFile2

HRESULT _stdcall DetectScenesInFile2( [in] DetectorParameters2 *Params, [in] ThumbnailsParameters *ThumbnailsParams, [out] SAFEARRAY(long) *Scenes );

Gleich wie DetectScenesInFile, nutzt jedoch DetectorParameters2 und ermöglicht so die Farbraumauswahl sowie die teilweise Dateiverarbeitung. Die zurückgegebenen Start- und Stoppwerte der Szenen beziehen sich auf Params.StartPosition.

GetFrameRate

HRESULT _stdcall GetFrameRate( [out, retval] double *pFrameRate );

Liefert die Bildfrequenz (Frame-Rate) der zuletzt verarbeiteten Datei zurück. Nützlich zur Umrechnung von Einzelbildnummern in Zeitstempel. Gibt S_OK zurück, oder E_INVALIDARG, falls pFrameRate NULL ist.

ISceneDetectorEvents interface

Callback-Schnittstelle für Ereignisse der Echtzeit-Erkennung. Implementieren Sie diese in Ihrer Anwendung, um Ergebnisse sofort beim Auffinden zu erhalten.

NewScene

HRESULT NewScene( [in] long SceneIndex, [in] long Start, [in] long Stop );

Wird ausgelöst, wenn eine neue Szene fertiggestellt ist. SceneIndex beginnt bei 0. Start und Stop sind Einzelbildnummern beginnend bei 0. Wenn die Verarbeitung über DetectScenesInFile2 gestartet wurde, beziehen sich beide Werte auf Params.StartPosition.

Status

HRESULT Status( [in] long ScenesFound, [in] long CurrentFrame, [in] long TotalFrames, [out] long *AbortProcess );

Wird alle 50 ms mit dem aktuellen Verarbeitungsfortschritt ausgelöst. Setzen Sie *AbortProcess auf 1, um die laufende Erkennung abzubrechen.