GetFeatureCapability

Description

Checks for available operational modes of the specified camera feature.


Syntax

[VB]
Value=objActiveGige.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.