Partilhar via


PROPSETID_VIDCAP_VIDEOPROCAMP

O conjunto de propriedades PROPSETID_VIDCAP_VIDEOPROCAMP controla dispositivos que podem ajustar os atributos de cor da imagem de sinais analógicos ou digitais.

A enumeração KSPROPERTY_VIDCAP_VIDEOPROCAMP em ksmedia.h especifica as propriedades desse conjunto.

O suporte para este conjunto de propriedades é opcional e deve ser implementado apenas por dispositivos que permitem o 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 USB Video Class Driver, 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 para o 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 IRE. IRE é uma medida definida por NTSC de níveis de vídeo, onde 0 corresponde ao nível blanking, ou full-black, e 100 representa branco puro. Se um VideoProcAmp fosse capaz de mudar um sinal de entrada preto puro (talvez gerado por cobrir completamente a lente da câmera) e fazer com que ele aparecesse como branco puro, então seu alcance seria de 0 a 100 IRE.

A maioria dos VideoProcAmps realmente fornece uma gama limitada de controle de brilho. Uma maneira de medir o alcance é cobrir a lente da câmera e determinar o sinal de saída sobre a faixa de ajuste e, em seguida, normalizar isso para unidades IRE. Após o intervalo ter sido calculado, o valor de revisão pode ser obtido tomando 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 melhorada.

Interface DirectShow

A interface DirectShow IAMVideoProcAmp (consulte a documentação do DirectShow no SDK do Microsoft Windows) fornece acesso às propriedades desse conjunto.