COM-Komponente
Scene Detector
Video-Szenenerkennung für Entwickler. Integrieren Sie sie über COM in Ihre Anwendung.
Beschreibung
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.
Funktionen
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.
Demo & Preis
Kontaktieren Sie mich für Informationen zu Demoversion und Preisen.
API-Referenz
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 |
|---|---|
| 0 | Success |
| 0x80040601 | Unspecified error |
| 0x80040602 | DirectShow not installed or version too old |
| 0x80040603 | Cannot obtain video duration - may be a still image |
| 0x80040604 | Bad argument |
| 0x80040605 | Cannot create device context |
| 0x80040606 | Object is busy with another task |
| 0x80040607 | Frame rate equals zero - may be a still image |
| 0x80040608 | Cannot 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.