GEV_STATUS GevGetFeatureValueAsString

(GEV_CAMERA_HANDLE handle, const char
 *feature_name, int *feature_type, int
 value_string_size, char *value_string);

Description

Reads the value of a feature and returns it as a string representation.

This function is useful in C and C++ code, especially for representing feature names and values in a GUI program.

Note : The corresponding GenApi::CNodeMapRef object must already be associated with the camera handle via call to GevConnectFeatures.

Parameters

handle

Handle to the camera.

feature_name

String containing the name of the feature to be accessed.

feature_type

Pointer to storage to the feature type being returned. This is the integer version of the GenApi::EInterfacetype associated with the feature node accessed by name. The valid values are :

GENAPI_UNUSED_TYPE    = 1   for intfIBase/intfIValue/intfICategory that

                            are not accessible from C code.

GENAPI_INTEGER_TYPE   = 2   for GenApi::EInterfaceType intfIInteger  

GENAPI_BOOLEAN_TYPE   = 3   for GenApi::EInterfaceType intfIBoolean  

GENAPI_COMMAND_TYPE   = 4   for GenApi::EInterfaceType intfICommand  

GENAPI_FLOAT_TYPE     = 5   for GenApi::EInterfaceType intfIFloat    

GENAPI_STRING_TYPE    = 6   for GenApi::EInterfaceType intfIString   

GENAPI_REGISTER_TYPE  = 7   for GenApi::EInterfaceType intfRegister  

GENAPI_ENUM_TYPE      = 9   for GenApi::EInterfaceType intfIEnum      

GENAPI_ENUMENTRY_TYPE = 10  for GenApi::EInterfaceType intfIEnumEntry

value_string_size

Size, in bytes, of the storage pointed to by “value_string” that is to contain string version of the feature value.

value_string

Pointer to storage at which string version of the value is copied on return.

Return Value

GEVLIB_OK on success.