setVideoExposure

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