GetFeatureArray

Description

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


Syntax

[VB]
Value=objActiveGige.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
ActiveGige1.SetFeatureArray "LUTValueAll", 4, LUT
ActiveGige1.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.