GetFeatureCapability
Top  Previous  Next

Description

Checks for available operational modes of the specified camera feature.


Syntax


[VB]
Value=objActiveDcam.GetFeatureCapability ( Name, Inquiry ) 


[C/C++]
HRESULT GetFeatureCapability ( bstr Name, bstr Inquiry, BOOL pValue );


Data Types
[VB]

Name: String
Inquiry: String
Return 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".  
 
Name [in]  
String specifying the mode to inquire. Use one of the following inquiries:  
"Present" - to check if the feature is implemented  
"OnOff" - to check if the feature can be turned on/off  
"Absolute" - to check if the feature can be controlled with an absolute value  
"Manual" - to check if the feature can be controlled manually  
"Auto" - to check if the feature can be controlled continuously by the camera  
"OnePush" - to check if the feature can be set automatically by the camera as a result of one action  
"Readout" - to check if the value of the feature can be read out  
 
pValue [out, retval]  
Pointer to the boolean value which is TRUE if the mode is available and FALSE otherwise  


Return Values


S_OK  
Success  
E_INVALIDARG        
Feature or inquiry does not exist  
E_FAIL  
Failure  
 

Example


This VB example checks on the availability of the auto-control of the gain feature and, if available, sets the gain to the automatic mode:

if ActiveDcam1.GetFeatureCapability("Gain", "Auto") then  
ActiveDcam1.SetFeatureControl "Gain","Auto"  
endif  
 
      
Remarks


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