Share via


PROPSETID_VIDCAP_VIDEOPROCAMP

Der PROPSETID_VIDCAP_VIDEOPROCAMP-Eigenschaftssatz steuert Geräte, die Bildfarbattribute analoger oder digitaler Signale anpassen können.

Die KSPROPERTY_VIDCAP_VIDEOPROCAMP-Enumeration in ksmedia.h gibt die Eigenschaften dieser Gruppe an.

Die Unterstützung für diesen Eigenschaftensatz ist optional und sollte nur von Geräten implementiert werden, die die Anpassung von Helligkeits-, Kontrast-, Farbton- und anderen Bildqualitätseinstellungen ermöglichen.

Vor der USB-Videoklasse enthielt diese Enumeration die folgenden Eigenschaftenelemente:

KSPROPERTY_VIDEOPROCAMP_BACKLIGHT_COMPENSATION

KSPROPERTY_VIDEOPROCAMP_BRIGHTNESS

KSPROPERTY_VIDEOPROCAMP_COLORENABLE

KSPROPERTY_VIDEOPROCAMP_CONTRAST

KSPROPERTY_VIDEOPROCAMP_GAMMA

KSPROPERTY_VIDEOPROCAMP_HUE

KSPROPERTY_VIDEOPROCAMP_SATURATION

KSPROPERTY_VIDEOPROCAMP_SHARPNESS

KSPROPERTY_VIDEOPROCAMP_WHITEBALANCE

KSPROPERTY_VIDEOPROCAMP_GAIN

Mit der Einführung des USB-Videoklassentreibers wurden der KSPROPERTY_VIDCAP_VIDEOPROCAMP-Enumeration die folgenden Eigenschaften hinzugefügt:

KSPROPERTY_VIDEOPROCAMP_DIGITAL_MULTIPLIER

KSPROPERTY_VIDEOPROCAMP_DIGITAL_MULTIPLIER_LIMIT

KSPROPERTY_VIDEOPROCAMP_WHITEBALANCE_COMPONENT

KSPROPERTY_VIDEOPROCAMP_POWERLINE_FREQUENCY

Jede Eigenschaft im PROPSETID_VIDEOPROCAMP-Eigenschaftssatz enthält einen Bereich und einen Standardwert. Der Bereich für den Eigenschaftensatz wird in realen Einheiten definiert, um die programmgesteuerte Steuerung von Parametern zu ermöglichen. Jedes Gerät kann eine Teilmenge dieses Bereichs sowie eine Schrittgröße definieren. Dadurch können Steuerelemente wie Schieberegler und Bildlaufleisten so programmiert werden, dass für jeden Schritt eine sichtbare Wirkung erzielt wird.

Der theoretische Gesamtbereich für die Helligkeit wird beispielsweise als -100 bis 100 IRE-Einheiten definiert. IRE ist ein von NTSC definiertes Maß für Videoebenen, wobei 0 der Leerungs- oder vollständigen Schwarzstufe entspricht und 100 reines Weiß darstellt. Wenn ein VideoProcAmp in der Lage wäre, ein reines schwarzes Eingangssignal (möglicherweise durch vollständiges Abdecken des Kameraobjektivs) zu verschieben und es als reines Weiß erscheinen zu lassen, dann liegt sein Bereich bei 0 bis 100 IRE.

Die meisten VideoProcAmps bieten tatsächlich einen begrenzten Bereich der Helligkeitssteuerung. Eine Möglichkeit, den Bereich zu messen, besteht darin, das Kameraobjektiv abzudecken und das Ausgangssignal über den Bereich der Anpassung zu bestimmen und dann auf IRE-Einheiten zu normalisieren. Nachdem der Bereich berechnet wurde, kann der Schrittwert abgeleitet werden, indem die Maximal- und Mindestwerte genommen und durch die Anzahl der Anpassungsschritte (max + min)/N dividiert werden.

Beachten Sie, dass die in den Eigenschaftensätzen verwendeten Werte mit 100 multipliziert werden, um eine verbesserte Granularität zu erhalten.

DirectShow-Schnittstelle

Die DirectShow IAMVideoProcAmp-Schnittstelle (siehe DirectShow-Dokumentation im Microsoft Windows SDK) bietet Zugriff auf die Eigenschaften dieses Satzes.