GetFeatureMax

Description

Returns the maximum value allowed for the specified camera feature.


Syntax

[VB]
Value=objActiveDcam.GetFeatureMax ( Name ) 

[C/C++]
HRESULT GetFeatureMax( bstr Name, float* pValue );


Data Types [VB]

Name: String
Return value: Single


Parameters [C/C++]

Name [in]

String specifying the name of the feature. In accordance with IIDC 1.31, one of the following names can be used:

"Brightness", "Exposure", "Sharpness", "WhiteBalance", "Hue", "Saturation", "Gamma", "Shutter", "Gain", "Iris", "Focus", "OpticalFilter", "Zoom", "Pan", "Tilt", "Temperature", "TriggerDelay", "WhiteShading".

pValue [out, retval]

Pointer to the maximum value of the feature

Return Values

S_OK

Success

E_INVALIDARG

Feature does not exist

E_FAIL

The gain control is not available for the selected camera

Example

This VB example uses the minimum and maximum gain values to initialize the slider control:

Private Sub Form_Load()
Slider1.Min = ActiveDcam1.GetFeatureMin("Brightness")
Slider1.Max = ActiveDcam1.GetFeatureMax("Brightness")
Slider1.Value = ActiveDcam1.GetFeature("Brightness")
End Sub

Remarks

Depending on the absolute feature control being enabled or disabled, this method will return the maximum value of the feature in absolute or relative units.

If the currently selected camera does not support the specified feature, the method will generate an error.