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_GAMMA

KSPROPERTY_VIDEOPROCAMP_HUE

KSPROPERTY_VIDEOPROCAMP_SATURATION

KSPROPERTY_VIDEOPROCAMP_SHARPNESS

KSPROPERTY_VIDEOPROCAMP_WHITEBALANCE

KSPROPERTY_VIDEOPROCAMP_GAIN

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.