setVideoBrightness
Top  Previous  Next

setVideoBrightness ( integer Brightness )

Use this function to set the black level of the video.

Depending on the video driver and availability of the Brightness feature, the function performs the following actions:

 
Simulation
No action

BitFlow Camera Interface
No action

FireWire (IEEE-1394)
Sets the Brightness reference level or AutoBrightness mode

GigE Vision
Sets the Brightness reference level
OPUS camera
No action
Video for Windows (VFW)
No action

DirectShow (WDM)
No action



Parameters
 
 
Brightness  
 
An integer specifying the camera Brightness. The parameter should be in the range supported by the camera. If the camera supports the automatic brightness, the value of -1 will initiate the auto-brightness mode, and value of -2 will switch the camera back to the manual brightness mode.  
 
Error flags

ERR_OK  
 
The flag set if successful.  
 
ERR_FAILED  
 
The flag set if failed.  
 
Example

This set of statements switches between two Brightnesss every 10 seconds:  
 
showVideo(TRUE)  
Do  
 setVideoBrightness(100)  
 wait(10000)  
 setVideoBrightness(200)  
 wait(10000)  
Loop