TestImageSelector
Top  Previous  Next

Description

Returns or sets the mode of generating internal test images. Can be one of the following values:

"Off"  
   Test image mode is disabled. Image is coming from the sensor.  
"Black"  
   Generates the darkest possible image  
"White"  
   Generates the brightest possible image  
"GrayHorizontalRamp"  
   Generates the horizontal wedge going from the darkest to the brightest possible intensity  
"GrayVerticalRamp"  
   Generates the vertical wedge going from the darkest to the brightest possible intensity  
"GrayHorizontalRampMoving"  
   Generates the horizontal wedge going from the darkest to the brightest possible intensity and moving from left to right  
"GrayHorizontalRampMoving"  
   Generates the vertical wedge going from the darkest to the brightest possible intensity and moving from top to bottom  
"HorizontalLineMoving"  
   A moving horizontal line is superimposed on the live image  
"VeritcalLineMoving"  
   A moving vertical line is superimposed on the live image  
"FrameCounter"  
   A frame counter is superimposed on the live image  

Syntax


[VB]
objActiveGige.TestImageSelector [= Value]


[C/C++]
HRESULT get_TestImageSelector( string *pValue );
HRESULT put_TestImageSelector( string Value );



Data Type
[VB]

String

Parameters
[C/C++]

pValue [out, retval]  
Pointer to the string specifying the test image selector setting  
Value [in]  
The test image selection to be set  

Return Values


S_OK  
Success  
E_NOINTERFACE  
The feature is not available for the selected camera  
E_INVALIDARG  
The value is not part of the enumerated set  
E_FAIL  
Failure to set the feature value  
 

Example


The following VB example demonstrates the use of a combo box to switch between available test images.

Private Sub
 Form_Load()
Lst = ActiveGige1.GetEnumList("TestImageSelector")
For
 i = 0 
To
 
UBound
(Lst)
Combo1.AddItem (Lst(i))
Next

Combo1.ListIndex = ActiveGige1.TestImageSelector
End Sub

Private Sub
 Combo1_Click()
ActiveGige1.TestImageSelector = Combo1.Text
End Sub
 

Remarks


Depending on a camera model, other device-specific values may be available for this feature. The list of valid values can be retrieved using GetEnumList.

Note that the property is available only if the currently selected camera supports the TestImageSelector feature per GenICam standard.