SetFeatureControl
Top  Previous  Next

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.