setVideoExposure
Top  Previous  Next

setVideoExposure ( integer Exposure )

Use this function to set the integration time of the incoming light.

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

 
Simulation
No action

BitFlow Camera Interface
No action

FireWire (IEEE-1394)
Sets the Shutter reference level or AutoShutter mode

GigE Vision
Sets the Exposure time in microseconds
OPUS camera
Sets the exposure time in milliseconds
Video for Windows (VFW)
No action

DirectShow (WDM)
No action



Parameters
 
 
Exposure  
 
An integer specifying the camera exposure (shutter speed). The parameter should be in the range supported by the camera. If the camera supports the automatic exposure (auto-shutter), the value of -1 will initiate the auto-exposure mode, and value of -2 will switch the camera back to the manual exposure 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 exposures every 10 seconds:  
 
showVideo(TRUE)  
Do  
 setVideoExposure(100)  
 wait(10000)  
 setVideoExposure(200)  
 wait(10000)  
Loop