Condividi tramite

PROPSETID_VIDCAP_VIDEOPROCAMP

  • Articolo

Il set di proprietà PROPSETID_VIDCAP_VIDEOPROCAMP controlla i dispositivi che possono regolare gli attributi di colore dell'immagine di segnali analogici o digitali.

L'enumerazione KSPROPERTY_VIDCAP_VIDEOPROCAMP in ksmedia.h specifica le proprietà di questo set.

Il supporto per questo set di proprietà è facoltativo e deve essere implementato solo dai dispositivi che consentono la regolazione della luminosità, del contrasto, della tonalità e di altre impostazioni di qualità dell'immagine.

Prima della classe video USB, questa enumerazione conteneva gli elementi di proprietà seguenti:

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

Con l'introduzione del driver di classe video USB, le proprietà seguenti sono state aggiunte all'enumerazione KSPROPERTY_VIDCAP_VIDEOPROCAMP:

KSPROPERTY_VIDEOPROCAMP_DIGITAL_MULTIPLIER

KSPROPERTY_VIDEOPROCAMP_DIGITAL_MULTIPLIER_LIMIT

KSPROPERTY_VIDEOPROCAMP_WHITEBALANCE_COMPONENT

KSPROPERTY_VIDEOPROCAMP_POWERLINE_FREQUENCY

Ogni proprietà nel set di proprietà PROPSETID_VIDEOPROCAMP include un intervallo e un valore predefinito. L'intervallo per il set di proprietà è definito in unità reali per consentire il controllo programmatico dei parametri. Ogni dispositivo può definire un subset di questo intervallo, nonché una dimensione del passaggio. In questo modo, i controlli, ad esempio i dispositivi di scorrimento e le barre di scorrimento, devono essere programmati per dare un effetto visibile per ogni passaggio.

Ad esempio, l'intervallo teorico complessivo per la luminosità viene definito come da -100 a 100 unità IRE. IRE è una misura definita da NTSC di livelli video, dove 0 corrisponde al livello vuoto o nero completo e 100 rappresenta il bianco puro. Se un VideoProcAmp è stato in grado di spostare un segnale di input nero puro (forse generato da coprire completamente l'obiettivo della fotocamera) e fare in modo che appaia come bianco puro, il suo intervallo sarebbe da 0 a 100 IRE.

La maggior parte di VideoProcAmps offre in realtà un intervallo limitato di controllo della luminosità. Un modo per misurare l'intervallo consiste nel coprire l'obiettivo della fotocamera e determinare il segnale di uscita sull'intervallo di regolazione e quindi normalizzare questa operazione in unità IRE. Dopo aver calcolato l'intervallo, il valore di avanzamento può essere derivato prendendo i valori massimi e minimi e dividendo per il numero di passaggi di regolazione (max + min)/N.

Si noti che i valori usati nei set di proprietà vengono moltiplicati per 100 per offrire una maggiore granularità.

Interfaccia DirectShow

L'interfaccia DirectShow IAMVideoProcAmp (vedere la documentazione di DirectShow nella Microsoft Windows SDK) fornisce l'accesso alle proprietà di questo set.