WhiteShading

Description

Returns or sets the white shading color


Syntax

[VB]
objActiveDcam.WhiteShading [= Color]

[C/C++]
HRESULT get_WhiteShading(OLE_COLOR& pColor);
HRESULT put_WhiteShading(OLE_COLOR Color);


Data Type [VB]

RGB color


Parameters [C/C++]

pColor [out,retval]

Pointer to the current white shading color

Color [in]

The white shading color to be set

Return Values

S_OK

Success

E_FAIL

Failure.

Example

The following Visual Basic example demonstrates the use of three scroll controls for real-time adjustment of the white shading:

Private Sub Form_Load()
ActiveDcam1.Acquire=True

HScroll1.Min = ActiveDcam1.GetWhiteShadingMin
HScroll1.Max = ActiveDcam1.GetWhiteShadingMax
HScroll2.Min = ActiveDcam1.GetWhiteShadingMin
HScroll2.Max = ActiveDcam1.GetWhiteShadingMax
HScroll2.Min = ActiveDcam1.GetWhiteShadingMin
HScroll2.Max = ActiveDcam1.GetWhiteShadingMax
End Sub

Private Sub HScroll1_Scroll()
ActiveDcam1.WhiteShading = RGB(HScroll1.Value,HScroll2.Value,HScroll3.Value)
End Sub

Private Sub HScroll2_Scroll()
ActiveDcam1.WhiteShading = RGB(HScroll1.Value,HScroll2.Value,HScroll3.Value)
End Sub

Private Sub HScroll3_Scroll()
ActiveDcam1.WhiteShading = RGB(HScroll1.Value,HScroll3.Value,HScroll3.Value)
End Sub

Remarks

This property changes the tint of the white color by adjusting its red, green and blue shading. The valid property range is reported by the GetWhiteShadingMin and GetWhiteShadingMax methods. Note that the property is available only if the currently selected camera is a color one and supports white shading control.