PROPSETID_VIDCAP_VIDEOPROCAMP
O conjunto de propriedades PROPSETID_VIDCAP_VIDEOPROCAMP controla dispositivos que podem ajustar atributos de cor de imagem de sinais analógicos ou digitais.
A enumeração KSPROPERTY_VIDCAP_VIDEOPROCAMP em ksmedia.h especifica as propriedades desse conjunto.
O suporte para esse conjunto de propriedades é opcional e deve ser implementado apenas por dispositivos que permitem ajuste de brilho, contraste, matiz e outras configurações de qualidade de imagem.
Antes da classe de vídeo USB, essa enumeração continha os seguintes itens de propriedade:
KSPROPERTY_VIDEOPROCAMP_BACKLIGHT_COMPENSATION
KSPROPERTY_VIDEOPROCAMP_BRIGHTNESS
KSPROPERTY_VIDEOPROCAMP_COLORENABLE
KSPROPERTY_VIDEOPROCAMP_CONTRAST
KSPROPERTY_VIDEOPROCAMP_SATURATION
KSPROPERTY_VIDEOPROCAMP_SHARPNESS
KSPROPERTY_VIDEOPROCAMP_WHITEBALANCE
Com a introdução do Driver de Classe de Vídeo USB, as seguintes propriedades foram adicionadas à enumeração KSPROPERTY_VIDCAP_VIDEOPROCAMP:
KSPROPERTY_VIDEOPROCAMP_DIGITAL_MULTIPLIER
KSPROPERTY_VIDEOPROCAMP_DIGITAL_MULTIPLIER_LIMIT
KSPROPERTY_VIDEOPROCAMP_WHITEBALANCE_COMPONENT
KSPROPERTY_VIDEOPROCAMP_POWERLINE_FREQUENCY
Cada propriedade no conjunto de propriedades PROPSETID_VIDEOPROCAMP inclui um intervalo e um valor padrão. O intervalo do conjunto de propriedades é definido em unidades do mundo real para permitir o controle programático de parâmetros. Cada dispositivo pode definir um subconjunto desse intervalo, bem como um tamanho de etapa. Isso permite que controles, como controles deslizantes e barras de rolagem, sejam programados para dar um efeito visível para cada etapa.
Por exemplo, o intervalo teórico geral para brilho é definido como -100 a 100 unidades de IRE. IRE é uma medida definida por NTSC de níveis de vídeo, em que 0 corresponde ao nível em branco ou preto completo, e 100 representa branco puro. Se um VideoProcAmp foi capaz de deslocar um sinal de entrada preto puro (talvez gerado cobrindo completamente a lente da câmera) e fazê-lo aparecer como branco puro, então seu intervalo seria de 0 a 100 IRE.
A maioria dos VideoProcAmps realmente fornece um intervalo limitado de controle de brilho. Uma maneira de medir o intervalo é cobrir a lente da câmera e determinar o sinal de saída sobre o intervalo de ajuste e, em seguida, normalizá-lo em unidades IRE. Depois que o intervalo tiver sido calculado, o valor de etapa poderá ser derivado usando os valores máximo e mínimo e dividindo pelo número de etapas de ajuste (max + min)/N etapas de ajuste.
Observe que os valores usados nos conjuntos de propriedades são multiplicados por 100 para fornecer granularidade aprimorada.
DirectShow Interface
A interface IAMVideoProcAmp do DirectShow (consulte a documentação do DirectShow no SDK do Microsoft Windows) fornece acesso às propriedades desse conjunto.