Partager via


PROPSETID_VIDCAP_VIDEOPROCAMP

Le jeu de propriétés PROPSETID_VIDCAP_VIDEOPROCAMP contrôle les appareils qui peuvent ajuster les attributs de couleur d’image des signaux analogiques ou numériques.

L’énumération KSPROPERTY_VIDCAP_VIDEOPROCAMP dans ksmedia.h spécifie les propriétés de cet ensemble.

La prise en charge de ce jeu de propriétés est facultative et ne doit être implémentée que par les appareils qui autorisent l’ajustement de la luminosité, du contraste, de la teinte et d’autres paramètres de qualité d’image.

Avant la classe vidéo USB, cette énumération contenait les éléments de propriété suivants :

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

Avec l’introduction du pilote de classe vidéo USB, les propriétés suivantes ont été ajoutées à l’énumération KSPROPERTY_VIDCAP_VIDEOPROCAMP :

KSPROPERTY_VIDEOPROCAMP_DIGITAL_MULTIPLIER

KSPROPERTY_VIDEOPROCAMP_DIGITAL_MULTIPLIER_LIMIT

KSPROPERTY_VIDEOPROCAMP_WHITEBALANCE_COMPONENT

KSPROPERTY_VIDEOPROCAMP_POWERLINE_FREQUENCY

Chaque propriété du jeu de propriétés PROPSETID_VIDEOPROCAMP inclut une plage et une valeur par défaut. La plage du jeu de propriétés est définie en unités réelles pour permettre le contrôle programmatique des paramètres. Chaque appareil peut définir un sous-ensemble de cette plage, ainsi qu’une taille d’étape. Cela permet aux contrôles, tels que les curseurs et les barres de défilement, d’être programmés pour donner un effet visible pour chaque étape.

Par exemple, la plage théorique globale de luminosité est définie comme -100 à 100 unités IRE. L’IRE est une mesure définie par le NTSC des niveaux vidéo, où 0 correspond au niveau de remplissage ou de noir intégral, et 100 représente le blanc pur. Si un VideoProcAmp était en mesure de déplacer un signal d’entrée noir pur (peut-être généré en couvrant complètement l’objectif de l’appareil photo) et de le faire apparaître comme blanc pur, sa plage serait comprise entre 0 et 100 IRE.

La plupart des VideoProcAmps fournissent en fait une plage limitée de contrôle de luminosité. Une façon de mesurer la plage consiste à couvrir l’objectif de l’appareil photo et à déterminer le signal de sortie sur la plage de réglage, puis de le normaliser en unités IRE. Une fois la plage calculée, la valeur de pas à pas peut être dérivée en prenant les valeurs maximale et minimale et en divisant par le nombre d’étapes d’ajustement (max + min)/N d’étapes d’ajustement.

Notez que les valeurs utilisées dans les jeux de propriétés sont multipliées par 100 pour améliorer la granularité.

DirectShow, interface

L’interface DirectShow IAMVideoProcAmp (voir la documentation DirectShow dans le Microsoft Windows SDK) permet d’accéder aux propriétés de cet ensemble.