SetFeatureControl

Description

Sets the specified control mode for the selected camera feature.


Syntax

[VB]
Value=objActiveDcam.GetFeatureControl ( Name, Control, Value ) 

[C/C++]
HRESULT GetFeatureControl ( bstr Name, bstr Control, BOOL Value );


Data Types [VB]

Name: String
Control: String
Value: Boolean


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".

Control [in]

String specifying the control mode to set. Use one of the following inquiries:

"OnOff" - to turn the feature on or off

"Absolute" - to enable or disable the absolute control of the feature

"Auto" - to enable or disable the auto-control of the feature

"OnePush" - to initiate the one-push operation

pValue [out, retval]

TRUE if the control mode has to be enabled and FALSE otherwise

Return Values

S_OK

Success

E_INVALIDARG

Feature or inquiry does not exist

E_FAIL

Failure

Example

The following VB example demonstrates the use of the absolute control of the shutter and switch it back to the ralative mode:

ActiveDcam1.SetFeatureControl "Shutter", "Absolute", True
ActiveDcam1.SetFeature "Shutter", 0.025
ActiveDcam1.SetFeatureControl "Shutter", "Absolute", False
      
Remarks

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

If the absolute control of the featue is disabled, the feature will be controlled in relative units.

If the auto-control mode is disabled, the feature will be controlled manually (e.g. via SetFeature).

For the one-push control mode only TRUE can be used as a value.