KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION
KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION ist eine Eigenschafts-ID, die zum Steuern der Hintergrundunschärfe auf dem Treiber verwendet wird.
Diese Eigenschaft steuert eine In-Stream-Korrektur, die ein Treiber durchführen kann, um eine qualitativ hochwertige Bildkorrektur für die Verwendung mit Vorschau- und aufgezeichneten Bildern zu ermöglichen. Die In-Stream-Korrektur muss im Treiber auf einheitliche Weise aktiviert und deaktiviert werden, damit die Features entweder von Windows oder einer Anwendung gesteuert werden können.
Beispiele für das Festlegen von KSPROPERTY-Steuerelementen finden Sie im AVStream-Kamerabeispieltreiber auf GitHub.
Aktualisieren auf KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION-Steuerelement
Ab Windows 11 Version 22H2 wurde der Flachfokusmodus als optionale Funktion in das vorhandene Steuerelement für die Hintergrundsegmentierung eingeführt.
KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS ist ein neues Flag, das dem KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION-Steuerelement hinzugefügt wird, das zum Steuern des Bokeh (flachen Fokusmodus) auf dem Treiber verwendet wird. Dies ist eine Version von Hintergrundunschärfe KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION, bei der die Betonung weniger auf Datenschutz und mehr darauf liegt, den Hintergrund des Benutzers wie von einer qualitativ hochwertigeren Kamera mit Tiefenschärfeneffekt aussehen zu lassen. Dies wird visuell das Vordergrundthema hervorheben, ähnlich wie die Fotografie im Hochformat auf vielen Mobiltelefonen beliebt ist.
Tabelle "Nutzungszusammenfassung"
| `Scope` | Control | type |
|---|---|---|
| Version 1 | Filter | Synchron |
Die folgenden Flags können im KSCAMERA_EXTENDEDPROP_HEADER platziert werden . Flags-Feld zum Steuern des flachen Fokusmodus.
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_MASK 0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS 0x0000000000000004
Wenn der Treiber dieses Steuerelement unterstützt, muss er BACKGROUNDSEMENTATION_OFF und mindestens eins der anderen Flags unterstützen.
Wenn der Treiber die Segmentierung im Hintergrund nicht unterstützt, sollte der Treiber dieses Steuerelement nicht implementieren.
Der SET-Aufruf dieses Steuerelements wird auch dann wirksam, wenn sich der Video- oder Foto-Pin im KSSTATE_RUN Zustand befindet. Bei einem GET-Aufruf sollte der Treiber die aktuellen Einstellungen im Feld Flags zurückgeben.
In der folgenden Tabelle werden die Flagfunktionen beschrieben.
| Flag | Beschreibung |
|---|---|
| KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_OFF | Dies ist eine obligatorische Funktion. Wenn angegeben, wird die Hintergrundsegmentierung im Treiber deaktiviert. Dies ist der Standardwert. |
| KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR | Dies ist eine optionale Funktion. Wenn angegeben, wird die Hintergrundunschärfe im Treiber aktiviert und gilt nach Möglichkeit für den Frame. |
| KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_MASK | Dies ist eine optionale Funktion. Wenn angegeben, wird die Erstellung von Hintergrundmaskenmetadaten im Treiber aktiviert (wenn möglich, wenn der MediaType verwendet wird, der über den Satz von KSPROPERTY_CAMERACONTROL_EXTENDED_ BACKGROUNDSEGMENTATION_CONFIGCAPS ausgedrückt wird, der im Feld Größe des KSCAMERA_EXTENDEDPROP_HEADER zurückgegeben wird). Beachten Sie, dass dies nicht nur für Farbkameras, sondern auch für Tiefen- und IR-Kameras unterstützt werden kann. |
| KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS | Dies ist eine optionale Funktion. Wenn sie zusammen mit KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR angegeben wird, wird der flache Fokus im Treiber aktiviert. |
Hinweis
Aus SET-Sicht muss KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS zusammen mit KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR hinzugefügt werden, um wirksam zu werden; Sie können auch zusammen mit KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_MASK festgelegt werden.
Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER Strukturfelder bei Verwendung des -Steuerelements.
| Member | BESCHREIBUNG |
|---|---|
| Version | Dies muss 1 sein. |
| PinId | Dies muss KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) sein. |
| Size | Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) sein. |
| Ergebnis | Nicht verwendet, muss 0 sein. |
| Funktion | Muss ein bitweises OR der oben definierten KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION _*-Flags sein. |
| Flags | Dies ist ein Lese-/Schreibfeld. Dies kann eines der oben definierten KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION _*-Flags mit Ausnahme von SHALLOWFOCUS (das zusammen mit BLUR festgelegt werden muss, um wirksam zu werden) oder gültige Kombinationen der Bits sein. Aus SET-Perspektive wird der flachen Fokusmodus nur aktiviert, wenn sowohl SHALLOWFOCUS als auch BLUR gleichzeitig festgelegt sind. Sie können zusammen mit MASK festgelegt werden. |
Anforderungen
Mindestens unterstützter Client: Windows 11, Version 22H2
Header: ksmedia.h (include Ksmedia.h)
Weitere Informationen
KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION