Hue

Description

Returns or sets the row value of the hue


Syntax

[VB]
objActiveDcam.Hue [= Value]

[C/C++]
HRESULT get_Hue( long *pHue );
HRESULT put_Hue( long Hue );


Data Type [VB]

Long

Parameters [C/C++]

pHue [out,retval]

Pointer to the current hue value

Hue [in]

The hue value to be set

Return Values

S_OK

Success

E_FAIL

The hue control is not available for the selected camera

E_INVALIDARG

The value is out of range

Example

The following VB example demonstrates the use of a Scroll control for real-time adjustment of the camera's hue.

Private Sub Form_Load()
ActiveDcam1.Acquire=True
HScroll1.Value = ActiveDcam1.Hue
HScroll1.Min = ActiveDcam1.GetHueMin
HScroll1.Max = ActiveDcam1.GetHueMax
End Sub

Private Sub HScroll1_Scroll()
ActiveDcam1.Hue = HScroll1.Value
End Sub

Remarks

This property changes the global shitf of the color tint. The valid property range is reported by the GetHueMin and GetHueMax methods. Note that the property is available only if the currently selected camera is a color one and supports software hue control.