GetFeatureArray
Top  Previous  Next

Description

Returns an array of values associated with the specified camera feature.


Syntax


[VB]
Value=objActiveUSB.GetFeatureArray( Name, ElementSize )


[C/C++]
HRESULT GetFeatureArray(bstr Name, short ElementSize, VARIANT* pArray);


Data Types
[VB]

Name: String
ElementSize: Integer
Return value: Variant (SAFEARRAY)


Parameters
[C/C++]

Name [in]  
String specifying the name of the feature  
ElementSize [in]  
A short value specifying the size of each array's element, in bytes  
pArray [out, retval]  
Pointer to the SAFEARRAY containing the values of the buffer  


Return Values


S_OK  
Success  
E_NOINTERFACE        
Feature does not exist or not available  
E_FAIL  
Failed to read the feature  
 

Example


The following VB example creates an inverse lookup table and copies it into the camera using the "LUTValueAll" feature:

Dim
 LUT(255) 
As Long

For
 i = 0 
To
 255
LUT(i) = 255-i
Next

ActiveUSB1.SetFeatureArray "LUTValueAll", 4, 
LUT

ActiveUSB1.SetFeature "LUTEnable",
True
 

Remarks


This method sets the content of buffers associated with features of the IRegister type. For more information refer to GenICam standard specifications.

Note that the size of an element in the binary buffer linked to an IRegister feature cannot be determined automatically. Therefore, the ElementSize parameter is not optional and must specify the size of each element of the array in bytes.